على نظام التشغيل Android 10 (المستوى 29 لواجهة برمجة التطبيقات) والأجهزة الأحدث، يمكنك استخدام واجهة برمجة تطبيقات جديدة من نظير إلى نظير
لتمهيد الإعداد للأجهزة الثانوية مثل Chromecast وأجهزة Google Home. تتيح هذه الميزة لتطبيقك أن تطلب من المستخدم تغيير نقطة الوصول
التي يتصل بها الجهاز، وذلك باستخدام
WifiNetworkSpecifier
لوصف خصائص الشبكة المطلوبة.
لاستخدام واجهة برمجة التطبيقات هذه، اتّبِع الخطوات التالية:
أنشئ محددًا لشبكة Wi-Fi باستخدام
WifiNetworkSpecifier.Builder.اضبط فلتر شبكة لمطابقة الشبكات المطلوب الاتصال بها، بالإضافة إلى الشهادات المطلوبة.
حدِّد مجموعة من
SSID،SSID pattern،BSSID، وBSSID patternلضبط فلتر الشبكة في كل طلب، مع مراعاة ال requirements التالية:- يجب أن يقدّم كل طلب سمة واحدة على الأقل من
SSIDأوSSID patternأوBSSIDأوBSSID pattern - يمكن لكل طلب ضبط أحد الخيارَين
SSIDأوSSID patternفقط. - يمكن لكل طلب ضبط قيمة واحدة فقط من
BSSIDأوBSSID pattern.
- يجب أن يقدّم كل طلب سمة واحدة على الأقل من
أضِف المحدّدات إلى طلب الشبكة مع مثيل
NetworkCallbackلتتبُّع حالة الطلب.إذا وافق المستخدم على الطلب ونجحت عملية الاتصال بالشبكة، يتم استدعاء
NetworkCallback.onAvailable()في عنصر callback. إذا رفض المستخدم الطلب أو إذا تعذّر الاتصال بالشبكة، يتم استدعاءNetworkCallback.onUnavailable()في عنصر الاستدعاء.
يؤدي بدء طلب الاتصال بجهاز مماثل إلى فتح مربّع حوار على الجهاز نفسه، ويمكن لمستخدم هذا الجهاز قبول طلب الاتصال.
تجاوز موافقة المستخدم
بعد موافقة المستخدم على شبكة للاتصال بها استجابةً لطلب من تطبيق معيّن، يحفظ الجهاز الموافقة لنقطة الوصول المحدّدة. إذا قدّم التطبيق طلبًا محدّدًا ل الاتصال بنقطة الوصول هذه مرة أخرى، يتخطّى الجهاز مرحلة موافقة المستخدم ويتصل تلقائيًا بالشبكة. إذا اختار المستخدم تجاهل الشبكة أثناء الاتصال بشبكة طلبتها واجهة برمجة التطبيقات، تتم إزالة الموافقة المخزّنة على هذا التطبيق والشبكة، ويجب أن يوافق المستخدم مرة أخرى على أي طلب مستقبلي من التطبيق. إذا أرسل التطبيق طلبًا غير محدّد، مثل طلب SSID أو نمط BSSID، على المستخدم الموافقة على الطلب.
نموذج رمز
يعرض نموذج الرمز التالي كيفية الاتصال بشبكة مفتوحة باستخدام بادئة SSID
للمعرّف "test" ومعرّف مجموعة الخدمات الأساسية (BSSID) للمستخدم "10:03:23":
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);