快速配對材料與技術附註

本頁面說明合作夥伴在規劃快速配對專案和系統整合時,需要瞭解的實用資訊。

快速配對材料和程序

本節提供一般行銷和程序資訊的連結。

行銷、品牌宣傳和訊息傳遞

如需品牌宣傳和訊息傳遞方面的指引,請前往合作夥伴行銷中心。新合作夥伴必須申請存取權,現有合作夥伴則可透過合作夥伴網域帳戶存取內容。

快速配對專案生命週期

如要瞭解專案生命週期和合作夥伴的職責 (將快速配對整合至產品),請參閱「系統整合商 (SI) 角色與職責」頁面。

認證程序

實作快速配對功能的裝置必須先通過認證,產品才能使用這項功能進行行銷。快速配對認證指南說明如何準備認證,以及執行認證前自我測試。

認證常見問題涵蓋各種常見問題,包括何時需要完整認證 (或重新認證) 的一般說明。

實作或使用快速配對擴充功能 (例如音訊自動切換) 的裝置也必須通過認證。音訊自動切換功能有獨立的認證指南,說明自我測試步驟,以及第三方實驗室認證的準備工作。

第三方實驗室可以依序認證「快速配對」和「音訊自動切換」功能。如要瞭解哪些實驗室提供哪些認證服務,請參閱「將裝置運送至第三方實驗室」頁面。

技術附註

本節說明一些技術實作注意事項,協助合作夥伴進行開發和整合。

如何與快速配對一併放送其他通訊協定的廣告

部分裝置可能想支援快速配對以外的其他功能,例如 Google 助理或 Eddystone,這類功能需要額外的廣告空間。在這種情況下,輪播廣告資料是最佳選擇。不過,快速配對廣告仍須在廣告間隔內,根據可供偵測模式不可供偵測模式進行放送。

在認證程序的第三方測試階段,我們會測試廣告輪播功能。請務必在認證前使用 快速配對驗證工具應用程式驗證所有輪替機制,以免認證延遲、重新測試及產生費用。

縮短 BLE 連線間隔

為提升 GATT 連線效能,供應商應盡可能縮短連線間隔。預期最佳值為 7.5 毫秒,適用於大多數的搜尋者。

BLE 廣告和耳機連線狀態

快速配對耳機是否會放送型號 ID 或帳戶資料,取決於耳機的 BR/EDR 可探索模式,而非連線或中斷連線狀態。請參閱下方連結中的「快速配對服務規格」:

  • 「當供應商裝置處於 BR/EDR 可探索狀態 (即配對模式),應透過 BLE 宣傳快速配對模型 ID 資料。」- 連結
  • 「當供應商無法探索 (即不在配對模式) 時,應宣傳快速配對帳戶資料」-連結

TxPower

規格所述,Seeker 會根據指定的 TxPower 級別,透過 RSSI 估算距離。系統會根據預估距離,判斷是否顯示通知。

判斷 TxPower 的程序如下:

  1. 使用 Android 手機在 1 公尺外測量裝置的實際輸出,然後加上 41 dBm。
  2. 在 BLE 廣告中加入這個值。
  3. 請在自我測試報告中,連同測試用電話資訊一併提供這個值。

使用驗證器應用程式評估及設定 TxPower

驗證工具應用程式提供測試,可手動將 DUT 上的 TxPower 調整至適當等級。合作夥伴可以在自我測試或認證前,使用這項測試判斷 DUT 的適當 TxPower 級別。

TxPower 測量程序

如要使用驗證器應用程式測量 TxPower,請按照下列步驟操作:

  1. 在 DUT 上開啟驗證器應用程式。
  2. 開啟應用程式頂端的三點選單:
    這項測試名為「Tx Power Level calibration tool」。
  3. 將 DUT 放在距離手機 1 公尺處,然後輕觸「開始」按鈕。
    測試頁面會以黃色顯示目標預估距離。
  4. 從裝置清單中選取 DUT。
    裝置會依 MAC 位址列出。
    1. 如要重新整理裝置清單,請輕觸「取消」按鈕,然後再次選取「開始」按鈕。
  5. 調整紅線 (代表 TxPower),直到紅線幾乎觸及黃色區域頂端為止。
    正確調整後,紅線會位於黃色區域的最上方。
    1. 使用「-1」按鈕將紅線移向黃色區域。
    2. 使用「+1」按鈕將紅線移出黃色區域。
    3. 訊號干擾可能會導致紅線不穩定。如果紅線不穩定,請移動到訊號干擾較少的區域。
  6. 儲存 TxPower 值,並在 DUT 和裝置控制台中更新該值。
    畫面頂端會顯示該號碼。

電池通知

規格所述,供應商可以在廣告中加入電池資訊。Seeker 會根據類型決定是否顯示電池通知,0b0011 代表顯示電池通知,0b0100 則代表隱藏。以下是廣告中加入電池資訊的時機和類型相關規範:

  1. 在廣告中加入電池資訊,並在開啟充電盒且耳機都已放入充電盒時,顯示電池通知 0b0011 至少 8 秒。
  2. 在廣告中加入電池資訊,並在充電盒關閉且雙耳機都已放入充電盒時,隱藏電池通知 0b0100 至少 5 秒。
  3. 為確保電池通知顯示或隱藏時能即時回應,廣告應在 2 秒內反映實際狀態。
  4. 隱藏電池通知的方式有 2 種:
    1. 停止在廣告中加入電池資訊,Seeker 會在一段時間後隱藏通知 (目前設定為 20 秒)。
    2. 在廣告中加入電池資訊,並隱藏電池通知 0b0100,Seeker 取得廣告後會立即隱藏通知。
  5. 如果充電盒開啟或關閉時只有一個耳機,廣告中可選擇是否要加入電池資訊。
  6. 耳機從充電盒取出或放入充電盒時,廣告可選擇是否要顯示電池資訊。
  7. 為防止追蹤,供應商應只在必要時 (而非隨時) 在廣告中加入原始電池資料。

實作方式應在認證的自我測試結果中說明。

如何啟用快速配對記錄功能

請務必在偵錯前,先在裝置上啟用「藍牙 HCI 窺探記錄」。此外,如要避免重要「快速配對」記錄因安全考量而遭到遮蓋,請使用測試 Google 帳戶加入 Fast Pair Partner Test Google 群組 (fast-pair-partner-test@googlegroups.com)。

如要在偵錯記錄中擷取快速配對訊息,請執行下列指令:

$ adb logcat -G 16M
$ adb shell setprop log.tag.NearbyMessages VERBOSE
$ adb shell setprop log.tag.NearbyDiscovery VERBOSE
$ adb shell setprop log.tag.FastPair VERBOSE

Google 建議您在每次開機程序中執行上述指令。

如何擷取偵錯記錄

執行 $ adb bugreport 產生 ZIP 檔案,其中應包含所有資料。產生 ZIP 檔案可能需要幾分鐘。

請根據 Android 版本執行下列任一指令,取得 btsnoop_hic.log

  • Android 8.x 以上版本: shell $ adb pull data/misc/bluetooth/logs logs
  • Android 7.x: shell $ adb pull sdcard/btsnoop_hci.log