本常見問題說明與 Fast-Pair 相關的常見問題。
工具和整合
本節將介紹快速配對規格、工具和整合測試。
快速配對規格
- 針對特定裝置類型和快速配對版本,我必須實作哪些功能?
- 快速配對功能是否與特定功能 (例如 LE Audio) 整合?
- 如何得知專案 (而非模型 ID) 是否處於啟用狀態?
- 如何判斷裝置的型號 ID 是否處於啟用狀態?
Validator 應用程式
裝置行為
- 如何在裝置通過認證前,在裝置上查看半頁和通知?
- 為什麼後續配對通知不會顯示在第 2 部裝置上?
- 為什麼裝置停止顯示半頁通知?
short time banned
是什麼意思?- 哪裡可以找到型號 ID 防偽金鑰?
- 我可以在配對模式中使用裝置的公開位址進行廣告放送,而非 RPA 嗎?
裝置控制台
- 為什麼我無法在裝置控制台中建立專案?
- 我是否必須向 Bluetooth SIG 註冊公司名稱?
- 如何手動將資料上傳至裝置控制台?
- 裝置控制台中的變更需要多久時間才能同步至特定裝置?
- 如何強制將裝置控制台的變更同步至裝置?
- 如何將自檢測資料上傳至裝置控制台?
認證
本節將說明認證程序的常見問題。
準備
自我測試
- 合作夥伴是否需要在測試前先行提交任何裝置資料?
- 我可以在自檢測報告中使用相同的手機和 Android 版本嗎?
- 如何手動測量配對時間?
- 如何管理僅有顏色差異的裝置自測功能?
- 「喇叭」應用程式需要測試及實作哪些功能?
- 後續配對測試是否需要 Phone A 忘記 DUT?
裝置認證
- 我可以使用哪種裝置 (EVT、DVT、PVT、已發布) 進行自測和認證?
- 合作夥伴如何為同一部裝置指定不同顏色的版本,以便進行認證?
- 如何查看 Google 發出的認證支援單?
- 完成自測後,Google 會發出認證申請單,我該如何處理?
- 是否必須使用進行自測的軟體和韌體版本進行認證?
- 如何在裝置控制台中管理一組相似的產品?
- 如何將自訂測試步驟分享給第三方實驗室?
認證後
一般問題
針對特定裝置類型和快速配對版本,我必須實作哪些功能?
必要功能頁面會定義特定裝置類型和快速配對修訂版本所需的功能。合作夥伴可以申請豁免,我們會依個案情況審查。
快速配對功能是否與特定功能 (例如 LE Audio) 整合?
Google 會持續在快速配對功能中整合新功能和能力。請洽詢 SI 合作夥伴或 Google 聯絡窗口,進一步瞭解特定要求。
如何得知專案 (而非模型 ID) 是否處於有效狀態?
裝置控制台中的專案頁面會顯示專案狀態圖示。
閒置專案會顯示以下圖示:
有效專案會顯示以下圖示:
如何判斷裝置的型號 ID 是否處於啟用狀態?
如果尚未完成,請確認裝置已在 Google Cloud 專案中註冊,如型號 ID 頁面所述。
模型 ID 會在認證後全面啟用,並在裝置控制台的裝置頁面上顯示這個按鈕:
在裝置控制台中,沒有型號 ID 的裝置頁面會顯示這個按鈕:
使用「核准」按鈕提交草稿後,裝置就會指派模型 ID。當 Google 將裝置指派為「待處理」狀態時,這個型號 ID 就適合用於整合和測試,但必須經過認證程序才能完全啟用,才能與最終產品搭配使用。
您可以在 裝置控制台的裝置頁面中找到裝置的型號 ID:
如何在裝置上使用驗證工具應用程式?
合作夥伴必須建立 Google 帳戶,並由 Device Console 管理員將該帳戶新增至 Device Console 專案,才能將測試結果上傳至 Device Console。
- 合作夥伴必須建立 Google 帳戶。
- Google 帳戶可以連結非 Gmail 地址。
- 建立帳戶後,請讓合作夥伴的 Device Console 管理員將帳戶電子郵件地址新增至正確的 Device Console 專案。
- 在裝置上登入這個 Google 帳戶。
驗證器應用程式使用者手冊會說明特定用途。
如何排解訊息解密失敗的問題?
這些問題通常是因為硬體加密區塊發生問題。請嘗試檢測裝置,查看引擎輸入內容、輸出內容和 API 呼叫。現有的加密測試案例或許有助於排解問題。
嘗試下載隨附應用程式時,錯誤代碼 DF-DFERH-01
代表什麼?
這通常是因為套件名稱前方有空白字元。
請確認 Device Console 中的套件名稱沒有開頭空白。
如何在裝置通過認證前,在裝置上查看半頁和通知?
只有在裝置上啟用偵錯通知時,才會顯示未認證的裝置廣告 (和通知)。
如要啟用偵錯通知功能,請按照下列步驟操作:
- 依序前往「設定」>「應用程式和通知」>「Google Play 服務」>「通知」
- 「設定」>「Google」>「裝置和共用」(或「裝置連線」) >「裝置」>「3 點」>「包含偵錯結果」
為什麼後續配對通知不會顯示在第 2 部裝置上?
這項資訊最多可能需要幾小時才能同步至裝置。
如何強制手動同步處理:
- 依序前往「設定」>「Google」>「裝置和共用」>「裝置」。
- 選取「已儲存的裝置」下方的裝置。
- 選擇對應的 Google 帳戶。
已配對的耳機現在應該會顯示在清單中。
為什麼裝置停止顯示半頁通知?
半頁通知會在遭到略過兩次後,隱藏 5 分鐘。如要強制讓半頁重新顯示,請執行下列任一操作:
- 請等待五 (5) 分鐘,讓系統重新啟用半頁面。
- 重新啟動手機。
short time banned
是什麼意思?
當同一個半頁通知在同一行中關閉兩次時,就會出現 short time banned
狀態,這會顯示在錯誤報告記錄中。這會導致未來 5 分鐘內,該半版面的後續例項遭到抑制。
如要強制讓半頁重新顯示,請執行下列任一操作:
- 請等待五 (5) 分鐘,讓系統重新啟用半頁面。
- 重新啟動手機。
哪裡可以找到模型 ID 防偽造金鑰?
只有在 Device Console 中註冊的專案,才能看到這些鍵。
在配對模式中,我可以使用裝置的公開位址 (而非 RPA) 放送廣告嗎?
一般來說不會。
Google 並未測試這類用途,因此可能會導致不良行為。
如要申請這項計畫,合作夥伴至少需要:
- 對所有功能執行完整的自我測試,驗證實作結果。
- 向 Google 申請豁免。
我們會視個別情況核准豁免。
為什麼無法在裝置控制台中建立專案?
您必須擁有 Google 帳戶才能建立專案。您可以將非 Google 電子郵件地址與 Google 帳戶建立關聯。
這個問題也會顯示「要求的驗證範圍不足」錯誤訊息。
我是否需要向 Bluetooth SIG 註冊公司名稱?
是的。在裝置主控台中建立的每部新裝置,都必須具備已向 Bluetooth SIG 註冊的公司名稱。
如何手動上傳資料到 Device Console?
合作夥伴必須建立 Google 帳戶,並將帳戶新增至 Fast Pair 測試群組,才能手動將測試結果上傳至 裝置控制台。
使用驗證應用程式的合作夥伴應按照「驗證應用程式設定」一節中的操作說明進行。
- 合作夥伴必須建立 Google 帳戶。
- Google 帳戶可以連結非 Gmail 地址。
- 建立帳戶後,請將該帳戶加入快速配對測試群組。
- 在裝置上登入這個 Google 帳戶。
- 在測試裝置上啟用「使用狀況與診斷」:
- 「設定」>「Google」> 3 點圖示 >「使用狀況與診斷」> 開啟「使用狀況與診斷」
裝置控制台中的變更需要多久才能同步至特定裝置?
25 小時。
如何強制將裝置控制台的變更同步至裝置?
每部裝置每天會重新整理一次本機快取。如要強制快取重新整理,請執行下列任一操作:
- 變更系統語言:
- 依序前往「設定」>「系統」>「語言與輸入設定」>「語言」。
- 較舊的 Android 版本可能會使用「設定」>「系統」>「語言」>「系統語言」。
- 將系統變更為任何其他語言。
- 依序前往「設定」>「系統」>「語言與輸入設定」>「語言」。
- 將系統時鐘快轉 25 小時。
許多裝置控制台設定 (例如 TxPower) 都位於裝置快取中。
如何將自測試資料上傳至裝置控制台?
合作夥伴必須同時遵循驗證應用程式和手動測試的步驟,才能將自測資料上傳至裝置控制台。這些路徑日後可能會合併。
驗證器應用程式涵蓋提交校正和端對端 (E2E) 測試結果,而手動測試涵蓋後續配對、距離測試和擴充功能。兩種路徑都能上傳初始配對結果。
如何上傳驗證器應用程式資料:
- 請確認您已按照驗證器應用程式設定問題的回答中列出的所有步驟操作。
- 在進行所有測試期間,請保持裝置連上網際網路。
- 測試完成後,請按一下提交按鈕。
如何上傳手動測試資料:
- 填妥 BT Classic 或 BT LE Audio 自助測試報告表單中列出的所有手動測試欄位。
- 部分擴充功能 (例如音訊切換器) 會提供額外的自檢測報表 (BT Classic 或 BT LE Audio)。
- 將所有自測報告提交給 SI 合作夥伴或客戶經理。
- 請保持裝置連線至網路,以便:
- 所有測試的時間長度。
- 測試完成後 25 小時。
- 請務必將手機接上電源,以免在上傳過程中耗盡電力。
寄送樣品進行認證前,我需要採取哪些行動?
需要寄送多少個樣本才能取得認證?
必須將三 (3) 個樣品送交第三方認證實驗室。如要瞭解特定實驗室的聯絡資訊,請參閱「將裝置運送至第三方實驗室」頁面。
Google 可能會要求快速配對合作夥伴視需要將樣本傳送給 Google。如需 Google 的運送資訊,請參閱「將裝置寄送給 Google」頁面。
如何管理樣品裝置的國際運送作業?
每個第三方實驗室都有獨特的程序來管理國際運送、進口關稅和程序。您必須與研究室協調這個程序。
如要瞭解特定實驗室的聯絡資訊,請參閱「將裝置運送至第三方實驗室」頁面。同樣適用於運送至 Google 的所有裝置。
如何取得官方核准,以便將快速配對功能用於產品行銷?
合作夥伴是否需要在測試前先提交任何裝置資料?
不會。
請先在自檢測報告中輸入所有必要詳細資料 (例如機型 ID 和 FW 版本),再提交給 Google。
我可以在自檢測報告中使用相同的手機和 Android 版本嗎?
不會。
除了您的裝置外,您必須使用三 (3) 款不同品牌的手機,且執行不同 Android 版本。三 (3) 支手機中必須有一 (1) 支是 Pixel 手機。
您不必使用自測報告中列出的確切手機和 Android 版本號碼。
如何手動測量配對時間?
配對時間的計算方式如下:
- 使用者在 UI 上輕觸「配對」按鈕的當下。
- 手機上顯示「配對成功」UI 的瞬間。
如何管理僅有顏色差異的裝置自測?
- 對單一模型執行完整的自我測試。
- 在所有其他模型上執行驗證工具應用程式,並確認這些模型通過驗證。
發言者需要測試及實作哪些功能?
規格中會說明功能需求。
後續配對測試是否需要 Phone A 忘記 DUT?
不會。
後續配對的自我測試不需要手機 A 忘記 DUT,並重新執行初始配對。舉例來說,當您執行 30 次後續配對測試進行自我測試時,只有 Phone B 需要忘記 DUT。
我可以使用哪種裝置 (EVT、DVT、PVT、已發布) 進行自檢測和認證?
裝置必須至少為設計驗證測試 (DVT) 級別。
一般來說,自檢測或認證後的任何軟體或韌體變更都需要進行某種形式的重新測試。詳情請參閱「認證門檻」一節。
合作夥伴如何為同一部裝置指定不同顏色的版本,以便進行認證?
裝置控制台的系列功能可讓合作夥伴針對此具體情況指定裝置系列。
命名慣例則由合作夥伴自行決定。常見的慣例是,在產品名稱中加入表示顏色的後置字串 (例如「_green」)。
如何查看 Google 發出的認證支援單?
如要查看 Google 的專案追蹤元件,您必須擁有 Google 合作夥伴網域帳戶 (PDA)。SI 合作夥伴應有 PDA 可查看這些勾號,並提供最新狀態。
如果沒有 SI,請與 Google 合作夥伴聯絡,以便取得 PDA 製作協助。
完成自主測試後,我該如何處理 Google 發出的認證申請單?
合作夥伴需要針對這張票證執行以下操作:
- 請告知 Google 您打算使用哪個第三方實驗室。
- 請直接將票證號碼提供給第三方實驗室。
是否必須使用進行自測的軟體和韌體版本進行認證?
是。
一般來說,自檢測或認證後的任何軟體或韌體變更都需要進行某種形式的重新測試。詳情請參閱「認證門檻」一節。
如何在裝置控制台中管理一組相似產品?
任何共用相同產品圖像、名稱、軟體和韌體版本的產品群組,都可以在 Device Console 中新增為「系列」。
每部裝置都必須有一個項目。
這個群組中只有一款裝置需要認證,Series 中的所有其他裝置在認證完成後就會獲得核准。更新裝置軟體或韌體時,只需向 Google 提交一份自我測試報告。
如何將自訂測試步驟分享給第三方實驗室?
一般來說,合作夥伴不需要為 Fast Pair 認證實作自訂測試步驟。依賴自訂步驟可能會違反 Fast Pair 標準,並降低裝置效能。
請在專案提案階段與 Google 討論任何自訂步驟或特殊要求。
何時需要重新認證裝置或軟體?
即使未修改快速配對程式碼,任何軟體或韌體變更都必須提交自檢測報告。
一般來說,您需要在下列情況下重新認證:
- 發布含有新快速配對功能的二進位檔。
- 新功能必須經過第三方實驗室認證,現有功能則可透過自測報告進行驗證。
- 發布已移除快速配對功能的二進位檔。
- 變更已導入的快速配對版本 (例如 3.0 -> 3.1)。
- 部分版本變更可能需要額外認證。
- 例如,3.1 -> 3.2 需要音訊切換認證。
- 部分版本變更可能需要額外認證。
- 在新硬體上發布二進位檔,特別是使用新天線。
您的 SI 或 Google 聯絡人可以針對特定情況提供最佳指引,包括豁免或豁免申請。
認證後的軟體和韌體更新需要進行哪些測試?
認證後的軟體和韌體更新必須符合以下條件:
- 執行自我測試。
- 將自檢測試結果提交給 Google。
- 通過驗證工具應用程式端對端整合測試。
如認證門檻一節所述,實作新的快速配對擴充功能或變更快速配對版本,都需要額外認證。
我該將韌體更新的自檢測報告寄到哪裡?
如需詳細資訊,請與 SI 合作夥伴聯絡。
如果沒有 SI 合作夥伴,請將自測報告傳送給自測報告審查團隊。
是否必須為有細微差異 (例如顏色) 的裝置建立不同的型號 ID?
可以。任何具有實體差異的裝置都必須使用新的型號 ID。「類似產品」答案會提供一些命名慣例建議。
如何將裝置新增至「支援的晶片組」頁面?
晶片組通過認證後,支援的晶片組頁面就會更新。當下列任一情況發生時,系統就會將新晶片組加入清單:
- 開發板通過認證。
- 使用該晶片組的產品通過認證。