快速配對功能常見問題

這份常見問題文件涵蓋與快速配對相關的常見問題。

工具與整合

本節將介紹「快速配對」規格、工具和整合測試。

快速配對規格

驗證器應用程式

裝置行為

裝置控制台

認證

本節將說明認證程序的常見問題。

準備

自我測試

裝置認證

認證後

一般問題

針對特定裝置類型和快速配對版本，我必須實作哪些功能？

必要功能頁面會定義特定裝置類型和快速配對修訂版本所需的必要功能。合作夥伴可以申請豁免， 我們會依個案情況審查。

我應該使用 GATT 韌體修訂特徵或訊息串流，實作韌體版本嗎？

快速配對功能可透過標準藍牙 SIG GATT 韌體修訂特徵或快速配對訊息串流：韌體版本回報韌體版本，但我們強烈建議實作 GATT 韌體修訂特徵 (或兩者)。透過 GATT，Seeker 可以在最早階段讀取韌體版本，也就是在透過現有 GATT 連線完成配對後立即讀取。如果只依賴「訊息串流」，韌體版本擷取作業就會延遲，直到藍牙設定檔和「訊息串流」連線完全建立為止。

快速配對是否與特定功能 (例如 LE Audio) 整合？

Google 會持續在快速配對中整合新功能。如要瞭解特定要求，請洽詢系統整合合作夥伴或 Google 聯絡人。

如何判斷專案 (而非模型 ID) 是否有效？

專案狀態會顯示在裝置控制台的專案頁面中。

閒置專案會顯示這個圖示： alt_text

有效專案會顯示這個圖示： alt_text

如何判斷裝置的型號 ID 是否有效？

如果尚未註冊裝置，請按照型號 ID 頁面的說明，將裝置註冊至 Google Cloud 專案。

模型 ID 會在認證後完全啟用，並在裝置控制台的裝置頁面上顯示這個按鈕：

如果裝置沒有型號 ID，裝置控制台的裝置頁面會顯示這個按鈕：

使用「核准」按鈕提交草稿後，裝置就會獲得模型 ID。裝置由 Google 指派「待處理」狀態後，即可使用此模型 ID 進行整合和測試，但必須先通過認證程序，才能用於最終產品。

如要查看裝置的型號 ID，請前往裝置控制台的裝置頁面：

如何在裝置上使用驗證器應用程式？

合作夥伴必須建立 Google 帳戶，並由裝置控制台管理員將帳戶新增至裝置控制台專案，才能將測試結果上傳至裝置控制台。

如需特定用途，請參閱驗證器應用程式使用者手冊。

如何排解訊息解密失敗的問題？

這類問題通常是由於 HW 加密區塊發生問題所致。請嘗試檢測裝置，查看引擎輸入、輸出內容和 API 呼叫。現有的 加密測試案例有助於排解問題。

嘗試下載隨附應用程式時，錯誤代碼 DF-DFERH-01 代表什麼意思？

這通常是由於套件名稱前有空白字元所致。

確認裝置控制台中的套件名稱沒有開頭空白字元。

如何在裝置通過認證前，查看裝置上的半頁和通知？

只有在裝置上啟用偵錯通知時，才會顯示未通過認證的裝置廣告 (和通知)。

如要啟用偵錯通知，請按照下列步驟操作：

  1. 依序點選「設定」>「應用程式和通知」>「Google Play 服務」>「通知」
  2. 依序前往「設定」>「Google」>「裝置和共用」(或「裝置連線」) >「裝置」> 3 點圖示 >「包含偵錯結果」

為什麼第 2 部裝置未顯示後續配對通知？

這項資訊最多可能需要幾小時才能與裝置同步。

如要強制手動同步處理，請按照下列步驟操作：

  1. 依序前往「設定」>「Google」>「裝置和共用」>「裝置」。
  2. 在「已儲存的裝置」下方選取裝置。
  3. 選擇對應的 Google 帳戶。

清單中現在應該會顯示已配對的耳機。

為什麼裝置停止顯示半頁通知？

按一下「關閉」按鈕關閉半頁面通知後，系統會暫時停止顯示通知 5 分鐘。如要強制重新顯示半張紙，請採取下列任一做法：

  • 等待五 (5) 分鐘，讓半張紙重新啟用。
  • 重新啟動手機。

short time banned 是什麼意思？

錯誤報告記錄中顯示的 short time banned 狀態，是指使用者點選「關閉」按鈕，關閉同一個半螢幕通知。這會導致該半張紙的後續例項在接下來 5 分鐘內遭到抑制。

如要強制重新顯示半張紙，請採取下列任一做法：

  • 等待五 (5) 分鐘，讓半張紙重新啟用。
  • 重新啟動手機。

哪裡可以找到模型 ID 防偽金鑰？

只有在裝置控制台中註冊的專案才能查看金鑰。

在配對模式中，我可以使用裝置的公用位址來放送廣告，而不是 RPA 嗎？

一般來說，不會。

Google 不會測試這類用途，因此可能會導致非預期的行為。

如要申請這項服務，合作夥伴至少須：

  1. 對所有功能執行完整自我測試，驗證實作結果。
  2. 向 Google 申請免除。

我們可能會視情況核准豁免。

為什麼當裝置的隨附應用程式已在前台開啟時，裝置上不會顯示快速配對半頁？

當「快速配對」偵測到隨附應用程式 (由 Nearby 控制台內這個特定裝置的「隨附應用程式套件名稱」識別) 已在前台運作時，系統會隱藏「快速配對」半頁畫面。這項措施可避免重複通知。

舉例來說，如果使用者在行動裝置上啟動耳機的隨附應用程式，系統就不會顯示快速配對半頁。

為什麼我無法在裝置控制台中建立專案？

您必須擁有 Google 帳戶，才能建立專案。您可以將非 Google 電子郵件地址與 Google 帳戶建立關聯。

這個問題也會顯示「Request had insufficient authentication scopes」(要求驗證範圍不足) 錯誤訊息。

我是否必須向 Bluetooth SIG 註冊公司名稱？

是，在裝置控制台中建立的每部新裝置，都必須向 Bluetooth SIG 註冊公司名稱。

如何手動將資料上傳至裝置控制台？

合作夥伴必須先建立 Google 帳戶並加入快速配對測試群組，才能手動將測試結果上傳至裝置控制台。

使用驗證器應用程式的合作夥伴，請按照「設定驗證器應用程式」一節的說明操作。

  • 合作夥伴必須建立 Google 帳戶。
  • 建立帳戶後，請將其新增至「快速配對測試群組」。
  • 在裝置上登入這個 Google 帳戶。
  • 在測試裝置上啟用「使用狀況與診斷」：
    • 依序輕觸「設定」>「Google」> 三點圖示 >「使用狀況與診斷」> 開啟「使用狀況與診斷」

alt_text

裝置控制台的變更項目需要多久時間才能同步到特定裝置？

25 小時。

如何強制將裝置控制台變更同步至裝置？

每部裝置每天都會重新整理本機快取。如要強制重新整理快取，請採取下列任一做法：

  1. 變更系統語言：
    • 依序前往「設定」>「系統」>「語言與輸入設定」>「語言」。
      • 如果是較舊的 Android 版本，請依序前往「設定」>「系統」>「語言」>「系統語言」。
    • 將系統語言變更為其他語言。
  2. 將系統時鐘提前 25 小時。

許多裝置控制台設定 (例如 TxPower) 都存在於裝置的快取中。

如何將自我測試資料上傳至裝置控制台？

合作夥伴必須按照驗證器應用程式和手動測試路徑，將自測資料上傳至裝置控制台。這些路徑日後可能會合併。

驗證器應用程式涵蓋提交校正和端對端 (E2E) 測試結果，而手動測試則涵蓋後續配對、距離測試和擴充功能。這兩種路徑都能上傳初始配對結果。

如要上傳驗證器應用程式資料，請按照下列步驟操作：

  1. 請確認已按照「驗證工具應用程式設定」一文中的所有步驟操作。
  2. 在所有測試期間，請確保裝置連上網際網路。
  3. 測試完成後，請按一下「提交」按鈕。

如要上傳手動測試資料，請按照下列步驟操作：

  1. 填妥「傳統藍牙」或「LE Audio」自我測試報告表單中列出的所有手動測試欄位。
    1. 部分擴充功能 (例如「音訊自動切換」) 具有額外的自我測試報告 (BT Classic 或 BT LE Audio)。
  2. 將所有自我測試報告提交給 SI 合作夥伴或客戶經理。
  3. 請將裝置連上網路：
    1. 所有測試的持續時間。
    2. 測試完成後 25 小時。
      1. 請確認手機已接上電源，以免上傳過程中斷電。

將樣品送交認證前，需要採取哪些行動？

  1. 請確認您已按照「驗證工具應用程式」和「手動測試」設定答案中的所有步驟操作。
  2. 請按照「認證程序 - 準備認證」頁面上的指示操作。

如何測試 LE Audio 耳機的帳戶金鑰追溯寫入功能？

藍牙堆疊會處理設定檔連線。測試應著重於驗證是否成功回溯配對，無論手機的 LE 音訊切換設定為何。

如果配對後「LE Audio」切換鈕為「關閉」，請在「關閉」欄中記錄結果，並將「開啟」欄標示為「不適用」，反之亦然。

如何提交韌體以取得認證核准？

韌體管理機制的首要目標，是將快速配對功能連結至特定且經過驗證的供應商韌體版本。為確保符合規定，合作夥伴必須使用 Fast Pair 驗證器應用程式，將認證候選韌體版本提交至裝置管理中心，並通過所有必要測試案例。詳情請參閱韌體管理功能認證指南附件。

認證時必須送交多少個樣品？

必須將三 (3) 個樣品送交第三方認證實驗室。如需特定實驗室的聯絡資訊，請參閱「將裝置運送至第三方實驗室」頁面。

Google 可能會視需要要求快速配對合作夥伴將樣品寄給 Google。如需 Google 的運送資訊，請參閱「將裝置運送給 Google」頁面。

如何管理樣機的國際運送？

各第三方實驗室管理國際運送、進口稅和程序的流程各不相同。您必須與實驗室協調這個程序。

如需特定實驗室的聯絡資訊，請參閱「將裝置運送至第三方實驗室」頁面。這項規定也適用於運送至 Google 的裝置。

  1. 註冊合作夥伴帳戶。
  2. 在產品行銷流程頁面中查看相關程序。
  3. 請參閱「快速配對標誌指南」頁面。
  4. 製作包裝和行銷宣傳品。
  5. 在「素材資源核准」分頁中提交設計，以供行銷審查。

合作夥伴是否需要在測試前預先提交任何裝置資料？

不會。

提交給 Google 前，請先在自我測試報告中輸入所有必要詳細資料，例如型號 ID 和韌體版本。

我可以在自測報告中使用所有相同的手機和 Android 版本嗎？

不會。

除了裝置外，您還必須使用三 (3) 支不同品牌的手機，且這些手機必須執行不同的 Android 版本。三部手機中必須有一部是 Pixel 手機。

您不一定要使用自測報告中列出的確切手機和 Android 版本號碼。

如何手動測量配對時間？

配對時間的計算方式如下：

  1. 輕觸 UI 中的「配對」按鈕。
  2. 手機顯示「配對成功」UI 時。

如何管理僅顏色不同的裝置的自我測試？

  1. 對單一機型執行完整自我測試。
  2. 在所有其他型號上執行驗證工具應用程式，並確認通過驗證。

Speakers 必須測試及導入哪些功能？

如需功能需求，請參閱規格。

後續配對測試是否需要手機 A 忘記 DUT？

不會。

後續配對的自我測試不需要手機 A 忘記 DUT，然後重新執行初始配對。舉例來說，在執行 30 次後續配對的自測時，只有手機 B 需要忘記 DUT。

我可以使用哪種裝置 (EVT、DVT、PVT、已發布) 進行自我測試和認證？

裝置必須至少達到設計驗證測試 (DVT) 級別。

一般而言，在自測或認證後進行任何軟體或韌體變更，都需要重新測試。詳情請參閱「認證門檻」一節。

合作夥伴如何為通過認證的同一裝置指定不同顏色版本？

合作夥伴可透過裝置控制台的「系列」功能，為這個確切情境指定裝置系列。

合作夥伴可自行決定命名慣例。一般慣例是在產品名稱中加入後置字串，指出顏色 (例如「_green」)。

如何查看 Google 核發的認證票券？

如要存取 Google 的專案追蹤元件，必須擁有 Google 合作夥伴網域帳戶 (PDA)。您的系統整合合作夥伴應有 PDA，可查看這些勾號並提供狀態更新。

如果沒有 SI，請與 Google 合作夥伴聯絡，尋求製作 PDA 的協助。

完成自我測試後，Google 核發的認證票證有什麼用途？

合作夥伴需要使用這張票證完成下列事項：

  1. 向 Google 說明您打算使用的第三方實驗室。
  2. 直接向第三方實驗室提供支援單號碼。

認證時是否必須使用與自測相同的軟體和韌體版本？

是。

一般而言，在自測或認證後進行任何軟體或韌體變更，都需要重新測試。詳情請參閱「認證門檻」一節。

如何在裝置控制台中管理類似產品群組？

凡是共用相同產品圖片、名稱、軟體和韌體版本的產品群組，都可以在裝置管理中心中新增為「系列」。

每部裝置都必須有一個項目。

這個群組中只要有一部裝置通過認證，系列中的所有其他裝置就會獲得核准。更新裝置軟體或韌體時，只需向 Google 提交一份自我測試報告。

如何與第三方實驗室分享任何自訂測試步驟？

一般來說，合作夥伴不需要為「快速配對」認證實作自訂測試步驟。依賴自訂步驟可能會違反快速配對標準，並導致裝置效能下降。

如有任何自訂步驟或特殊需求，請在專案提案階段與 Google 討論。

為什麼在玩遊戲時，供應商的音訊自動切換狀態不會顯示 CONNECTED_A2DP_ONLY？

這是 Seeker 造成的已知問題，與遊戲音訊切換錯誤有關。在玩遊戲時，Samsung 手機會將連線狀態設為 CONNECTED_A2DP_WITH_AVRCP，而不是 CONNECTED_A2DP_ONLY。

詳情請參閱「音訊切換認證已知問題」一節。

我必須在什麼情況下重新認證裝置或軟體？

即使未修改快速配對程式碼，任何軟體或韌體變更都必須提交自我測試報告。

一般來說，在下列情況下，您需要完成完整重新認證程序：

  • 發布含有全新快速配對功能的二進位檔。
    • 新功能必須通過第三方實驗室認證，現有功能則可透過自我測試報告驗證。
  • 發布已移除快速配對功能的二進位檔。
  • 變更實作的快速配對版本 (例如 3.0 -> 3.1)。
    • 部分版本變更可能需要額外認證。
      • 舉例來說，3.1 -> 3.2 需要音訊自動切換認證。
  • 在新硬體上發布二進位檔，尤其是使用新天線時。

您的系統整合商或 Google 聯絡人可針對特定情況提供最佳指引， 包括申請豁免或免除。

認證後進行軟體和韌體更新時，需要進行哪些測試？

認證後，如要更新軟體和韌體，必須符合下列條件：

  1. 執行自我測試。
  2. 將居家檢測結果提交給 Google。
  3. 通過驗證器應用程式端對端整合測試。

如要導入新的快速配對擴充功能或變更快速配對版本，必須取得額外認證，詳情請參閱認證門檻一節。

韌體更新的自我測試報告應寄到何處？

如要瞭解 SI 合作夥伴的流程，請與他們聯絡。

如果沒有 SI 合作夥伴，請將自測報告傳送給自測報告審查團隊。

如果裝置只有微小差異 (例如顏色)，是否必須建立不同的型號 ID？

可以。凡是實體外觀不同的裝置，都必須提供新的型號 ID。「類似產品」答案提供了一些命名慣例建議。

如何將裝置新增至支援的晶片組頁面？

晶片組通過認證後，支援的晶片組頁面就會更新。在下列情況下，系統會將新晶片組新增至清單：

  1. 開發板通過認證。
  2. 使用晶片的產品通過認證。