快速配對材料與技術附註

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

快速配對材質和程序

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

行銷、品牌宣傳和訊息

請造訪合作行銷中心，瞭解品牌宣傳和訊息傳遞指南。新合作夥伴需要申請存取權，現有合作夥伴則可透過合作夥伴網域帳戶存取內容。

快速配對專案生命週期

請參閱系統整合商 (SI) 角色和責任頁面，概略瞭解專案生命週期，以及合作夥伴將快速配對整合至產品時應負的責任。

認證程序

實作快速配對的裝置必須先通過認證，才能在產品上市時提供這項功能。快速配對認證指南說明如何準備認證，以及執行認證前自我測試。

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

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

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

技術附註

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

如何與快速配對一併廣播其他通訊協定

部分裝置可能想在快速配對功能之外支援其他功能，例如 Google 助理或 Eddystone，這需要額外的廣告空間。在這種情況下，輪流顯示廣告資料是最佳做法。不過，快速配對廣告仍須根據可偵測模式和不可偵測模式，在廣告間隔內放送。

廣告輪播會在認證程序的第三方測試階段進行測試。請務必在認證前使用快速配對驗證器應用程式驗證所有輪替配置，以免可能發生認證延遲、重新測試和費用。

縮短 BLE 連線間隔

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

BLE 廣告和耳機連線狀態

快速配對耳機是否會廣播型號 ID 或帳戶資料，取決於耳機的 BR/EDR 可供偵測模式，而非連線或中斷連線狀態。請參閱下方連結中的快速配對服務規格：

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

TxPower

根據規格定義，尋找端會根據指定的 TxPower 級別，透過 RSSI 估算距離。預估距離是決定是否顯示通知的關鍵因素。

TxPower 的決定程序如下：

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

注意： 儲存在裝置控制台中的 TxPower 值，可讓合作夥伴更新已出貨裝置的 TxPower 值。您不一定要將 TxPower 值提交至裝置控制台，且裝置控制台中的任何值都會覆寫所有裝置的 TxPower 設定。

使用驗證器應用程式測量及設定 TxPower

Validator 應用程式提供一項測試，可在測試手機上手動將 TxPower 調整至適當等級。合作夥伴可以利用這項測試，在自我測試或認證前，判斷待測裝置的適當 TxPower 級別。

注意： 測試完成後，請務必在待測裝置和裝置控制台中設定 TxPower 級別。

TxPower 測量程序

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

1. 在測試手機上開啟 Validator 應用程式。
2. 開啟應用程式頂端的圓點選單：

   

3. 將待測裝置放在距離手機 1 公尺處，然後輕觸「開始」按鈕。

   

4. 從裝置清單中選取 DUT。

   

   1. 如要重新整理裝置清單，請輕觸「取消」按鈕，然後再次選取「開始」按鈕。
5. 調整紅線 (代表 TxPower)，直到紅線剛好觸及黃色區域的頂端。

   

   1. 使用「-1」按鈕將紅線移向黃色區域。
   2. 使用「+1」按鈕，將紅線移出黃色區域。
   3. 訊號干擾可能會導致紅線不穩定。如果紅線不穩定，請移到訊號干擾較少的地方。
6. 儲存 TxPower 值，並在 DUT 和裝置控制台中更新。

   

電池通知

根據規格定義，供應商可以在廣告中加入電池資訊。「尋找端」會根據類型決定要顯示或隱藏電池通知，0b0011 表示顯示電池通知，0b0100 則表示隱藏。以下列舉幾項準則，說明何時應在廣告中加入電池資訊，以及應使用哪種類型：

1. 當充電盒打開且兩側耳機都放入時，在廣告中加入電池資訊，並顯示電池通知 0b0011 至少 8 秒。
2. 在廣告中加入電池資訊，並在充電盒關閉且兩側耳機都放入充電盒時，隱藏電池通知 0b0100 至少 5 秒。
3. 為了及時顯示或隱藏電池通知，廣告應在 2 秒內反映實際狀態。
4. 隱藏電池通知的方法有 2 種：
   1. 停止在廣告中加入電池資訊，Seeker 會在一段時間後隱藏通知 (目前設為 20 秒)。
   2. 在廣告中加入電池資訊，並隱藏電池通知 0b0100，Seeker 會在收到廣告後立即隱藏通知。
5. 如果充電盒打開或關閉時，只有一個耳機在充電盒中，則可選擇是否在廣告中加入電池資訊。
6. 當耳機從充電盒中取出或放入充電盒時，廣告中可選擇是否包含電池資訊。
7. 為防止追蹤，供應端應只在必要時 (而非隨時) 在廣告中加入原始電池資料。

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

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

偵錯前，請務必在裝置上啟用藍牙 HCI 窺探記錄。此外，為避免重要的快速配對記錄因安全考量而遭到遮蓋，請使用測試 Google 帳戶加入快速配對合作夥伴測試 Google 群組 ([e-mail])。

如要在偵錯記錄檔中擷取快速配對訊息，請執行：

$ 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 建議在每個啟動序列上執行上述指令。

注意： 正式版建構作業可能會移除 VERBOSE 記錄。

如何擷取偵錯記錄檔

執行 $ 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

注意： Google 建議先將手機放在藍牙裝置旁幾分鐘，再嘗試下載錯誤報告 ZIP 檔案。