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