Wi-Fi 連線

Android 8.0 中新增的 Wi-Fi Aware 功能可讓支援裝置直接在沒有網際網路或行動網路存取權的情況下,使用 Wi-Fi Aware 通訊協定來探索、連線,以及互相連線 (已新增於 Android 9 中)。這項功能以 Wi-Fi Alliance (WFA) Wi-Fi Aware 規格 (2.0、3.0、3.1 和 4.0 版) 為基礎,方便在信任的裝置和非網路中分享高處理量資料。

範例和來源

如要使用這項功能,裝置製造商應實作 Wi-Fi 供應商 HAL。在 Android 14 以上版本中,供應商 HAL 介面是以 AIDL 定義。如果是 Android 13 以下的版本,供應商 HAL 介面是使用 HIDL 所定義。

按照 Wi-Fi 介面操作,使用 Wi-Fi 感知功能。 視實作的介面而定,可能是:

  • AIDL:hardware/interfaces/wifi/aidl
  • HIDL:hardware/interfaces/wifi/1.2 以上版本

您可以參考舊版 Wi-Fi HAL,瞭解該舊版 Wi-Fi HAL 與 AIDL 和 HIDL 介面之間的關聯性:hardware/libhardware_legacy/+/main/include/hardware_legacy/wifi_nan.h

導入作業

裝置製造商必須同時提供架構和 HAL/韌體支援:

  • 架構:
    • Android 開放原始碼計畫程式碼
    • 啟用感知:需要功能旗標和建構標記
  • Wi-Fi Aware (NAN) HAL 支援 (暗示韌體支援)

如要實作這項功能,裝置製造商會實作 Wi-Fi 介面,並啟用以下兩個功能旗標:

  • device/<oem>/<device>BoardConfig.mkBoardConfig-common.mk 中,新增下列標記:

    WIFI_HIDL_FEATURE_AWARE := true
    
  • device/<oem>/<device> 中的 device.mk 中,修改 PRODUCT_COPY_FILES 環境變數,加入對 Wi-Fi 感知功能的支援:

    PRODUCT_COPY_FILES +=
    frameworks/native/data/etc/android.hardware.wifi.aware.xml:$(TARGET_COPY_OUT_VENDOR)/etc/permissions/android.hardware.wifi.aware.xml
    

Wi-Fi Aware 範圍涵蓋使用 IEEE 802.11mc 通訊協定的對等互連裝置,也稱為封包往返時間 (RTT)。這項 Wi-Fi Aware 的子功能是在裝置上支援 Wi-Fi RTT 功能的有條件,因此裝置必須同時支援 Wi-Fi Aware 和 Wi-Fi RTT。詳情請參閱 Wi-Fi RTT

在其他情況下,Android 開放原始碼計畫已納入這項功能所需的一切資訊。

如果指定 WIFI_HAL_INTERFACE_COMBINATIONS 標記,系統會忽略 WIFI_HIDL_FEATURE_AWARE 標記。詳情請參閱 Wi-Fi 多介面並行

MAC 隨機化

Android 要求 Wi-Fi Aware 探索 (NMI) 和資料介面 (NDP) 的 MAC 位址必須隨機化,且與裝置的實際 MAC 位址不同。MAC 位址必須符合下列條件:

  • 啟用或重新啟用 Wi-Fi Aware 時隨機選取。
  • 啟用 Wi-Fi Aware 時,MAC 位址必須透過 NanConfigRequest.macAddressRandomizationIntervalSec 參數設定的一般間隔隨機隨機化。根據預設,架構會設定為 30 分鐘。

暫停並繼續

在 Android 14 以上版本中,Wi-Fi Aware 可讓具有特殊權限的應用程式暫停及恢復主動探索工作階段 (包括與這些工作階段相關聯的所有資料路徑)。如果支援這項功能,裝置可加快探索工作階段的速度,並減少耗電量,因為探索工作階段可能會暫停。

如果裝置支援暫停和恢復功能,具有特殊權限的應用程式暫停探索工作階段時,韌體就會暫停 Wi-Fi Aware 工作階段。探索工作階段處於暫停狀態時,裝置不會傳輸或接收該工作階段的任何影格,包括該工作階段中的任何有效的 NDP。如果所有探索工作階段都遭到停權,裝置不會傳輸或接收任何 Wi-Fi Aware 影格。

當具有特殊權限的應用程式重新啟用已暫停的探索工作階段時,架構會將工作階段返回至先前的狀態,包括所有相關聯的 NDP 工作階段。比起開啟 Wi-Fi Aware 並建立新的探索工作階段,繼續執行已暫停的探索工作階段會更快。

為了支援暫停及繼續探索工作階段的功能,裝置製造商必須提供 HAL 和韌體支援。詳情請參閱 IWifiNanIface.java

裝置製造商可以使用頻外通訊 (例如 BLE) 同步處理多部裝置上的暫停和繼續作業。

驗證

Android 提供一組單元測試、Compatibility Test Suite (CTS) 測試和 CTS Verifier 測試來驗證 Wi-Fi 感知功能。您也可以使用供應商測試套件 (VTS) 來測試 Wi-Fi Aware。

單元測試

Wi-Fi Aware 套件測試是使用以下方式執行:

服務測試:

atest com.android.server.wifi.aware

管理員測試:

atest android.net.wifi.aware

Compatibility Test Suite (CTS) 測試

透過 CTS 測試來驗證 Wi-Fi 感知功能。CTS 會偵測這項功能啟用的時間,並自動納入相關測試。

您可以透過以下方式觸發 CTS 測試:

atest SingleDeviceTest

CTS Verifier 測試

CTS 驗證器測試使用兩種裝置 (測試裝置和已知良好裝置) 來驗證 Wi-Fi 感知行為。如要執行測試,請開啟 CTS Verifier,然後前往名為「Wi-Fi Aware Tests」的區段。