Demander l'autorisation d'accéder aux appareils Wi-Fi à proximité
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Les applications qui ciblent Android 13 (niveau d'API 33) ou version ultérieure et qui gèrent les connexions Wi-Fi doivent demander l'autorisation d'exécutionNEARBY_WIFI_DEVICES. Cette autorisation permet de justifier plus facilement l'accès d'une application aux appareils Wi-Fi à proximité. Sur les versions précédentes d'Android, ces applications devaient déclarer l'autorisation ACCESS_FINE_LOCATION à la place.
L'autorisation fait partie du groupe "Appareils à proximité"
L'autorisation NEARBY_WIFI_DEVICES fait partie du groupe d'autorisations Appareils à proximité. Ce groupe, ajouté dans Android 12 (niveau d'API 31), inclut également les autorisations liées au Bluetooth et à la bande ultralarge. Lorsque vous demandez une combinaison d'autorisations de ce groupe, le système affiche une seule boîte de dialogue d'exécution et demande à l'utilisateur d'approuver l'accès de votre application aux appareils à proximité.
Dans les paramètres système, l'utilisateur doit activer et désactiver les autorisations Appareils à proximité en tant que groupe. Par exemple, les utilisateurs ne peuvent pas désactiver l'accès au Wi-Fi tout en conservant l'accès au Bluetooth activé pour une application donnée.
Affirmer fermement que votre application ne déduit pas la position physique
Lorsque vous ciblez Android 13 ou version ultérieure, déterminez si votre application dérive des informations de localisation à partir des API Wi-Fi. Si ce n'est pas le cas, vous devez l'affirmer clairement. Pour faire cette affirmation, définissez l'attribut usesPermissionFlags sur neverForLocation dans le fichier manifeste de votre application, comme indiqué dans l'extrait de code suivant. Ce processus est semblable à celui que vous effectuez lorsque vous affirmez que les informations sur les appareils Bluetooth ne sont jamais utilisées pour la localisation :
Les versions précédentes et certaines API nécessitent l'autorisation d'accéder à la position
Plusieurs API Wi-Fi nécessitent l'autorisation ACCESS_FINE_LOCATION, même lorsque votre application cible Android 13 ou version ultérieure. Voici quelques exemples de méthodes de la classe WifiManager :
De plus, étant donné que l'autorisation NEARBY_WIFI_DEVICES n'est disponible que sur Android 13 et versions ultérieures, vous devez conserver toutes les déclarations pour ACCESS_FINE_LOCATION afin d'assurer la rétrocompatibilité dans votre application. Toutefois, tant que votre application ne repose pas sur des informations de localisation précises, vous pouvez définir la version maximale du SDK pour cette autorisation sur 32, comme indiqué dans l'extrait de code suivant :
Si votre application cible Android 13 ou version ultérieure, vous devez déclarer l'autorisation NEARBY_WIFI_DEVICES pour appeler l'une des API Wi-Fi suivantes :
La figure 1 illustre le workflow d'accès au Wi-Fi sur les appareils exécutant Android 13 ou version ultérieure, pour les applications ciblant Android 13 ou version ultérieure. Notez que tant que vous affirmez que votre application ne déduit pas la position physique à partir des informations sur les appareils Wi-Fi, vous n'avez plus besoin de déclarer l'autorisation ACCESS_FINE_LOCATION :
Figure 1. Organigramme permettant de déterminer si une application ciblant Android 13 (niveau d'API 33) ou version ultérieure peut accéder aux informations Wi-Fi.
La figure 2 montre le workflow d'accès au Wi-Fi sur les appareils exécutant 12L ou version antérieure. Notez la dépendance à l'autorisation ACCESS_FINE_LOCATION.
Figure 2. Organigramme permettant de déterminer si une application ciblant 12L (niveau d'API 32) ou une version antérieure peut accéder aux informations Wi-Fi.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/27 (UTC)."],[],[],null,["Apps that target Android 13 (API level 33) or higher and manage Wi-Fi connections\nshould request the\n[`NEARBY_WIFI_DEVICES`](/reference/android/Manifest.permission#NEARBY_WIFI_DEVICES)\n[runtime permission](/guide/topics/permissions/overview#runtime). This\npermission makes it easier to justify an app's access of nearby Wi-Fi devices;\non previous versions of Android, these apps needed to declare the\n[`ACCESS_FINE_LOCATION`](/reference/android/Manifest.permission#ACCESS_FINE_LOCATION)\npermission instead.\n| **Caution:** If your app tries to call a Wi-Fi API without the proper permission, a [`SecurityException`](/reference/java/lang/SecurityException) occurs.\n\nPermission is part of the nearby devices group\n\nThe `NEARBY_WIFI_DEVICES` permission is part of the **Nearby devices**\npermission group. This group, added in Android 12 (API level 31), also includes\npermissions related to Bluetooth and Ultra-wideband. When you request any\ncombination of permissions from this permission group, the system shows a single\nruntime dialog and asks the user to approve your app's access to nearby devices.\nIn system settings, the user must enable and disable the **Nearby devices**\npermissions as a group; for example, users can't disable Wi-Fi access but keep\nBluetooth access enabled for a given app.\n\nStrongly assert that your app doesn't derive physical location\n\nWhen you target Android 13 or higher, consider whether your app\never derives location information from Wi-Fi APIs; if not, you should strongly\nassert that. To make this assertion, set the `usesPermissionFlags` attribute to\n`neverForLocation` in your app's manifest file, as shown in the following code\nsnippet. This process is similar to the one you do when you\n[assert that Bluetooth device information is never used for location](/guide/topics/connectivity/bluetooth/permissions#assert-never-for-location): \n\n```xml\n\u003cmanifest ...\u003e\n \u003cuses-permission android:name=\"android.permission.NEARBY_WIFI_DEVICES\"\n android:usesPermissionFlags=\"neverForLocation\" /\u003e\n \u003capplication ...\u003e\n ...\n \u003c/application\u003e\n\u003c/manifest\u003e\n```\n\nPrevious versions and some APIs require location permission\n\nSeveral Wi-Fi APIs require the `ACCESS_FINE_LOCATION` permission, even when your\napp targets Android 13 or higher. Examples include the following\nmethods from the `WifiManager` class:\n\n- [`getScanResults()`](/reference/android/net/wifi/WifiManager#getScanResults())\n- [`startScan()`](/reference/android/net/wifi/WifiManager#startScan())\n\nAlso, because the `NEARBY_WIFI_DEVICES` permission is available only on\nAndroid 13 and higher, you should keep any declarations for\n[`ACCESS_FINE_LOCATION`](/reference/android/Manifest.permission#ACCESS_FINE_LOCATION)\nto provide backward compatibility in your app. However, as long as your app\ndoesn't otherwise rely on\n[precise location information](/training/location/permissions#accuracy), you can\nset the maximum SDK version of this permission to `32`, as shown in the\nfollowing code snippet: \n\n```xml\n\u003cmanifest ...\u003e\n \u003cuses-permission android:name=\"android.permission.ACCESS_FINE_LOCATION\"\n android:maxSdkVersion=\"32\" /\u003e\n \u003capplication ...\u003e\n ...\n \u003c/application\u003e\n\u003c/manifest\u003e\n```\n\nCheck for APIs that require the permission\n\nIf your app targets Android 13 or higher, you must declare the\n`NEARBY_WIFI_DEVICES` permission to call any of the following Wi-Fi APIs:\n\n- `WifiManager`\n - [`startLocalOnlyHotspot()`](/reference/android/net/wifi/WifiManager#startLocalOnlyHotspot(android.net.wifi.WifiManager.LocalOnlyHotspotCallback,%20android.os.Handler))\n- `WifiAwareManager`\n - [`attach(AttachCallback attachCallback,\n IdentityChangedListener identityChangedListener,\n Handler handler)`](/reference/android/net/wifi/aware/WifiAwareManager#attach(android.net.wifi.aware.AttachCallback,%20android.net.wifi.aware.IdentityChangedListener,%20android.os.Handler))\n- `WifiAwareSession`\n - [`publish()`](/reference/android/net/wifi/aware/WifiAwareSession#publish(android.net.wifi.aware.PublishConfig,%20android.net.wifi.aware.DiscoverySessionCallback,%20android.os.Handler))\n - [`subscribe()`](/reference/android/net/wifi/aware/WifiAwareSession#subscribe(android.net.wifi.aware.SubscribeConfig,%20android.net.wifi.aware.DiscoverySessionCallback,%20android.os.Handler))\n- `WifiP2pManager`\n - [`addLocalService()`](/reference/android/net/wifi/p2p/WifiP2pManager#addLocalService(android.net.wifi.p2p.WifiP2pManager.Channel,%20android.net.wifi.p2p.nsd.WifiP2pServiceInfo,%20android.net.wifi.p2p.WifiP2pManager.ActionListener))\n - [`connect()`](/reference/android/net/wifi/p2p/WifiP2pManager#connect(android.net.wifi.p2p.WifiP2pManager.Channel,%20android.net.wifi.p2p.WifiP2pConfig,%20android.net.wifi.p2p.WifiP2pManager.ActionListener))\n - [`createGroup()`](/reference/android/net/wifi/p2p/WifiP2pManager#createGroup(android.net.wifi.p2p.WifiP2pManager.Channel,%20android.net.wifi.p2p.WifiP2pConfig,%20android.net.wifi.p2p.WifiP2pManager.ActionListener))\n - [`discoverPeers()`](/reference/android/net/wifi/p2p/WifiP2pManager#discoverPeers(android.net.wifi.p2p.WifiP2pManager.Channel,%20android.net.wifi.p2p.WifiP2pManager.ActionListener))\n - [`discoverServices()`](/reference/android/net/wifi/p2p/WifiP2pManager#discoverServices(android.net.wifi.p2p.WifiP2pManager.Channel,%20android.net.wifi.p2p.WifiP2pManager.ActionListener))\n - [`requestDeviceInfo()`](/reference/android/net/wifi/p2p/WifiP2pManager#requestDeviceInfo(android.net.wifi.p2p.WifiP2pManager.Channel,%20android.net.wifi.p2p.WifiP2pManager.DeviceInfoListener))\n - [`requestGroupInfo()`](/reference/android/net/wifi/p2p/WifiP2pManager#requestGroupInfo(android.net.wifi.p2p.WifiP2pManager.Channel,%20android.net.wifi.p2p.WifiP2pManager.GroupInfoListener))\n - [`requestPeers()`](/reference/android/net/wifi/p2p/WifiP2pManager#requestPeers(android.net.wifi.p2p.WifiP2pManager.Channel,%20android.net.wifi.p2p.WifiP2pManager.PeerListListener))\n- `WifiRttManager`\n - [`startRanging()`](/reference/android/net/wifi/rtt/WifiRttManager#startRanging(android.net.wifi.rtt.RangingRequest,%20java.util.concurrent.Executor,%20android.net.wifi.rtt.RangingResultCallback))\n\nWi-Fi access workflows\n\nFigure 1 shows the Wi-Fi access workflow on devices that run\nAndroid 13 or higher, for apps that target\nAndroid 13 or higher. Note that, as long as you assert that your\napp doesn't derive physical location from Wi-Fi device information, you don't\nneed to declare the `ACCESS_FINE_LOCATION` permission anymore:\n**Figure 1.** Flow chart to determine whether an app that targets Android 13 (API level 33) or higher can access Wi-Fi information.\n\nFigure 2 shows the Wi-Fi access workflow on devices that run\n12L or lower. Note the reliance on the\n`ACCESS_FINE_LOCATION` permission.\n**Figure 2.** Flow chart to determine whether an app that targets 12L (API level 32) or lower can access Wi-Fi information."]]
