Wi-Fi 無線基地台 (軟體存取點)

Android 支援 Wi-Fi 無線基地台 (軟體存取點)，包括透過 Wi-Fi 無線基地台和僅限本機的 Wi-Fi 無線基地台進行網路共用。

軟 AP 功能可設定下列項目：

  • SSID 和 BSSID
  • 安全性類型 (包括 WPA3)
  • 隱藏的 SSID
  • 運作頻帶和頻道 (包括 ACS)
  • 允許的用戶端數量上限
  • 自動關機逾時值
  • 使用許可清單和封鎖清單，讓使用者控管相關聯的裝置
  • 無線基地台 BSSID 的 MAC 隨機化程度
  • 802.11ax 和 802.11be

這些控制項的可用性取決於裝置功能。Android 11 推出了可取得這些功能的 API。裝置製造商也可以使用覆蓋層指定基本裝置功能。

請注意，部分 API 是系統 API，並受到權限限制，因此只有系統的「設定」應用程式才能存取。

使用熱點 API 開發應用程式

AOSP 設定應用程式會提供預設的 Tethered Wi-Fi 熱點實作項目，但不會執行 Soft AP 設定的所有 API。

如要透過無線基地台或僅限本機的無線基地台支援網路共用功能，應用程式必須執行下列功能：

  1. 註冊回呼，以便使用 WifiManager#registerSoftApCallback 取得網路共用無線基地台的裝置功能，或使用 WifiManager#registerLocalOnlyHotspotSoftApCallback 取得僅限本機的無線基地台功能。

    SoftApCallback 回呼提供下列方法：

使用網路共用無線基地台：

  1. 呼叫 WifiManager#setSoftApConfiguration 方法並提供 SoftApConfiguration 例項，即可設定軟 AP 設定以進行 Tethering。使用 SoftApConfiguration.Builder 類別建構 SoftApConfiguration。
  2. 在 TetheringManager#startTethering 上呼叫 Tethering 方法，即可啟動 Tethering。

僅限本機的無線基地台：

  1. 請呼叫 WifiManager#startLocalOnlyHotspot 方法，以特定軟體 AP 設定啟動僅限本機的無線基地台。

實作許可清單和封鎖清單

一般電信業者的要求是，為使用者提供可連結至軟體存取點的裝置控制選項。您可以透過以下幾種機制執行這項操作：

  • 使用 SoftApConfiguration.Builder#setMaxNumberOfClients 限制可與軟 AP 建立關聯的裝置數量上限。請務必指定的數字低於裝置支援的用戶端數量上限。您可以從 SoftApCapability#getMaxSupportedClients 取得最大數量。

  • 使用允許和封鎖清單提供動態控制：

    • 軟 AP 的預設設定可讓所有裝置與軟 AP 建立關聯，但 MAC 位址已新增至 SoftApConfiguration.Builder#setBlockedClientList 的裝置除外。

    • 如果 Soft AP 是使用 SoftApConfiguration.Builder#setClientControlByUserEnabled(true) 進行設定，系統就會使用允許清單。

      • 所有 MAC 位址位於 SoftApConfiguration.Builder#setBlockedClientList 中的裝置都會遭到關聯封鎖。
      • 所有 MAC 位址位於 SoftApConfiguration.Builder#setAllowedClientList 中的裝置都允許建立關聯。
      • 所有其他裝置 (也就是 MAC 位址不在允許或封鎖清單中的裝置) 都會遭到關聯封鎖，但會呼叫 SoftApCallback#onBlockedClientConnecting，讓控制應用程式 (也就是「設定」應用程式) 採取行動，例如要求使用者確認，然後根據使用者的行為將裝置加入允許清單或封鎖清單。

    請注意，裝置必須支援許可清單功能，才能使用這項功能。您可以使用 SoftApCapability#areFeaturesSupported(SOFTAP_FEATURE_CLIENT_FORCE_DISCONNECT) 驗證裝置支援情形。

實作

如要透過無線基地台支援 Tethering 或僅支援本機無線基地台，裝置製造商必須提供設定應用程式、架構和 HAL/韌體支援：

自訂

如要自訂實作方式，裝置製造商應設定下列疊加層和電信業者設定，這些設定已在 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： 是否要求軟 AP 通關密碼可使用 ASCII 編碼。
  • config_wifiSoftapAutoUpgradeToBridgedConfigWhenSupported：在支援新裝置時，是否要在雲端設定還原期間自動將頻道設定升級為雙頻道。
  • (適用於 13 以上版本) config_wifiSoftapAutoAppendLowerBandsToBandConfigurationEnabled：是否要讓架構自動在頻帶設定中附加較低的頻帶，以避免並存處理。
  • config_wifiSoftApDynamicCountryCodeUpdateSupported：裝置是否支援在 AP 模式下動態更新國家/地區代碼
  • 支援的管道：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 提供一組單元測試和 Compatibility Test Suite (CTS) 測試，用於驗證熱點功能。您也可以使用供應商測試套件 (VTS) 測試熱點功能。

單元測試

使用下列測試驗證熱點套件。

  • 服務測試：

    atest packages/modules/Wifi/service/tests/wifitests/

  • 管理員測試：

    atest packages/modules/Wifi/framework/tests/

Compatibility Test Suite (CTS) 測試

使用 CTS 測試驗證無線基地台功能。CTS 會偵測功能啟用時間，並自動納入相關測試。

如要觸發 CTS 測試，請執行：

atest android.net.wifi.cts.WifiManagerTest

供應商測試套件 (VTS)

如果已實作 HIDL 介面，請執行：

atest VtsHalWifiHostapdV1_2Target

如果已實作 AIDL 介面，請執行以下指令：

atest VtsHalHostapdTargetTest