Android 10 (एपीआई लेवल 29) और इसके बाद के वर्शन वाले डिवाइसों पर, नए पीयर टू पीयर एपीआई का इस्तेमाल करके, Chromecast और Google Home हार्डवेयर जैसे दूसरे डिवाइसों के लिए कॉन्फ़िगरेशन को बूटस्ट्रैप किया जा सकता है. इस सुविधा की मदद से, आपका ऐप्लिकेशन उपयोगकर्ता को उस ऐक्सेस पॉइंट को बदलने के लिए कह सकता है जिससे डिवाइस कनेक्ट है. इसके लिए, अनुरोध किए गए नेटवर्क की प्रॉपर्टी के बारे में बताने के लिए, WifiNetworkSpecifier का इस्तेमाल किया जाता है.
इस एपीआई का इस्तेमाल करने के लिए, यह तरीका अपनाएं:
WifiNetworkSpecifier.Builderका इस्तेमाल करके, वाई-फ़ाई नेटवर्क के बारे में जानकारी देने वाला एलिमेंट बनाएं.ज़रूरी क्रेडेंशियल के साथ-साथ, कनेक्ट करने के लिए नेटवर्क से मैच करने के लिए नेटवर्क फ़िल्टर सेट करें.
हर अनुरोध में नेटवर्क फ़िल्टर सेट करने के लिए,
SSID,SSID pattern,BSSID, औरBSSID patternके कॉम्बिनेशन का इस्तेमाल करें. हालांकि, इसके लिए इन ज़रूरी शर्तों को पूरा करना ज़रूरी है:- हर अनुरोध में
SSID,SSID pattern,BSSIDयाBSSID patternमें से कम से कम एक प्रॉपर्टी की जानकारी होनी चाहिए - हर अनुरोध में,
SSIDयाSSID patternमें से सिर्फ़ एक को सेट किया जा सकता है - हर अनुरोध में,
BSSIDयाBSSID patternमें से सिर्फ़ एक को सेट किया जा सकता है
- हर अनुरोध में
अनुरोध के स्टेटस को ट्रैक करने के लिए, नेटवर्क अनुरोध में स्पेसिफ़ायर के साथ-साथ
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);