يمكنك الانضمام إلى قائمتنا البريدية للحصول على تحديثات وإعلانات عن الأجهزة المجاورة.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

الخطوات الأولى

قبل البدء

قبل البدء في الترميز باستخدام واجهة برمجة التطبيقات Nearby Connections API:

ثبِّت حزمة تطوير البرامج (SDK) لخدمات Google Play.
نزِّل وراجِع عيّنات رموز Connection API API.

طلب الأذونات

قبل استخدام ميزة Nearby Connections، يجب أن يطلب تطبيقك الأذونات المناسبة. أضِف الأذونات التالية إلى AndroidManifest.xml:

<!-- Required for Nearby Connections -->
<uses-permission android:maxSdkVersion="31" android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:maxSdkVersion="31" android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:maxSdkVersion="30" android:name="android.permission.BLUETOOTH" />
<uses-permission android:maxSdkVersion="30" android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:maxSdkVersion="28" android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:minSdkVersion="29" android:maxSdkVersion="31" android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:minSdkVersion="31" android:name="android.permission.BLUETOOTH_ADVERTISE" />
<uses-permission android:minSdkVersion="31" android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:minSdkVersion="31" android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:minSdkVersion="32" android:name="android.permission.NEARBY_WIFI_DEVICES" />
<!-- Optional: only required for FILE payloads -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

لأنّ ACCESS_FINE_LOCATION وBLUETOOTH_ADVERTISE وBLUETOOTH_CONNECT BLUETOOTH_SCAN وRead_EXTERNAL_STORAGE تُعتبر أذونات خطيرة للنظام، بالإضافة إلى طلب الحصول على الإذن 1 المتوفّر، يمكنك طلب هذه الأذونات 1 مرة واحدة عند طلبها 1.

وإذا لم يمنح المستخدم جميع الأذونات المطلوبة، سترفض واجهة برمجة التطبيقات Nearby Connections API السماح لتطبيقك ببدء عرض الإعلانات أو الاستكشاف.