Avant de commencer
Avant de commencer à coder à l'aide de l'API Nearby Connections:
- Installez le SDK des services Google Play.
- Téléchargez et examinez les exemples de code de l'API Nearby Connections.
Demander des autorisations
Avant d'utiliser la fonctionnalité Nearby Connections, votre application doit demander les autorisations appropriées. Ajoutez les autorisations suivantes à 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"/>
Étant donné que ACCESS_FINE_LOCATION, BLUETOOTH_ADVERTISE, BLUETOOTH_CONNECT, BLUETOOTH_SCAN et READ_EXTERNAL_STORAGE sont considérés 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 1, comme décrit dans , comme décrit dans la section .
Si l'utilisateur n'accorde pas toutes les autorisations requises, l'API Nearby Connections refuse d'autoriser votre application à diffuser des annonces ou à la découvrir.