Premiers pas

Avant de commencer

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

Demander des autorisations

Avant d'utiliser Nearby Connections, votre application doit demander l'autorisation autorisations. 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" />
<!-- Optional: only required for FILE payloads -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

Depuis ACCESS_FINE_LOCATION, BLUETOOTH_ADVERTISE, BLUETOOTH_CONNECT, BLUETOOTH_SCAN et READ_EXTERNAL_STORAGE sont considérés comme des systèmes dangereux les autorisations, en plus de les ajouter à votre fichier manifeste, vous devez demander ces autorisations au moment de l'exécution, comme décrit dans la section Demander Autorisations.

Si l'utilisateur n'accorde pas toutes les autorisations requises, l'API Nearby Connections refuse de permettre à votre appli de diffuser des annonces ou d'en découvrir de nouvelles.