Запрос разрешения на доступ к устройствам Wi-Fi поблизости

Приложения, предназначенные для Android 13 (уровень API 33) или более поздней версии и управляющие подключениями по Wi-Fi, должны запрашивать динамическое разрешение NEARBY_WIFI_DEVICES. Это разрешение упрощает обоснование доступа приложения к устройствам Wi-Fi поблизости. В предыдущих версиях Android таким приложениям требовалось разрешение ACCESS_FINE_LOCATION.

Разрешение относится к группе "Устройства поблизости".

Разрешение NEARBY_WIFI_DEVICES входит в группу разрешений Устройства поблизости. Эта группа, добавленная в Android 12 (уровень API 31), также включает разрешения, связанные с Bluetooth и сверхширокополосной связью. Когда вы запрашиваете любое сочетание разрешений из этой группы разрешений, система показывает одно диалоговое окно во время выполнения и просит пользователя одобрить доступ вашего приложения к устройствам поблизости. В системных настройках пользователь должен включить или отключить разрешения Устройства поблизости как группу. Например, нельзя отключить доступ к Wi-Fi, но оставить доступ к Bluetooth для определенного приложения.

Убедительно докажите, что ваше приложение не определяет физическое местоположение.

Если ваше приложение предназначено для Android 13 или более поздней версии, подумайте, получает ли оно когда-либо данные о местоположении от API Wi-Fi. Если нет, вы должны это подтвердить. Для этого задайте для атрибута usesPermissionFlags значение neverForLocation в файле манифеста приложения, как показано в следующем фрагменте кода. Этот процесс похож на подтверждение того, что информация об устройствах Bluetooth никогда не используется для определения местоположения.

<manifest ...>
    <uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES"
                     android:usesPermissionFlags="neverForLocation" />
    <application ...>
        ...
    </application>
</manifest>

Для предыдущих версий и некоторых API требуется разрешение на доступ к данным о местоположении

Для работы некоторых API Wi-Fi требуется разрешение ACCESS_FINE_LOCATION, даже если приложение предназначено для Android 13 или более поздней версии. Примеры методов класса WifiManager:

Кроме того, поскольку разрешение NEARBY_WIFI_DEVICES доступно только в Android 13 и более поздних версиях, вам следует сохранить все объявления ACCESS_FINE_LOCATION, чтобы обеспечить обратную совместимость в приложении. Однако если ваше приложение не зависит от точного местоположения, вы можете установить максимальную версию SDK для этого разрешения на 32, как показано в следующем фрагменте кода:

<manifest ...>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"
                     android:maxSdkVersion="32" />
    <application ...>
        ...
    </application>
</manifest>

Проверьте, каким API требуется разрешение

Если ваше приложение поддерживает Android 13 или более поздние версии, вы должны объявить разрешение NEARBY_WIFI_DEVICES, чтобы вызывать любой из следующих API Wi-Fi:

Рабочие процессы доступа к Wi-Fi

На рисунке 1 показан рабочий процесс доступа к Wi-Fi на устройствах с Android 13 или более поздней версии для приложений, предназначенных для Android 13 или более поздней версии. Обратите внимание, что если вы подтвердите, что ваше приложение не определяет физическое местоположение по данным Wi-Fi, то вам больше не нужно будет запрашивать разрешение ACCESS_FINE_LOCATION.

Рисунок 1. Блок-схема, показывающая, может ли приложение, предназначенное для Android 13 (уровень API 33) или более поздней версии, получать доступ к информации о Wi-Fi.

На рисунке 2 показан рабочий процесс доступа к Wi-Fi на устройствах с Android 12L или более ранней версией. Обратите внимание на зависимость от разрешения ACCESS_FINE_LOCATION.

Рисунок 2. Блок-схема, показывающая, может ли приложение, поддерживающее 12L (уровень API 32) или более ранние версии, получать доступ к информации о Wi-Fi.