Начать

Прежде чем начать

Прежде чем начать писать код, используя API Nearby Connections:

Запросить разрешения

Перед использованием функции 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 (требуется начиная с Android 17 для приложений, ориентированных на SDK 37+ и использующих WIFI_LAN ) и READ_EXTERNAL_STORAGE считаются опасными системными разрешениями , помимо добавления их в манифест, необходимо запрашивать эти разрешения во время выполнения, как описано в разделе «Запрос разрешений» .

Если пользователь не предоставит все необходимые разрешения, API Nearby Connections откажет вашему приложению в запуске рекламы или обнаружения.