Connectivity Diagnostics API, नेटवर्क के मालिक या उन्हें मैनेज करने वाले ऐप्लिकेशन को नेटवर्क कनेक्टिविटी की डाइग्नोस्टिक जानकारी पाने की अनुमति देता है. जैसे, मोबाइल और इंटरनेट सेवा देने वाली कंपनी के ऐप्लिकेशन, वीपीएन ऐप्लिकेशन, और वाई-फ़ाई के सुझाव देने वाले ऐप्लिकेशन. ये ऐप्लिकेशन, कॉल बैक रजिस्टर कर सकते हैं. साथ ही, उन नेटवर्क के लिए कनेक्टिविटी की जानकारी वाली सूचनाएं पा सकते हैं जिनका मालिकाना हक उनके पास है या जिन्हें वे मैनेज करते हैं. ऐप्लिकेशन को उन नेटवर्क के लिए सूचनाएं नहीं मिलेंगी जिनका मालिकाना हक ऐप्लिकेशन के पास नहीं है या जिन्हें ऐप्लिकेशन मैनेज नहीं करता है.
नेटवर्क मैनेज करने या उनका मालिकाना हक रखने वाले ऐप्लिकेशन के उदाहरण यहां दिए गए हैं:
- मोबाइल और इंटरनेट सेवा देने वाली कंपनियों के ऐप्लिकेशन: उन मोबाइल नेटवर्क को मैनेज करें जिनके लिए
subIdके पास कैरियर के विशेषाधिकार हैं - वाई-फ़ाई के सुझाव देने वाले ऐप्लिकेशन: इनके पास अपने वाई-फ़ाई नेटवर्क होते हैं, जिनके बारे में ये सिस्टम को सुझाव देते हैं
- वीपीएन ऐप्लिकेशन: ये ऐप्लिकेशन, वीपीएन के इस्तेमाल किए जाने वाले सभी नेटवर्क को मैनेज करते हैं. हालांकि, ऐसा सिर्फ़ तब होता है, जब ये ऐप्लिकेशन चालू वीपीएन हों
कॉलबैक इन मामलों में शुरू किए जाते हैं:
नेटवर्क की पुष्टि: सिस्टम ने किसी नेटवर्क का आकलन पूरा कर लिया है.
ConnectivityReportक्लास, नेटवर्क की मौजूदा स्थिति के बारे में जानकारी देती है. साथ ही, पुष्टि करने के लिए किए गए किसी भी टेस्ट या प्रोसेस के नतीजों के बारे में भी बताती है.public class ConnectivityReport { Network network; long reportTimestamp; LinkProperties linkProperties; NetworkCapabilities networkCapabilities; PersistableBundle additionalInfo; }डेटा स्टॉल होने की आशंका: डेटा स्टॉल होने की आशंका है. यह एक ऐसी स्थिति होती है जिसमें आईपी पैकेट, नेटवर्क से सही तरीके से नहीं गुज़रते हैं.
DataStallReportक्लास से, डेटा स्टॉल होने की आशंका के बारे में जानकारी मिलती है.public class DataStallReport { Network network; long reportTimestamp; int detectionMethod; LinkProperties linkProperties; NetworkCapabilities networkCapabilities; PersistableBundle stallDetails; }कनेक्टिविटी की जानकारी: किसी ऐप्लिकेशन ने सिस्टम को
ConnectivityManager#reportNetworkConnectivityके ज़रिए कनेक्टिविटी की जानकारी दी है. नेटवर्क और कनेक्टिविटी की रिपोर्ट शेयर की जाती है. इससे यह पता चलता है कि ऐप्लिकेशन को लगता है कि नेटवर्क कनेक्टिविटी देता है या नहीं.
लागू करना
Connectivity Diagnostics API का इस्तेमाल करने के लिए, किसी ऐप्लिकेशन को प्लैटफ़ॉर्म से ConnectivityDiagnosticsManager इंस्टेंस पाना होगा. इस इंस्टेंस का इस्तेमाल, ConnectivityDiagnosticsCallback को रजिस्टर और अनरजिस्टर करने के लिए किया जाना चाहिए. जिन कॉलबैक तरीकों को बदला नहीं गया है वे नो-ऑप्स हैं.
यहां ConnectivityDiagnosticsCallback को लागू करने का एक उदाहरण दिया गया है:
public class ExampleCallback extends ConnectivityDiagnosticsCallback {
@Override
public void onConnectivityReportAvailable(@NonNull ConnectivityReport report) {
...
// Log data, take action based on report result, etc
...
}
@Override
public void onDataStallSuspected(@NonNull DataStallReport report) {
...
// Log data, take action based on report result, etc
...
}
@Override
public void onNetworkConnectivityReported(
@NonNull Network network, boolean hasConnectivity) {
...
// Log data, take action based on report result, etc
...
}
}
कॉल बैक पाने और सूचनाएं पाने के लिए, registerConnectivityDiagnosticsCallback को कॉल करें.
कॉल बैक की सुविधा से ऑप्ट आउट करने और सूचनाएं पाना बंद करने के लिए, unregisterConnectivityDiagnosticsCallback पर कॉल करें.
ConnectivityDiagnosticsCallback को रजिस्टर और अनरजिस्टर करने का उदाहरण यहां दिया गया है:
NetworkRequest request =
new NetworkRequest.Builder()
.addTransportType(TRANSPORT_CELLULAR)
.build();
// Use an Executor that is appropriate for your use case
Executor executor = Executors.newSingleThreadExecutor();
ConnectivityDiagnosticsManager cdm =
context.getSystemService(ConnectivityDiagnosticsManager.class);
ExampleCallback callback = new ExampleCallback();
cdm.registerConnectivityDiagnosticsCallback(
request, executor, callback);
...
// Collect connectivity information on networks that match with request
...
cdm.unregisterConnectivityDiagnosticsCallback(callback);
Validation
Connectivity Diagnostics API की CTS जांच, ConnectivityDiagnosticsManagerTest करता है.