استخدام نقطة اتصال Wi-Fi محلية فقط

يمكنك استخدام نقطة اتصال محلية فقط لتفعيل التطبيقات على الأجهزة المتصلة بنقطة اتصال Wi-Fi كي تتواصل مع بعضها البعض. لن تتمكّن الشبكة التي تم إنشاؤها باستخدام هذه الطريقة من الوصول إلى الإنترنت. يمكن لكل تطبيق إرسال طلب واحد للحصول على نقطة الاتصال، ولكن يمكن لعدة تطبيقات طلب نقطة الاتصال في الوقت نفسه. عندما يتم تسجيل تطبيقات متعدّدة بنجاح في الوقت نفسه، فإنّها تتشارك نقطة الاتصال الأساسية. يتم استدعاء LocalOnlyHotspotCallback.onStarted(LocalOnlyHotspotReservation) عندما تصبح نقطة الاتصال جاهزة للاستخدام.

إذا كان تطبيقك يستهدف الإصدار 13 من نظام التشغيل Android (المستوى 33 لواجهة برمجة التطبيقات) أو الإصدارات الأحدث، عليك طلب NEARBY_WIFI_DEVICES لاستخدام نقطة اتصال محلية فقط، كما هو موضّح في مقتطف الرمز البرمجي التالي. يجب أن تطلب التطبيقات التي تستهدف إصدارًا قديمًا من Android الإذن ACCESS_FINE_LOCATION بدلاً من ذلك.

<manifest ...>
    <<!-- If your app targets Android 13 (API level 33)
          or higher, you must declare the NEARBY_WIFI_DEVICES permission. -->
    <uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES"
                     <!-- If your app derives location information from
                          Wi-Fi APIs, don't include the "usesPermissionFlags"
                          attribute. -->
                     android:usesPermissionFlags="neverForLocation" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
                     <!-- If any feature in your app relies on
                          precise location information, don't include the
                          "maxSdkVersion" attribute. -->
                     android:maxSdkVersion="32" />
    <application ...>
        ...
    </application>
</manifest>

لمزيد من التفاصيل حول استخدام نقاط الاتصال التي تعمل على الشبكة المحلية فقط، يُرجى الاطّلاع على startLocalOnlyHotspot().