पीयर-टू-पीयर कनेक्टिविटी के लिए वाई-फ़ाई नेटवर्क के अनुरोध का एपीआई

Android 10 (एपीआई लेवल 29) और इसके बाद के वर्शन वाले डिवाइसों पर, नए पीयर टू पीयर एपीआई का इस्तेमाल करके, Chromecast और Google Home हार्डवेयर जैसे दूसरे डिवाइसों के लिए कॉन्फ़िगरेशन को बूटस्ट्रैप किया जा सकता है. इस सुविधा की मदद से, आपका ऐप्लिकेशन उपयोगकर्ता को उस ऐक्सेस पॉइंट को बदलने के लिए कह सकता है जिससे डिवाइस कनेक्ट है. इसके लिए, अनुरोध किए गए नेटवर्क की प्रॉपर्टी के बारे में बताने के लिए, WifiNetworkSpecifier का इस्तेमाल किया जाता है.

इस एपीआई का इस्तेमाल करने के लिए, यह तरीका अपनाएं:

1. WifiNetworkSpecifier.Builder का इस्तेमाल करके, वाई-फ़ाई नेटवर्क के बारे में जानकारी देने वाला एलिमेंट बनाएं.

2. ज़रूरी क्रेडेंशियल के साथ-साथ, कनेक्ट करने के लिए नेटवर्क से मैच करने के लिए नेटवर्क फ़िल्टर सेट करें.

3. हर अनुरोध में नेटवर्क फ़िल्टर सेट करने के लिए, SSID, SSID pattern, BSSID, और BSSID pattern के कॉम्बिनेशन का इस्तेमाल करें. हालांकि, इसके लिए इन ज़रूरी शर्तों को पूरा करना ज़रूरी है:

   • हर अनुरोध में SSID, SSID pattern, BSSID या BSSID pattern में से कम से कम एक प्रॉपर्टी की जानकारी होनी चाहिए
   • हर अनुरोध में, SSID या SSID pattern में से सिर्फ़ एक को सेट किया जा सकता है
   • हर अनुरोध में, BSSID या BSSID pattern में से सिर्फ़ एक को सेट किया जा सकता है

4. अनुरोध के स्टेटस को ट्रैक करने के लिए, नेटवर्क अनुरोध में स्पेसिफ़ायर के साथ-साथ NetworkCallback का एक उदाहरण जोड़ें.

   अगर उपयोगकर्ता अनुरोध स्वीकार करता है और नेटवर्क से कनेक्ट हो जाता है, तो कॉलबैक ऑब्जेक्ट पर NetworkCallback.onAvailable() को कॉल किया जाता है. अगर उपयोगकर्ता अनुरोध अस्वीकार करता है या नेटवर्क से कनेक्शन नहीं हो पाता है, तो कॉलबैक ऑब्जेक्ट पर NetworkCallback.onUnavailable() को कॉल किया जाता है.

किसी पीयर डिवाइस से कनेक्ट करने का अनुरोध करने पर, उसी डिवाइस पर एक डायलॉग बॉक्स खुलता है. इस बॉक्स से, उस डिवाइस का उपयोगकर्ता कनेक्ट करने का अनुरोध स्वीकार कर सकता है.

ध्यान दें: इस एपीआई का इस्तेमाल करके कनेक्शन बनाने से, ऐप्लिकेशन या डिवाइस को इंटरनेट कनेक्शन नहीं मिलता. किसी डिवाइस पर ऐप्लिकेशन को इंटरनेट कनेक्शन देने के लिए, वाई-फ़ाई सुझाव एपीआई का इस्तेमाल करें.

उपयोगकर्ता की अनुमति को बायपास करना

जब उपयोगकर्ता किसी ऐप्लिकेशन के अनुरोध के जवाब में, किसी नेटवर्क से कनेक्ट करने की अनुमति देता है, तो डिवाइस उस ऐक्सेस पॉइंट के लिए अनुमति सेव कर लेता है. अगर ऐप्लिकेशन उस ऐक्सेस पॉइंट से फिर से कनेक्ट करने के लिए कोई अनुरोध करता है, तो डिवाइस, उपयोगकर्ता की अनुमति के चरण को छोड़ देता है और नेटवर्क से अपने-आप कनेक्ट हो जाता है. अगर उपयोगकर्ता, एपीआई के अनुरोध किए गए नेटवर्क से कनेक्ट होने के दौरान, नेटवर्क की जानकारी मिटाने का विकल्प चुनता है, तो ऐप्लिकेशन और नेटवर्क के उस कॉम्बिनेशन के लिए सेव की गई अनुमति हटा दी जाती है. साथ ही, ऐप्लिकेशन से आने वाले किसी भी अनुरोध को उपयोगकर्ता को फिर से मंज़ूरी देनी होगी. अगर ऐप्लिकेशन, SSID या BSSID पैटर्न जैसे किसी खास अनुरोध के लिए अनुमति मांगता है, तो उपयोगकर्ता को अनुरोध स्वीकार करना होगा.

कोड का सैंपल

नीचे दिए गए कोड सैंपल में, "test" के SSID प्रीफ़िक्स और "10:03:23" के BSSID OUI वाले ओपन नेटवर्क से कनेक्ट करने का तरीका बताया गया है:

Kotlin

val specifier = WifiNetworkSpecifier.Builder()
    .setSsidPattern(PatternMatcher("test", PatternMatcher.PATTERN_PREFIX))
    .setBssidPattern(MacAddress.fromString("10:03:23:00:00:00"), MacAddress.fromString("ff:ff:ff:00:00:00"))
    .build()

val request = NetworkRequest.Builder()
    .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
    .removeCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
    .setNetworkSpecifier(specifier)
    .build()

val connectivityManager = context.getSystemService(Context.CONNECTIVITY_SERVICE) as ConnectivityManager

val networkCallback = object : ConnectivityManager.NetworkCallback() {
    ...
    override fun onAvailable(network: Network?) {
        // do success processing here..
    }

    override fun onUnavailable() {
        // do failure processing here..
    }
    ...
}
connectivityManager.requestNetwork(request, networkCallback)
...
// Release the request when done.
connectivityManager.unregisterNetworkCallback(networkCallback)

Java

final NetworkSpecifier specifier =
  new WifiNetworkSpecifier.Builder()
  .setSsidPattern(new PatternMatcher("test", PatternMatcher.PATTERN_PREFIX))
  .setBssidPattern(MacAddress.fromString("10:03:23:00:00:00"), MacAddress.fromString("ff:ff:ff:00:00:00"))
  .build();

final NetworkRequest request =
  new NetworkRequest.Builder()
  .addTransportType(NetworkCapabilities.TRANSPORT_WIFI)
  .removeCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
  .setNetworkSpecifier(specifier)
  .build();

final ConnectivityManager connectivityManager = (ConnectivityManager)
  context.getSystemService(Context.CONNECTIVITY_SERVICE);

final NetworkCallback networkCallback = new NetworkCallback() {
  ...
  @Override
  void onAvailable(...) {
      // do success processing here..
  }

  @Override
  void onUnavailable(...) {
      // do failure processing here..
  }
  ...
};
connectivityManager.requestNetwork(request, networkCallback);
...
// Release the request when done.
connectivityManager.unregisterNetworkCallback(networkCallback);