कनेक्टिविटी डाइग्नोस्टिक्स एपीआई

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);

पुष्टि करें

कनेक्टिविटी डाइग्नोस्टिक्स एपीआई को सीटीएस ने टेस्ट किया है ConnectivityDiagnosticsManagerTest.