Wi-Fi AP/AP 並行

Android 12 推出 Wi-Fi AP/AP 並行功能，可讓裝置建立兩個存取點 (AP) 介面。這項功能可讓裝置透過雙頻同步 (DBS) Wi-Fi 熱點 (軟體 AP) 支援網路共用。如要瞭解如何透過單一 Wi-Fi 無線基地台支援網路共用，請參閱「Wi-Fi 無線基地台 (軟體存取點)」。

本頁面說明啟用這項功能時裝置的行為，以及裝置製造商和供應商的實作詳細資料。

運作方式

如果裝置支援 Wi-Fi AP/AP 並行，就能建立兩個 AP 介面，例如一個介面在 2.4 GHz 頻帶上運作，另一個介面在 5 GHz 頻帶上運作。用戶端隨後即可連線至各個 AP 介面。

當堆疊啟用軟體存取點時，Wi-Fi HAL 會產生單一橋接介面，其中包含兩個 AP 介面，並將其公開給 Wi-Fi 和連線堆疊。啟用軟體 AP 後，Wi-Fi HAL 會指出有兩個介面可用，並更新每個 AP 的資訊 (例如作業通道、頻寬和 BSSID)。

為節省電力，架構會在閒置一段時間後停用未使用的 AP (2.4 GHz、5 GHz 或 6 GHz)。如果沒有任何用戶端連線，架構會將 AP 視為處於非使用中狀態。裝置製造商可以自訂這段閒置時間的長度。詳情請參閱「自訂閒置時間」。

裝置可使用下列其中一種橋接軟體 AP 設定，支援 Wi-Fi AP/AP 並行：

• 設定兩個頻段 (架構或驅動程式會自動選取頻道)
• 在雙頻 AP 上設定兩個頻道

需求條件

如要導入 Wi-Fi AP/AP 並行功能，裝置必須符合下列規定：

• Wi-Fi 晶片或韌體必須支援兩個並行的 AP 連線。韌體必須支援兩種連線的所有頻道和頻段組合。為避免效能問題，建議使用支援 2x2+2x2 DBS 的 Wi-Fi 晶片。

• 裝置必須在 Wi-Fi 供應商 HAL 中支援下列方法：

  • IWifiChip.createBridgedApIface()
  • IWifiChip.removeIfaceInstanceFromBridgedApIface()
  • IWifiApIface.resetToFactoryMacAddress()
  • IWifiApIface.getBridgedInstances()

實作

如要實作 Wi-Fi AP/AP 並行功能，請按照下列步驟操作：

1. 使用執行階段資源疊加，啟用下列至少一項功能 (預設為停用)：

   • config_wifiBridgedSoftApSupported：支援多個橋接在一起的 AP。
   • config_wifiStaWithBridgedSoftApConcurrencySupported：支援電台 (STA) 和多個橋接 AP 的並行作業。

2. 如果裝置使用 AIDL Wi-Fi HAL 或 HIDL Wi-Fi HAL 1.6，請在 Wi-Fi HAL 介面組合中定義 AP_BRIDGED。詳情請參閱「Wi-Fi 多介面並行」。

3. 呼叫下列其中一種方法，設定橋接軟體 AP 設定：

   • SoftApConfiguration.Builder#setBands
   • SoftApConfiguration.Builder#setChannels

4. 使用 WifiManager#registerSoftApCallback 註冊回呼，取得裝置功能。SoftApCallback 回呼提供下列方法，用於橋接軟體 AP 設定：

   • SoftApCallback#onInfoChanged：提供有關執行中軟體 AP 執行個體的資訊。
   • SoftApCallback#onConnectedClientsChanged： 提供軟體 AP 執行個體的已連線用戶端清單。

自訂閒置期間

如要自訂閒置時間長度，請設定下列疊加層 (位於 packages/modules/Wifi/service/ServiceWifiResources/res/values/config.xml 中)：

• config_wifiFrameworkSoftApShutDownIdleInstanceInBridgedModeTimeoutMillisecond： 預設的關機逾時間隔。必須啟用 SoftApConfiguration#setBridgedModeOpportunisticShutdownEnabled 才會生效。

• (適用於 13 以上版本) config_wifiFrameworkSoftApDisableBridgedModeShutdownIdleInstanceWhenCharging： 指出是否要在充電時停用閒置關機計時器。