Premiers pas

Avant de commencer

Avant de commencer à coder à l'aide de l'API Nearby Connections :

Demander des autorisations

Avant d'utiliser Nearby Connections, votre application doit demander les autorisations appropriées. Ajoutez les autorisations suivantes à votre 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"/>

Étant donné que ACCESS_FINE_LOCATION, BLUETOOTH_ADVERTISE, BLUETOOTH_CONNECT, BLUETOOTH_SCAN, ACCESS_LOCAL_NETWORK (obligatoire à partir d'Android 17 pour les applications ciblant le SDK 37 ou version ultérieure à l'aide de WIFI_LAN) et READ_EXTERNAL_STORAGE sont considérées comme des autorisations système dangereuses, en plus de les ajouter à votre fichier manifeste, vous devez demander ces autorisations au moment de l'exécution, comme décrit dans Demander des autorisations.

Si l'utilisateur n'accorde pas toutes les autorisations requises, l'API Nearby Connections refusera d'autoriser votre application à commencer à diffuser ou à détecter.