شروع کنید

قبل از شروع

قبل از شروع کدنویسی با استفاده از 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 اجازه نمی دهد برنامه شما شروع به تبلیغات یا کشف کند.