Android est compatible avec les points d'accès Wi-Fi (Soft AP), y compris le partage de connexion via un point d'accès Wi-Fi et les points d'accès Wi-Fi locaux uniquement.
La fonctionnalité de point d'accès logiciel permet de configurer les éléments suivants:
- SSID et BSSID
- Type de sécurité (y compris WPA3)
- SSID masqué
- Bande de fonctionnement et canal (y compris ACS)
- Nombre maximal de clients autorisés
- Valeur du délai d'arrêt automatique
- Ajouter des listes d'autorisation et de blocage pour permettre aux utilisateurs de contrôler les appareils associés
- Niveau de randomisation MAC pour le BSSID du point d'accès
- 802.11ax et 802.11be
La disponibilité de ces commandes dépend des capacités de l'appareil. Android 11 introduit des API pour obtenir ces fonctionnalités. Les fabricants d'appareils peuvent également spécifier les fonctionnalités de base des appareils à l'aide de superpositions.
Notez que certaines API sont des API système dont l'accès est limité via des autorisations afin que seule l'application Paramètres du système puisse y accéder.
Développer des applications avec les API des points d'accès
Une implémentation par défaut d'un point d'accès Wi-Fi partagé est fournie par l'application Paramètres AOSP, mais elle n'utilise pas toutes les API pour la configuration du point d'accès logiciel.
Pour permettre le partage de connexion via un point d'accès ou un point d'accès local uniquement, l'application doit effectuer les opérations suivantes:
Enregistrez un rappel pour obtenir les fonctionnalités de l'appareil à l'aide de
WifiManager#registerSoftApCallback
pour un point d'accès partagé ou deWifiManager#registerLocalOnlyHotspotSoftApCallback
pour un point d'accès local uniquement.Le rappel
SoftApCallback
fournit les méthodes suivantes:SoftApCallback#onCapabilityChanged
: fournit des informations sur les fonctionnalités de l'appareil, y compris le nombre maximal de clients compatibles et l'état SAE ou ACS.SoftApCallback#onInfoChanged
: fournit des informations sur le point d'accès souple en cours d'exécution (valide uniquement une fois démarré), y compris des informations sur la bande et la fréquence.SoftApCallback#onConnectedClientsChanged
: fournit la liste des clients connectés. Pour chaque client, vous pouvez obtenir l'adresse MAC. Pour obtenir les informations IP, utilisez le rappelTetheringEventCallback#onClientsChanged
.SoftApCallback#onStateChanged
: fournit des mises à jour sur l'état du point d'accès logiciel lorsqu'il est activé et désactivé.SoftApCallback#onBlockedClientConnecting
: fournit les informations sur le client bloqué. L'une des raisons suivantes peut expliquer le blocage: l'appareil a atteint le nombre maximal de clients qu'il peut prendre en charge ou le client n'est pas explicitement autorisé à se connecter.
Pour un point d'accès partagé:
- Configurez la configuration du point d'accès logiciel pour le partage de connexion en appelant la méthode
WifiManager#setSoftApConfiguration
et en fournissant une instanceSoftApConfiguration
. CréezSoftApConfiguration
à l'aide de la classeSoftApConfiguration.Builder
. - Démarrez le partage de connexion en appelant la méthode sur
TetheringManager#startTethering
.
Pour un point d'accès local uniquement:
- Démarrez le point d'accès local uniquement avec une configuration de point d'accès flexible spécifique en appelant la méthode
WifiManager#startLocalOnlyHotspot
.
Implémenter des listes d'autorisation et de blocage
Une exigence typique des opérateurs consiste à fournir à l'utilisateur les commandes des appareils autorisés à s'associer au point d'accès souple. Pour cela, il existe plusieurs mécanismes:
- Limitez le nombre maximal d'appareils pouvant s'associer au point d'accès logiciel avec
SoftApConfiguration.Builder#setMaxNumberOfClients
. Veillez à spécifier un nombre inférieur au nombre maximal de clients pris en charge par l'appareil. Vous pouvez obtenir le nombre maximal à partir deSoftApCapability#getMaxSupportedClients
. Offrez un contrôle dynamique à l'aide de listes d'autorisation et de blocage:
- La configuration par défaut d'un point d'accès partiel permet à tous les appareils de s'associer à ce point d'accès, à l'exception de ceux dont les adresses MAC sont ajoutées à
SoftApConfiguration.Builder#setBlockedClientList
. Si le point d'accès souple est configuré avec
SoftApConfiguration.Builder#setClientControlByUserEnabled(true)
, la liste d'autorisation est utilisée.- L'association est bloquée pour tous les appareils dont les adresses MAC se trouvent dans
SoftApConfiguration.Builder#setBlockedClientList
. - L'association est autorisée pour tous les appareils dont les adresses MAC se trouvent dans
SoftApConfiguration.Builder#setAllowedClientList
. - L'association est bloquée pour tous les autres appareils (c'est-à-dire les appareils dont les adresses MAC ne figurent pas dans la liste d'autorisation ou de blocage), mais
SoftApCallback#onBlockedClientConnecting
est appelé, ce qui permet à l'application de contrôle (c'est-à-dire l'application Paramètres) d'effectuer une action, par exemple demander confirmation à l'utilisateur, puis ajouter l'appareil à la liste d'autorisation ou à la liste de blocage en fonction du comportement de l'utilisateur.
- L'association est bloquée pour tous les appareils dont les adresses MAC se trouvent dans
Notez que les appareils ne peuvent utiliser la fonctionnalité de liste d'autorisation que si elle est compatible avec eux. Vous pouvez vérifier la compatibilité de l'appareil à l'aide de
SoftApCapability#areFeaturesSupported(SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT)
.- La configuration par défaut d'un point d'accès partiel permet à tous les appareils de s'associer à ce point d'accès, à l'exception de ceux dont les adresses MAC sont ajoutées à
Implémentation
Pour accepter le partage de connexion via un point d'accès ou un point d'accès local uniquement, les fabricants d'appareils doivent fournir l'application Paramètres, le framework et la compatibilité du micrologiciel/HAL:
Application Paramètres:l'application Paramètres d'AOSP fournit une référence pour la configuration d'un point d'accès de partage de connexion avec un SSID et des identifiants de sécurité. Ce code peut être utilisé tel quel ou modifié pour fournir des fonctionnalités supplémentaires, comme décrit dans la section Développer des applications avec des API de point d'accès.
Framework:le code du framework AOSP est compatible avec toutes les fonctionnalités décrites dans Développer des applications avec des API de zone cliquable.
HAL/micrologiciel pour le point d'accès:soit IHostapd.hal version 1.2 ou ultérieure de HIDL, soit IHostapd.aidl d'AIDL.
Personnalisation
Pour personnaliser l'implémentation, les fabricants d'appareils doivent configurer les superpositions et les configurations d'opérateur suivantes, décrites dans packages/modules/Wifi/service/ServiceWifiResources/res/values/config.xml
:
config_wifiFrameworkSoftApShutDownTimeoutMilliseconds
: intervalle du délai avant expiration d'arrêt par défaut. Valide uniquement siSoftApConfiguration#setAutoShutdownEnabled
est activé. Vous pouvez le remplacer à l'aide deSoftApConfiguration#setShutdownTimeoutMillis
.config_wifiHardwareSoftapMaxClientCount
: limite matérielle pour le nombre maximal de clients compatibles. Le nombre maximal de clients compatibles avec l'appareil correspond au minimum des contraintes liées au matériel et à l'opérateur (spécifié parCarrierConfigManager.Wifi#KEY_HOTSPOT_MAX_CLIENT_COUNT
). Le résultat final est fourni à l'application avecSoftApCapabilities#getMaxSupportedClients
.config_wifiSofapClientForceDisconnectSupported
: indique si l'appareil peut forcer la déconnexion d'un client. Requis pour activer les listes d'autorisation et de blocage. Communiqué à l'application de contrôle (application Paramètres) viaSoftApCapabilities#areFeaturesSupported(SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT)
.- (Disponible à partir de 13)
config_wifiSoftapPassphraseAsciiEncodableCheck
: indique si la phrase secrète du point d'accès logiciel doit être encodable en ASCII. config_wifiSoftapAutoUpgradeToBridgedConfigWhenSupported
: indique si oui ou non la configuration des paramètres de bande doit être automatiquement mise à niveau vers le mode double bande lors de la restauration de la configuration cloud lorsqu'un nouvel appareil est pris en charge.- (Disponible à partir de 13)
config_wifiSoftapAutoAppendLowerBandsToBandConfigurationEnabled
: indique si le framework ajoute automatiquement des bandes inférieures à la configuration des bandes pour éviter la gestion de la coexistence. config_wifiSoftApDynamicCountryCodeUpdateSupported
: indique si la mise à jour dynamique du code pays en mode PA est prise en charge ou non par l'appareil.- Canal compatible:
config_wifiSoftap2gChannelList
,config_wifiSoftap5gChannelList
,config_wifiSoftap6gChannelList
etconfig_wifiSoftap60gChannelList
. - Restauration de la prise en charge en spécifiant si les entrées correspondantes sont réinitialisées aux valeurs par défaut lors de la restauration de la configuration du point d'accès sur un nouvel appareil :
config_wifiSoftapResetChannelConfig
,config_wifiSoftapResetHiddenConfig
,config_wifiSoftapResetUserControlConfig
,config_wifiSoftapResetAutoShutdownTimerConfig
,config_wifiSoftapResetMaxClientSettingConfig
. Notez qu'ils sont définis surtrue
par défaut, ce qui signifie qu'ils sont réinitialisés. Cette étape est essentielle si le nouvel appareil n'est pas compatible avec la configuration. - Capacités matérielles :
config_wifi_softap_acs_supported
config_wifi_softap_sae_supported
- (À partir de 13)
config_wifiSoftapOweTransitionSupported
- (À partir de 13)
config_wifiSoftapOweSupported
config_wifi_softap_ieee80211ac_supported
config_wifiSoftapIeee80211axSupported
- (À 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
Validation
Android fournit un ensemble de tests unitaires et de tests CTS (Compatibility Test Suite) pour valider la fonctionnalité de point d'accès. La fonctionnalité de point d'accès peut également être testée à l'aide de la suite de tests fournisseurs (VTS).
Tests unitaires
Vérifiez le package de point d'accès à l'aide des tests suivants.
Tests du service:
atest packages/modules/Wifi/service/tests/wifitests/
Tests du responsable:
atest packages/modules/Wifi/framework/tests/
Tests de la suite de tests de compatibilité (CTS)
Utilisez les tests CTS pour valider la fonctionnalité de point d'accès. CTS détecte quand la fonctionnalité est activée et inclut automatiquement les tests associés.
Pour déclencher les tests CTS, exécutez la commande suivante:
atest android.net.wifi.cts.WifiManagerTest
Suite de test pour les fournisseurs (VTS)
Si l'interface HIDL est implémentée, exécutez la commande suivante:
atest VtsHalWifiHostapdV1_2Target
Si l'interface AIDL est implémentée, exécutez la commande suivante:
atest VtsHalHostapdTargetTest