Wi-Fi AP/AP 並行

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

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

運作方式

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

Wi-Fi HAL 會使用兩個 AP 介面產生單一橋接介面，並在堆疊啟用軟 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. 請呼叫下列任一方法，設定橋接軟體存取點設定：

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

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

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

自訂閒置時間長度

如要自訂閒置期間的長度，請在 packages/modules/Wifi/service/ServiceWifiResources/res/values/config.xml 中設定下列疊加：

• config_wifiFrameworkSoftApShutDownIdleInstanceInBridgedModeTimeoutMillisecond：預設的關機逾時間隔。只有在啟用 SoftApConfiguration#setBridgedModeOpportunisticShutdownEnabled 時才有效。

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