本頁面說明合作夥伴在規劃快速配對專案和系統整合時,需要瞭解的實用資訊。
快速配對材料和程序
本節提供一般行銷和程序資訊的連結。
行銷、品牌宣傳和訊息傳遞
如需品牌宣傳和訊息傳遞方面的指引,請前往合作夥伴行銷中心。新合作夥伴必須申請存取權,現有合作夥伴則可透過合作夥伴網域帳戶存取內容。
快速配對專案生命週期
如要瞭解專案生命週期和合作夥伴的職責 (將快速配對整合至產品),請參閱「系統整合商 (SI) 角色與職責」頁面。
認證程序
實作快速配對功能的裝置必須先通過認證,產品才能使用這項功能進行行銷。快速配對認證指南說明如何準備認證,以及執行認證前自我測試。
認證常見問題涵蓋各種常見問題,包括何時需要完整認證 (或重新認證) 的一般說明。
實作或使用快速配對擴充功能 (例如音訊自動切換) 的裝置也必須通過認證。音訊自動切換功能有獨立的認證指南,說明自我測試步驟,以及第三方實驗室認證的準備工作。
第三方實驗室可以依序認證「快速配對」和「音訊自動切換」功能。如要瞭解哪些實驗室提供哪些認證服務,請參閱「將裝置運送至第三方實驗室」頁面。
技術附註
本節說明一些技術實作注意事項,協助合作夥伴進行開發和整合。
如何與快速配對一併放送其他通訊協定的廣告
部分裝置可能想支援快速配對以外的其他功能,例如 Google 助理或 Eddystone,這類功能需要額外的廣告空間。在這種情況下,輪播廣告資料是最佳選擇。不過,快速配對廣告仍須在廣告間隔內,根據可供偵測模式和不可供偵測模式進行放送。
在認證程序的第三方測試階段,我們會測試廣告輪播功能。請務必在認證前使用 快速配對驗證工具應用程式驗證所有輪替機制,以免認證延遲、重新測試及產生費用。
縮短 BLE 連線間隔
為提升 GATT 連線效能,供應商應盡可能縮短連線間隔。預期最佳值為 7.5 毫秒,適用於大多數的搜尋者。
BLE 廣告和耳機連線狀態
快速配對耳機是否會放送型號 ID 或帳戶資料,取決於耳機的 BR/EDR 可探索模式,而非連線或中斷連線狀態。請參閱下方連結中的「快速配對服務規格」:
TxPower
如規格所述,Seeker 會根據指定的 TxPower 級別,透過 RSSI 估算距離。系統會根據預估距離,判斷是否顯示通知。
判斷 TxPower 的程序如下:
- 使用 Android 手機在 1 公尺外測量裝置的實際輸出,然後加上 41 dBm。
- 在 BLE 廣告中加入這個值。
- 請在自我測試報告中,連同測試用電話資訊一併提供這個值。
使用驗證器應用程式評估及設定 TxPower
驗證工具應用程式提供測試,可手動將 DUT 上的 TxPower 調整至適當等級。合作夥伴可以在自我測試或認證前,使用這項測試判斷 DUT 的適當 TxPower 級別。
TxPower 測量程序
如要使用驗證器應用程式測量 TxPower,請按照下列步驟操作:
- 在 DUT 上開啟驗證器應用程式。
- 開啟應用程式頂端的三點選單:
- 將 DUT 放在距離手機 1 公尺處,然後輕觸「開始」按鈕。
- 從裝置清單中選取 DUT。
- 如要重新整理裝置清單,請輕觸「取消」按鈕,然後再次選取「開始」按鈕。
- 調整紅線 (代表 TxPower),直到紅線幾乎觸及黃色區域頂端為止。
- 使用「-1」按鈕將紅線移向黃色區域。
- 使用「+1」按鈕將紅線移出黃色區域。
- 訊號干擾可能會導致紅線不穩定。如果紅線不穩定,請移動到訊號干擾較少的區域。
- 儲存 TxPower 值,並在 DUT 和裝置控制台中更新該值。
電池通知
如規格所述,供應商可以在廣告中加入電池資訊。Seeker 會根據類型決定是否顯示電池通知,0b0011 代表顯示電池通知,0b0100 則代表隱藏。以下是廣告中加入電池資訊的時機和類型相關規範:
- 在廣告中加入電池資訊,並在開啟充電盒且耳機都已放入充電盒時,顯示電池通知
0b0011至少 8 秒。 - 在廣告中加入電池資訊,並在充電盒關閉且雙耳機都已放入充電盒時,隱藏電池通知
0b0100至少 5 秒。 - 為確保電池通知顯示或隱藏時能即時回應,廣告應在 2 秒內反映實際狀態。
- 隱藏電池通知的方式有 2 種:
- 停止在廣告中加入電池資訊,Seeker 會在一段時間後隱藏通知 (目前設定為 20 秒)。
- 在廣告中加入電池資訊,並隱藏電池通知
0b0100,Seeker 取得廣告後會立即隱藏通知。
- 如果充電盒開啟或關閉時只有一個耳機,廣告中可選擇是否要加入電池資訊。
- 耳機從充電盒取出或放入充電盒時,廣告可選擇是否要顯示電池資訊。
- 為防止追蹤,供應商應只在必要時 (而非隨時) 在廣告中加入原始電池資料。
實作方式應在認證的自我測試結果中說明。
如何啟用快速配對記錄功能
請務必在偵錯前,先在裝置上啟用「藍牙 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