استخدام نقطة اتصال 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().