O Android fornece suporte para ponto de acesso Wi-Fi (Soft AP), incluindo tethering por meio de um ponto de acesso Wi-FI e pontos de acesso Wi-Fi somente locais.
O recurso soft AP permite a configuração do seguinte:
- SSID e BSSID
- Tipo de segurança (incluindo WPA3)
- SSID oculto
- Banda operacional e canal (incluindo ACS)
- Número máximo de clientes permitidos
- Valor de tempo limite de desligamento automático
- Lista de permissão e lista de bloqueio para permitir o controle do usuário de dispositivos associados
- Nível de randomização MAC para o AP BSSID
- 802.11ax e 802.11be
Os recursos do dispositivo determinam a disponibilidade desses controles. O Android 11 apresenta APIs para obter esses recursos. Os fabricantes de dispositivos também podem especificar os recursos básicos do dispositivo usando sobreposições.
Observe que algumas das APIs são APIs do sistema e são restritas por meio de permissões para que apenas o aplicativo Configurações do sistema possa acessá-las.
Desenvolvendo aplicativos com APIs de ponto de acesso
Uma implementação padrão de um ponto de acesso Wi-Fi conectado é fornecida pelo aplicativo AOSP Settings, mas não exerce todas as APIs para configuração de Soft AP.
Para oferecer suporte ao tethering por meio de um ponto de acesso ou ponto de acesso apenas local, o aplicativo deve executar as seguintes funções:
Registre um retorno de chamada para obter os recursos do dispositivo usando
WifiManager#registerSoftApCallback
para um ponto de acesso conectado ouWifiManager#registerLocalOnlyHotspotSoftApCallback
para um ponto de acesso somente local.O retorno de chamada
SoftApCallback
fornece os seguintes métodos:-
SoftApCallback#onCapabilityChanged
: Fornece informações sobre os recursos do dispositivo, incluindo o número máximo de clientes suportados e se SAE ou ACS são suportados. -
SoftApCallback#onInfoChanged
: Fornece informações sobre o Soft AP em execução (válido apenas uma vez iniciado), incluindo informações de banda e frequência. -
SoftApCallback#onConnectedClientsChanged
: Fornece uma lista de clientes conectados. Para cada cliente, você pode obter o endereço MAC. Para obter as informações de IP, use o retorno de chamadaTetheringEventCallback#onClientsChanged
. -
SoftApCallback#onStateChanged
: Fornece atualizações sobre o estado do Soft AP à medida que ele é habilitado e desabilitado. -
SoftApCallback#onBlockedClientConnecting
: Fornece as informações do cliente bloqueado com um dos seguintes motivos para o bloqueio: o dispositivo atingiu o número máximo de clientes que pode suportar ou o cliente não está explicitamente autorizado a se conectar.
-
Para um ponto de acesso conectado:
- Defina a configuração de soft AP para tethering chamando o método
WifiManager#setSoftApConfiguration
e fornecendo uma instânciaSoftApConfiguration
. ConstruaSoftApConfiguration
usando a classeSoftApConfiguration.Builder
. - Inicie o tethering chamando o método tethering em
TetheringManager#startTethering
.
Para ponto de acesso somente local:
- Inicie o ponto de acesso somente local com uma configuração de AP suave específica chamando o método
WifiManager#startLocalOnlyHotspot
.
Implementando listas de permissões e bloqueios
Um requisito típico da operadora é fornecer ao usuário controles dos dispositivos que podem ser associados ao Soft AP. Existem vários mecanismos para fazer isso:
- Limite o número máximo de dispositivos que podem associar ao AP flexível usando
SoftApConfiguration.Builder#setMaxNumberOfClients
. Certifique-se de especificar um número inferior ao número máximo de clientes suportados pelo dispositivo. Você pode obter o número máximo deSoftApCapability#getMaxSupportedClients
. Forneça controle dinâmico usando listas de permissões e bloqueios:
- A configuração padrão de um Soft AP permite que todos os dispositivos se associem ao soft AP, exceto para dispositivos cujos endereços MAC são adicionados a
SoftApConfiguration.Builder#setBlockedClientList
. Se o Soft AP estiver configurado com
SoftApConfiguration.Builder#setClientControlByUserEnabled( true )
, a lista de permissões será usada.- Todos os dispositivos cujos endereços MAC estão em
SoftApConfiguration.Builder#setBlockedClientList
são bloqueados para associação. - Todos os dispositivos cujos endereços MAC estão em
SoftApConfiguration.Builder#setAllowedClientList
têm permissão de associação. - Todos os outros dispositivos (ou seja, dispositivos cujos endereços MAC não estão na lista de permissão ou bloqueio) são bloqueados para associação, mas
SoftApCallback#onBlockedClientConnecting
é chamado, permitindo que o aplicativo de controle (ou seja, o aplicativo Configurações) execute uma ação, por por exemplo, pedindo a confirmação do usuário e, em seguida, adicionando o dispositivo à lista de permissões ou à lista de bloqueios, dependendo do comportamento do usuário.
- Todos os dispositivos cujos endereços MAC estão em
Observe que os dispositivos só podem usar a funcionalidade da lista de permissões se ela for compatível com o dispositivo. Você pode verificar o suporte do dispositivo usando
SoftApCapability#areFeaturesSupported( SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT )
.- A configuração padrão de um Soft AP permite que todos os dispositivos se associem ao soft AP, exceto para dispositivos cujos endereços MAC são adicionados a
Implementação
Para dar suporte ao tethering por meio de um ponto de acesso ou para dar suporte a um ponto de acesso somente local, os fabricantes de dispositivos devem fornecer suporte ao aplicativo Settings, framework e HAL/firmware:
Aplicativo de configurações: o aplicativo de configurações AOSP fornece uma linha de base para configurar um ponto de acesso de tethering com SSID e credenciais de segurança. Esse código pode ser usado como está ou modificado para fornecer recursos adicionais, conforme descrito em Desenvolvendo aplicativos com APIs de ponto de acesso .
Estrutura: o código da estrutura AOSP oferece suporte a todas as funcionalidades descritas em Desenvolvendo aplicativos com APIs de ponto de acesso .
HAL/firmware para ponto de acesso: HIDL IHostapd.hal versão 1.2 ou superior ou AIDL IHostapd.aidl .
Costumização
Para personalizar a implementação, os fabricantes de dispositivos devem configurar as seguintes sobreposições e configurações de operadora, documentadas em packages/modules/Wifi/service/ServiceWifiResources/res/values/config.xml
:
-
config_wifiFrameworkSoftApShutDownTimeoutMilliseconds
: O intervalo de tempo limite de desligamento padrão. Válido apenas seSoftApConfiguration#setAutoShutdownEnabled
estiver ativado. Pode ser substituído usandoSoftApConfiguration#setShutdownTimeoutMillis
. -
config_wifiHardwareSoftapMaxClientCount
: A limitação de hardware para o número máximo de clientes suportados. O número máximo de clientes que o dispositivo suporta é o mínimo das restrições de hardware e operadora (especificado porCarrierConfigManager.Wifi#KEY_HOTSPOT_MAX_CLIENT_COUNT
). O resultado final é fornecido ao aplicativo comSoftApCapabilities#getMaxSupportedClients
. -
config_wifiSofapClientForceDisconnectSupported
: se o dispositivo tem a capacidade de forçar a desconexão de um cliente. Necessário para habilitar listas de permissões e bloqueios. Comunicado ao aplicativo de controle (aplicativo de configurações) por meio deSoftApCapabilities#areFeaturesSupported( SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT )
. - (Disponível a partir de 13)
config_wifiSoftapPassphraseAsciiEncodableCheck
: Se a senha do AP flexível deve ou não ser codificada em ASCII. -
config_wifiSoftapAutoUpgradeToBridgedConfigWhenSupported
: se deve ou não atualizar automaticamente a configuração de configuração de banda para bandas duplas durante a restauração da configuração de nuvem quando um novo dispositivo é suportado. - (Disponível a partir de 13)
config_wifiSoftapAutoAppendLowerBandsToBandConfigurationEnabled
: se a estrutura anexa automaticamente bandas inferiores à configuração de banda para evitar manipulação de coexistência. -
config_wifiSoftApDynamicCountryCodeUpdateSupported
: se a atualização dinâmica do código do país no modo AP é suportada ou não no dispositivo - Suporte de canal:
config_wifiSoftap2gChannelList
,config_wifiSoftap5gChannelList
,config_wifiSoftap6gChannelList
econfig_wifiSoftap60gChannelList
. - Restaurar suporte especificando se as entradas correspondentes são redefinidas para o padrão ao restaurar a configuração do ponto de acesso para um novo dispositivo:
config_wifiSoftapResetChannelConfig
,config_wifiSoftapResetHiddenConfig
,config_wifiSoftapResetUserControlConfig
,config_wifiSoftapResetAutoShutdownTimerConfig
,config_wifiSoftapResetMaxClientSettingConfig
. Observe que eles são definidos comotrue
por padrão, o que significa que os valores são redefinidos. Isso é crítico se o novo dispositivo não for compatível com a configuração. - Recursos de hardware:
-
config_wifi_softap_acs_supported
-
config_wifi_softap_sae_supported
- (Disponível a partir de 13)
config_wifiSoftapOweTransitionSupported
- (Disponível a partir de 13)
config_wifiSoftapOweSupported
-
config_wifi_softap_ieee80211ac_supported
-
config_wifiSoftapIeee80211axSupported
- (Disponível a partir de 13)
config_wifiSoftapIeee80211beSupported
-
config_wifiSoftapMacAddressCustomizationSupported
-
config_wifiSoftapHeSuBeamformerSupported
-
config_wifiSoftapHeSuBeamformeeSupported
-
config_wifiSoftapHeMuBeamformerSupported
-
config_wifiSoftapHeTwtSupported
-
config_wifiSoftap24ghzSupported
-
config_wifiSoftap5ghzSupported
-
config_wifiSoftap6ghzSupported
-
config_wifiSoftap60ghzSupported
-
config_wifiSoftapAcsIncludeDfs
-
Validação
O Android fornece um conjunto de testes de unidade, testes de integração (Android Connectivity Test Suite ou ACTS) e testes de Compatibility Test Suite (CTS) para validar o recurso de ponto de acesso. O recurso de ponto de acesso também pode ser testado usando o Vendor Test Suite (VTS).
testes de unidade
Verifique o pacote de ponto de acesso usando os testes a seguir.
Testes de serviço:
atest packages/modules/Wifi/service/tests/wifitests/
Testes de gerente:
atest packages/modules/Wifi/framework/tests/
Testes de integração (ACTS)
O conjunto de testes ACTS hotspot, localizado em tools/test/connectivity/acts_tests/tests/google/wifi/WifiSoftApTest.py
, implementa testes funcionais do recurso hotspot.
Testes do Conjunto de Testes de Compatibilidade (CTS)
Use testes CTS para validar o recurso de ponto de acesso. O CTS detecta quando o recurso está habilitado e inclui automaticamente os testes associados.
Para acionar os testes CTS, execute:
atest android.net.wifi.cts.WifiManagerTest
Conjunto de teste do fornecedor (VTS)
Se a interface HIDL for implementada, execute:
atest VtsHalWifiHostapdV1_2Target
Se a interface AIDL for implementada, execute:
atest VtsHalHostapdTargetTest