Android 9 的 Wi-Fi 往返時間 (RTT) 功能可讓支援的裝置測量與其他支援裝置的距離，包括存取點 (AP) 或 Wi-Fi Aware 對等互連裝置 (如果裝置支援 Wi-Fi Aware)。這項功能以 IEEE 802.11mc 和 IEEE 802.11az 通訊協定為基礎 (適用於 Android 15 以上版本)，可讓應用程式使用更精確的位置資訊和感知功能。
範例和來源
如要使用這項功能，請實作供應商 HAL 介面。 在 Android 14 以上版本中，供應商 HAL 介面是使用 AIDL 定義。在 Android 13 以下版本中，供應商 HAL 介面是使用 HIDL 定義。在 Android 8.0 中，HIDL 取代了先前的硬體抽象層 (HAL) 結構，可指定收集到介面和封裝中的型別和方法呼叫，進而簡化實作程序。
按照 Wi-Fi 介面操作，即可使用 Wi-Fi RTT 功能。 視實作的介面而定，這可以是：
- AIDL：
hardware/interfaces/wifi/aidl - HIDL：
hardware/interfaces/wifi/1.0以上版本。
您可以參閱舊版 Wi-Fi HAL，瞭解如何與 AIDL 和 HIDL 介面建立關聯： hardware/libhardware_legacy/+/android16-release/include/hardware_legacy/rtt.h。
實作
如要實作 Wi-Fi RTT，您必須提供架構和 HAL/韌體支援：
架構：
- Android 開放原始碼計畫程式碼
- 啟用 Wi-Fi RTT：需要功能旗標
Wi-Fi RTT (IEEE 802.11mc 或 IEEE 802.11az) HAL 支援 (這表示韌體支援)
如要實作這項功能，請實作 Wi-Fi AIDL 或 HIDL 介面，並啟用功能旗標：
在
device/<oem>/<device>中的device.mk內，修改PRODUCT_COPY_FILES環境變數，加入 Wi-Fi RTT 功能的支援：PRODUCT_COPY_FILES += frameworks/native/data/etc/android.hardware.wifi.rtt.xml:$(TARGET_COPY_OUT_VENDOR)/etc/permissions/android.hardware.wifi.rtt.xml
否則，AOSP 會包含這項功能所需的一切項目。
MAC 隨機化
為提升隱私權，Wi-Fi RTT 交易期間使用的 MAC 位址必須隨機產生，也就是說，不得與 Wi-Fi 介面的原生 MAC 位址相符。不過，如果裝置與 AP 建立關聯，則例外情況是，裝置可能會使用與該 AP 或其他 AP 進行任何 RTT 交易時的關聯 MAC 位址。
驗證
這項功能有 Android 相容性測試套件 (CTS) 測試。CTS 會偵測功能是否已啟用，並自動納入相關測試。您也可以使用供應商測試套件 (VTS) 測試這項功能。
單元測試
使用下列指令執行 Wi-Fi RTT 套件測試：
服務測試：
atest com.android.server.wifi.rtt管理員測試：
atest android.net.wifi.rttCTS
這項功能有 Android 相容性測試套件 (CTS) 測試。CTS 會偵測功能是否已啟用，並自動納入相關測試。支援 Wi-Fi RTT (IEEE 802.11mc) 的存取點必須在受測裝置的範圍內。
您可以使用下列方式觸發 CTS 測試：
atest WifiRttTest校正
如要讓 Wi-Fi RTT 正常運作，802.11mc 或 802.11az 協定傳回的範圍應符合本節所述的主要成效指標 (KPI)。
對於 11mc 協定，在列出的頻寬 (80 MHz、40 MHz、20 MHz) 和 8 的叢發大小下，範圍估計的 KPI 預期會在第 90 個百分位數的誤差達到下列準確度。
- 80 MHz：2 公尺
- 40 MHz：4 公尺
- 20 MHz：8 公尺
對於 11az 協定，天線 MIMO 設定和長訓練欄位 (LTF) 重複次數會影響準確度。使用一般手機 (2 根天線) 和存取點 (4 根天線) 時，系統會採用 2x4 MIMO 設定。對於使用 LTF 重複因數為 2 的這類設定，以及所列頻寬 (160 MHz、80 MHz、40 MHz、20 MHz)，範圍估計的 KPI 預期在第 90 個百分位數的誤差下，達到下列準確度。
- 160 MHz：0.5 公尺
- 80 MHz：1 公尺
- 40 MHz：2 公尺
- 20 MHz：4 公尺
為確保功能導入作業正常運作，請務必進行校正測試。
方法是比較基準真相範圍與 RTT 估計範圍，並增加距離。如要進行基本一致性測試，請使用已知已校正 RTT 的裝置驗證解決方案。應在下列情況下測試範圍校準：
- 大型開放式實驗室，或金屬物體不多的走廊，這類環境可能會導致多重路徑異常頻繁發生。
- 至少一條視線 (LOS) 軌跡或路徑，長度至少 25 公尺。
- 從賽道一端到另一端，每隔 0.5 公尺就設有標記。
一端可固定支援 RTT 的存取點，並安裝在離地面 20 公分處；另一端則可移動式安裝 Android 手機 (或其他受測 Android 行動裝置)，並沿著軌道移動，與離地面 20 公分處的 0.5 公尺標記對齊。
每個標記都應記錄 50 個測距結果，以及與存取點的距離。應針對每個標記位置計算統計資料，例如範圍平均值和變異數。
根據步驟 5 的結果，可以繪製基準真相 (X 軸) 與預估範圍 (Y 軸) 的圖表，並估算最合適的回歸線。理想的裝置校準結果是斜率為 1.0 的線，且 y 軸上的偏移量為 0.0 公尺。如果偏差值在相應頻寬的 KPI 範圍內，則可接受。如果結果超出 KPI 範圍，就應重新校正裝置功能，讓結果符合 KPI 規格。