Android обеспечивает поддержку точки доступа Wi-Fi (Soft AP), включая привязку через точку доступа Wi-Fi и локальные точки доступа Wi-Fi.
Функция программной точки доступа позволяет настроить следующее:
- SSID и BSSID
- Тип безопасности (включая WPA3)
- Скрытый SSID
- Рабочий диапазон и канал (включая АСУ)
- Максимальное количество разрешенных клиентов
- Значение тайм-аута автоматического выключения
- Список разрешенных и черный список, позволяющий пользователю контролировать связанные устройства.
- Уровень рандомизации MAC для BSSID точки доступа
- 802.11ax и 802.11be
Возможности устройства определяют доступность этих элементов управления. В Android 11 представлены API для получения этих возможностей. Производители устройств также могут указывать базовые возможности устройства с помощью наложений.
Обратите внимание, что некоторые из API являются системными API и ограничены разрешениями, поэтому доступ к ним может получить только приложение «Настройки системы».
Разрабатывайте приложения с помощью API-интерфейсов точек доступа.
Реализация привязанной точки доступа Wi-Fi по умолчанию предоставляется приложением «Настройки AOSP», однако оно не использует все API-интерфейсы для настройки программной точки доступа.
Для поддержки модема через точку доступа или локальную точку доступа приложение должно выполнять следующие функции:
Зарегистрируйте обратный вызов, чтобы получить возможности устройства, используя
WifiManager#registerSoftApCallback
для привязанной точки доступа илиWifiManager#registerLocalOnlyHotspotSoftApCallback
для локальной точки доступа.Обратный вызов
SoftApCallback
предоставляет следующие методы:-
SoftApCallback#onCapabilityChanged
: предоставляет информацию о возможностях устройства, включая максимальное количество поддерживаемых клиентов, а также о том, поддерживаются ли SAE или ACS. -
SoftApCallback#onInfoChanged
: предоставляет информацию о работающей программной точке доступа (действительна только после запуска), включая информацию о полосе и частоте. -
SoftApCallback#onConnectedClientsChanged
: предоставляет список подключенных клиентов. Для каждого клиента вы можете получить MAC-адрес. Чтобы получить информацию об IP, используйте обратный вызовTetheringEventCallback#onClientsChanged
. -
SoftApCallback#onStateChanged
: предоставляет обновления о состоянии программной точки доступа при ее включении и отключении. -
SoftApCallback#onBlockedClientConnecting
: предоставляет информацию о заблокированном клиенте по одной из следующих причин блокировки: устройство достигло максимального количества клиентов, которые оно может поддерживать, или клиент явно не авторизован для подключения.
-
Для привязанной точки доступа:
- Настройте мягкую конфигурацию точки доступа для привязки, вызвав метод
WifiManager#setSoftApConfiguration
и предоставив экземплярSoftApConfiguration
. СоздайтеSoftApConfiguration
используя классSoftApConfiguration.Builder
. - Запустите привязку, вызвав метод привязки по адресу
TetheringManager#startTethering
.
Для локальной точки доступа:
- Запустите локальную точку доступа с определенной конфигурацией программной точки доступа, вызвав метод
WifiManager#startLocalOnlyHotspot
.
Внедрение списков разрешений и блокировок
Типичное требование оператора связи — предоставить пользователю средства управления устройствами, которым разрешено подключаться к программной точке доступа. Для этого существует несколько механизмов:
- Ограничьте максимальное количество устройств, которые могут быть связаны с программной точкой доступа, с помощью
SoftApConfiguration.Builder#setMaxNumberOfClients
. Обязательно укажите число, меньшее максимального количества клиентов, поддерживаемых устройством. Максимальное количество можно получить изSoftApCapability#getMaxSupportedClients
. Обеспечьте динамический контроль с помощью списков разрешений и блокировок:
- Конфигурация программной точки доступа по умолчанию позволяет всем устройствам подключаться к программной точке доступа, за исключением устройств, MAC-адреса которых добавлены в
SoftApConfiguration.Builder#setBlockedClientList
. Если программная точка доступа настроена с помощью
SoftApConfiguration.Builder#setClientControlByUserEnabled( true )
, используется список разрешений.- Все устройства, MAC-адреса которых находятся в
SoftApConfiguration.Builder#setBlockedClientList
блокируются от ассоциации. - Всем устройствам, MAC-адреса которых указаны в
SoftApConfiguration.Builder#setAllowedClientList
разрешена ассоциация. - Все остальные устройства (то есть устройства, MAC-адреса которых не включены в список разрешенных или заблокированных) блокируются от ассоциации, но вызывается
SoftApCallback#onBlockedClientConnecting
, позволяющий управляющему приложению (то есть приложению «Настройки») выполнить действие, например Например, запросив у пользователя подтверждение, а затем добавив устройство в список разрешенных или в список заблокированных в зависимости от поведения пользователя.
- Все устройства, MAC-адреса которых находятся в
Обратите внимание, что устройства могут использовать функцию списка разрешенных только в том случае, если она поддерживается на устройстве. Вы можете проверить поддержку устройства, используя
SoftApCapability#areFeaturesSupported( SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT )
.- Конфигурация программной точки доступа по умолчанию позволяет всем устройствам подключаться к программной точке доступа, за исключением устройств, MAC-адреса которых добавлены в
Выполнение
Для поддержки модема через точку доступа или поддержки локальной точки доступа производители устройств должны предоставить приложение «Настройки», платформу и поддержку HAL/прошивки:
Приложение «Настройки». Приложение «Настройки AOSP» предоставляет основу для настройки точки доступа с использованием SSID и учетных данных безопасности. Этот код можно использовать как есть или изменить, чтобы предоставить дополнительные возможности, как описано в разделе «Разработка приложений с API-интерфейсами точек доступа» .
Платформа. Код платформы AOSP поддерживает все функции, описанные в разделе «Разработка приложений с использованием API-интерфейсов точек доступа» .
HAL/прошивка для точки доступа: либо HIDL IHostapd.hal версии 1.2 или выше, либо AIDL IHostapd.aidl .
Кастомизация
Чтобы настроить реализацию, производители устройств должны настроить следующие наложения и конфигурации оператора связи, которые описаны в packages/modules/Wifi/service/ServiceWifiResources/res/values/config.xml
:
-
config_wifiFrameworkSoftApShutDownTimeoutMilliseconds
: интервал ожидания завершения работы по умолчанию. Действует только в том случае, если включенSoftApConfiguration#setAutoShutdownEnabled
. Можно переопределить с помощьюSoftApConfiguration#setShutdownTimeoutMillis
. -
config_wifiHardwareSoftapMaxClientCount
: аппаратное ограничение максимального количества поддерживаемых клиентов. Максимальное количество клиентов, которое поддерживает устройство, соответствует минимуму аппаратных ограничений и ограничений оператора связи (указанныхCarrierConfigManager.Wifi#KEY_HOTSPOT_MAX_CLIENT_COUNT
). Конечный результат предоставляется приложению с помощьюSoftApCapabilities#getMaxSupportedClients
. -
config_wifiSofapClientForceDisconnectSupported
: имеет ли устройство возможность принудительно отключить клиента. Требуется для включения списков разрешенных и заблокированных файлов. Обмен данными с управляющим приложением (приложением «Настройки») черезSoftApCapabilities#areFeaturesSupported( SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT )
. - (Доступно с 13-й версии)
config_wifiSoftapPassphraseAsciiEncodableCheck
: требуется ли кодировка кодовой фразы программной точки доступа в формате ASCII. -
config_wifiSoftapAutoUpgradeToBridgedConfigWhenSupported
: следует ли автоматически обновлять конфигурацию настроек диапазона до двухдиапазона во время восстановления облачной конфигурации, когда поддерживается новое устройство. - (Доступно с версии 13)
config_wifiSoftapAutoAppendLowerBandsToBandConfigurationEnabled
: добавляет ли платформа автоматически нижние диапазоны к конфигурации диапазонов, чтобы избежать обработки сосуществования. -
config_wifiSoftApDynamicCountryCodeUpdateSupported
: поддерживается ли на устройстве динамическое обновление кода страны в режиме точки доступа. - Поддержка каналов:
config_wifiSoftap2gChannelList
,config_wifiSoftap5gChannelList
,config_wifiSoftap6gChannelList
иconfig_wifiSoftap60gChannelList
. - Поддержка восстановления, указывающая, сбрасываются ли соответствующие записи к значениям по умолчанию при восстановлении конфигурации точки доступа на новом устройстве:
config_wifiSoftapResetChannelConfig
,config_wifiSoftapResetHiddenConfig
,config_wifiSoftapResetUserControlConfig
,config_wifiSoftapResetAutoShutdownTimerConfig
,config_wifiSoftapResetMaxClientSettingConfig
. Обратите внимание, что по умолчанию для них установленоtrue
, что означает, что значения сбрасываются. Это очень важно, если новое устройство не поддерживает данную конфигурацию. - Аппаратные возможности:
-
config_wifi_softap_acs_supported
-
config_wifi_softap_sae_supported
- (Доступно с 13)
config_wifiSoftapOweTransitionSupported
- (Доступно с 13)
config_wifiSoftapOweSupported
-
config_wifi_softap_ieee80211ac_supported
-
config_wifiSoftapIeee80211axSupported
- (Доступно с 13)
config_wifiSoftapIeee80211beSupported
-
config_wifiSoftapMacAddressCustomizationSupported
-
config_wifiSoftapHeSuBeamformerSupported
-
config_wifiSoftapHeSuBeamformeeSupported
-
config_wifiSoftapHeMuBeamformerSupported
-
config_wifiSoftapHeTwtSupported
-
config_wifiSoftap24ghzSupported
-
config_wifiSoftap5ghzSupported
-
config_wifiSoftap6ghzSupported
-
config_wifiSoftap60ghzSupported
-
config_wifiSoftapAcsIncludeDfs
-
Валидация
Android предоставляет набор модульных тестов и тестов совместимости (CTS) для проверки функции точки доступа. Функцию точки доступа также можно протестировать с помощью Vendor Test Suite (VTS).
Модульные тесты
Проверьте пакет точки доступа, используя следующие тесты.
Сервисные тесты:
atest packages/modules/Wifi/service/tests/wifitests/
Менеджер тестирует:
atest packages/modules/Wifi/framework/tests/
Тесты набора тестов совместимости (CTS)
Используйте тесты CTS для проверки функции точки доступа. CTS определяет, когда эта функция включена, и автоматически включает соответствующие тесты.
Чтобы запустить тесты CTS, запустите:
atest android.net.wifi.cts.WifiManagerTest
Набор тестов поставщиков (VTS)
Если интерфейс HIDL реализован, запустите:
atest VtsHalWifiHostapdV1_2Target
Если интерфейс AIDL реализован, запустите:
atest VtsHalHostapdTargetTest