برای بهروزرسانیها و اطلاعیههای مربوط به Nearby به
فهرست پستی ما بپیوندید.
شروع به کار
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
قبل از شروع
قبل از شروع کدنویسی با استفاده از Nearby Connections 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 به عنوان مجوزهای خطرناک سیستم در نظر گرفته می شوند، علاوه بر افزودن آنها به مانیفست خود، باید این مجوزها را در زمان اجرا درخواست کنید، همانطور که در Requesting توضیح داده شده است.
اگر کاربر همه مجوزهای لازم را اعطا نکند، Nearby Connections API اجازه نمی دهد برنامه شما شروع به تبلیغات یا کشف کند.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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."]]
