Wi-Fi Direct 功能又稱為 Wi-Fi P2P,可讓支援裝置在沒有網際網路或行動網路存取權的情況下,使用 Wi-Fi Direct 通訊協定直接探索彼此並連線。這項功能以 Wi-Fi Alliance (WFA) Wi-Fi Direct 規格建構而成,可讓受信任的裝置和非網路的應用程式共享高處理量資料。
範例和來源
如要使用這項功能,裝置製造商必須實作 Wi-Fi 供應商和供應者 HAL 介面。
在 Android 13 中,供應器介面使用 AIDL 做為 HAL 定義。在 Android 14 以上版本中,供應商 HAL 介面會使用 AIDL。在 Android 12 以下版本中,供應者和供應商 HAL 介面是使用 HIDL 所定義。
必須使用下列 Wi-Fi HAL 介面才能使用 Wi-Fi Direct 功能:
hardware/interfaces/wifi/aidl
或hardware/interfaces/wifi/1.3
或更高版本hardware/interfaces/wifi/supplicant/aidl
或hardware/interfaces/wifi/supplicant/1.2
或更高版本
導入作業
裝置製造商必須同時提供架構和 HAL/韌體支援:
- 架構:
- Android 開放原始碼計畫程式碼
- 啟用 Wi-Fi Direct:需要功能旗標
- Wi-Fi Direct (P2P) HAL 支援 (暗示韌體支援)
如要實作這項功能,裝置製造商會實作 Wi-Fi HIDL 或 AIDL 介面,並為 Wi-Fi Direct 啟用功能旗標。在 device/<oem>/<device>
中的 device.mk
中修改 PRODUCT_COPY_FILES
環境變數,加入對 Wi-Fi Direct 功能的支援:
```
PRODUCT_COPY_FILES +=
frameworks/native/data/etc/android.hardware.wifi.direct.xml:$(TARGET_COPY_OUT_VENDOR)/etc/permissions/android.hardware.wifi.direct.xml
```
其他支援 Wi-Fi Direct 的條件已納入 Android 開放原始碼計畫。
MAC 隨機化
Android 規定 Wi-Fi Direct 的「裝置位址」和「介面位址」必須隨機進行。它們必須與裝置的真實 MAC 位址不同,並且必須符合下列需求:
- 如果在建立介面時未儲存永久群組,則 Wi-Fi Direct 裝置位址必須隨機化;否則裝置位址必須繼續使用最新產生的 MAC 位址。
- Wi-Fi Direct 介面位址 (又稱為群組地址) 每次建立連線時都必須隨機指派。
Wi-Fi Direct MAC 隨機化作業是在「wpa_supplicant」中實作,並由 p2p_device_random_mac_addr
和 p2p_interface_random_mac_addr
這兩項設定控管。
如要啟用這項功能,裝置製造商必須:
- 實作 Wi-Fi 供應器
ISupplicantP2pIface::setMacRandomization
API。視實作的介面而定,這部分如下:hardware/interface/wifi/supplicant/1.2
代表 HIDLhardware/interface/wifi/supplicant/aidl
代表 AIDL
- 請在裝置自訂疊加層中將
config_wifi_p2p_mac_randomization_supported
設為「true」。
驗證
Android 提供一組單元測試、Compatibility Test Suite (CTS) 測試和 CTS Verifier 測試來驗證 Wi-Fi Direct 功能。您也可以使用供應商測試套件 (VTS) 來測試 Wi-Fi Direct。
單元測試
請使用下列測試確認 Wi-Fi Direct 套件。
服務測試:
atest com.android.server.wifi.p2p
管理員測試:
atest android.net.wifi.p2p
Compatibility Test Suite (CTS) 測試
進行 CTS 測試,驗證 Wi-Fi Direct 功能。CTS 會偵測這項功能啟用的時間,並自動納入相關測試。
如要觸發 CTS 測試,請執行:
% atest android.net.wifi.p2p.cts
CTS Verifier 測試
CTS 驗證器測試使用兩種裝置來驗證 Wi-Fi Direct 行為:測試裝置和已知正常裝置。如要執行測試,請開啟 CTS Verifier,然後前往名為「Wi-Fi Direct Tests」的區段。