يمكنك الانضمام إلى
قائمتنا البريدية للحصول على تحديثات وإعلانات عن الأجهزة المجاورة.
البدء
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
قبل البدء
قبل بدء الترميز باستخدام واجهة برمجة تطبيقات "الاتصالات القريبة":
طلب الأذونات
قبل استخدام "اتصالات الأجهزة المجاورة"، يجب أن يطلب تطبيقك
الأذونات. أضِف الأذونات التالية إلى 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
التي تُعدّ نظامًا خطيرًا
الأذونات،
بالإضافة إلى إضافتها إلى ملف البيان، يجب طلب هذه الأذونات
في وقت التشغيل، كما هو موضح في طلب
الأذونات.
إذا لم يمنح المستخدم جميع الأذونات المطلوبة، ستظهر واجهة برمجة تطبيقات "الاتصالات المجاورة"
السماح لتطبيقك ببدء الإعلان أو الاكتشاف.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-13 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-13 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eBefore using the Nearby Connections API, install the Google Play Services SDK and review the provided code samples.\u003c/p\u003e\n"],["\u003cp\u003eApps using Nearby Connections must request specific permissions in the \u003ccode\u003eAndroidManifest.xml\u003c/code\u003e to function correctly.\u003c/p\u003e\n"],["\u003cp\u003eSeveral permissions, like location and Bluetooth access, require runtime requests due to their sensitive nature.\u003c/p\u003e\n"],["\u003cp\u003eThe Nearby Connections API will not function if the user denies necessary permissions for advertising or discovery.\u003c/p\u003e\n"]]],["To use the Nearby Connections API, install the Google Play Services SDK and review the code samples. In your `AndroidManifest.xml`, add permissions for `ACCESS_WIFI_STATE`, `CHANGE_WIFI_STATE`, `BLUETOOTH`, `BLUETOOTH_ADMIN`, `ACCESS_COARSE_LOCATION`, `ACCESS_FINE_LOCATION`, `BLUETOOTH_ADVERTISE`, `BLUETOOTH_CONNECT`, `BLUETOOTH_SCAN`, and `NEARBY_WIFI_DEVICES`. For `ACCESS_FINE_LOCATION`, `BLUETOOTH_ADVERTISE`, `BLUETOOTH_CONNECT`, `BLUETOOTH_SCAN` and `READ_EXTERNAL_STORAGE` also request these permissions at runtime, as they are classified as dangerous. The app can not use the API if the user does not provide the permissions.\n"],null,["# Get started\n\nBefore you begin\n----------------\n\nBefore you start to code using the Nearby Connections API:\n\n- Install the [Google Play Services\n SDK](//developer.android.com/google/play-services/setup.html).\n- Download and review the [Nearby Connections API code\n samples](https://github.com/android/connectivity-samples/tree/main/NearbyConnectionsWalkieTalkie).\n\nRequest permissions\n-------------------\n\nBefore using Nearby Connections, your app must request the appropriate\npermissions. Add the following permissions to your `AndroidManifest.xml`: \n\n```gdscript\n\u003c!-- Required for Nearby Connections --\u003e\n\u003cuses-permission android:maxSdkVersion=\"31\" android:name=\"android.permission.ACCESS_WIFI_STATE\" /\u003e\n\u003cuses-permission android:maxSdkVersion=\"31\" android:name=\"android.permission.CHANGE_WIFI_STATE\" /\u003e\n\u003cuses-permission android:maxSdkVersion=\"30\" android:name=\"android.permission.BLUETOOTH\" /\u003e\n\u003cuses-permission android:maxSdkVersion=\"30\" android:name=\"android.permission.BLUETOOTH_ADMIN\" /\u003e\n\u003cuses-permission android:maxSdkVersion=\"28\" android:name=\"android.permission.ACCESS_COARSE_LOCATION\" /\u003e\n\u003cuses-permission android:minSdkVersion=\"29\" android:maxSdkVersion=\"31\" android:name=\"android.permission.ACCESS_FINE_LOCATION\" /\u003e\n\u003cuses-permission android:minSdkVersion=\"31\" android:name=\"android.permission.BLUETOOTH_ADVERTISE\" /\u003e\n\u003cuses-permission android:minSdkVersion=\"31\" android:name=\"android.permission.BLUETOOTH_CONNECT\" /\u003e\n\u003cuses-permission android:minSdkVersion=\"31\" android:name=\"android.permission.BLUETOOTH_SCAN\" /\u003e\n\u003cuses-permission android:minSdkVersion=\"32\" android:name=\"android.permission.NEARBY_WIFI_DEVICES\" /\u003e\n\u003c!-- Optional: only required for FILE payloads --\u003e\n\u003cuses-permission android:name=\"android.permission.READ_EXTERNAL_STORAGE\"/\u003e\n```\n\nSince\n[ACCESS_FINE_LOCATION](https://developer.android.com/reference/android/Manifest.permission#ACCESS_FINE_LOCATION),\n[BLUETOOTH_ADVERTISE](https://developer.android.com/reference/android/Manifest.permission#BLUETOOTH_ADVERTISE),\n[BLUETOOTH_CONNECT](https://developer.android.com/reference/android/Manifest.permission#BLUETOOTH_CONNECT),\n[BLUETOOTH_SCAN](https://developer.android.com/reference/android/Manifest.permission#BLUETOOTH_SCAN)\nand\n[READ_EXTERNAL_STORAGE](https://developer.android.com/reference/android/Manifest.permission#READ_EXTERNAL_STORAGE)\nare considered to be [dangerous system\npermissions](//developer.android.com/guide/topics/permissions/requesting.html#normal-dangerous),\nin addition to adding them to your manifest, you must request these permissions\nat runtime, as described in [Requesting\nPermissions](//developer.android.com/training/permissions/requesting.html).\n\nIf the user does not grant all required permissions, the Nearby Connections API\nwill refuse to allow your app to start advertising or discovering."]]
