شروع به کار

قبل از اینکه شروع کنی

قبل از شروع کدنویسی با استفاده از 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" />
<uses-permission android:minSdkVersion="37" android:name="android.permission.ACCESS_LOCAL_NETWORK" />
<!-- Optional: only required for FILE payloads -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

از آنجا که ACCESS_FINE_LOCATION ، BLUETOOTH_ADVERTISE ، BLUETOOTH_CONNECT ، BLUETOOTH_SCAN ، ACCESS_LOCAL_NETWORK (که از اندروید ۱۷ برای برنامه‌هایی که SDK ۳۷+ را با استفاده از WIFI_LAN هدف قرار می‌دهند، الزامی است) و READ_EXTERNAL_STORAGE مجوزهای سیستمی خطرناک محسوب می‌شوند، علاوه بر اضافه کردن آنها به مانیفست خود، باید این مجوزها را در زمان اجرا، همانطور که در درخواست مجوزها توضیح داده شده است، درخواست کنید.

اگر کاربر تمام مجوزهای لازم را اعطا نکند، API اتصالات نزدیک به برنامه شما اجازه نمی‌دهد که تبلیغات یا کشف را شروع کند.