Wi-Fi Aware

Wi-Fi 偵測 Android 8.0 新增的一項功能，可讓支援裝置探索、連線及存取 以及範圍 (已加至 Android 9 中) 彼此直接連線 在沒有網際網路或行動網路連線的情況下，使用 Wi-Fi Aware 通訊協定。這項功能建構於 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 Aware 功能。視實作的介面而定，這可能是：

  • 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 開放原始碼計畫程式碼
    • 啟用「Aware」：必須同時使用功能旗標和版本旗標
  • Wi-Fi Aware (NAN) HAL 支援 (暗示韌體支援)

為了實作這項功能，裝置製造商會實作 Wi-Fi 介面 並啟用兩個功能旗標

  • BoardConfig.mk或BoardConfig-common.mk位於以下地點的： device/<oem>/<device>，請新增下列標記：

    WIFI_HIDL_FEATURE_AWARE := true

  • 在 device/<oem>/<device> 中的 device.mk 中，修改 PRODUCT_COPY_FILES 環境變數，加入對 Wi-Fi Aware 功能的支援：

    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。

否則，AOSP 中已包含這項功能所需的所有內容。

如果指定 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 後，必須以 NanConfigRequest.macAddressRandomizationIntervalSec 參數設定的規則間隔隨機產生 MAC 位址。根據預設，此值由架構設定為 30 分鐘。

暫停及繼續

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

如果裝置支援這項暫停和繼續執行的功能，當特權應用程式暫停探索工作階段時，韌體會暫停 Wi-Fi Aware 工作階段。當探索工作階段處於暫停狀態時，裝置不會傳送或接收該工作階段的任何影格，包括該工作階段中的任何有效 NDP。如果所有探索工作階段都遭到停權，裝置就不會傳輸 或接收任何 Wi-Fi 訊號訊號。

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

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

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

驗證

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

單元測試

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 驗證工具測試

CTS 驗證器測試使用兩種裝置來驗證 Wi-Fi 感知行為：測試 和已知良好裝置。如要執行測試，請開啟 CTS Verifier 並 前往「Wi-Fi 感知測試」部分。