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/+/android17-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 位址相符。不過，如果裝置與存取點建立關聯，則例外情況是，裝置可能會使用與該存取點建立關聯的 MAC 位址，與該存取點或其他存取點進行任何 RTT 交易。
驗證
這項功能有 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 根天線) 來說，系統的 MIMO 設定為 2x4。如果使用 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 規格。