建立中
確認您的手機相容
所有 Android O (8.1，API 級別 27) 以上版本的裝置均與 Matter 相容。請按照下列步驟操作，檢查手機是否具備必要的模組。
設定 Android Debug Bridge
進行疑難排解前，應先設定 Android Debug Bridge (adb)。會議前置作業：
- 在電腦上安裝「ADB」。
- 請在 Android 手機上開啟「開發人員選項」和「USB 偵錯」。
驗證 Google Play 服務 (GPS) 模組
如要確認您是否有 Google Play services Matter 模組，請按照下列步驟操作：
- 設定 Android Debug Bridge。
- 使用 USB 傳輸線將 Android 手機連接至電腦。
- 在終端機中執行這個指令，確認已安裝必要的 Matter 模組：
如果看到類似下列的輸出內容，表示已安裝 Matter 模組：adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"com.google.android.gms.home [v222110900]
請注意，上述版本號碼可能與您的裝置不同。 - 在終端機中執行這個指令，確認已安裝必要的 Thread 模組：
如果您看到類似以下範例的輸出內容，表示已安裝 Thread 模組：adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"com.google.android.gms.threadnetwork [v222106301]
請注意，裝置的版本號碼可能不同。
如果模組不在清單中，表示：
- 你的 Android 版本過舊。請確認其為 Android O (8.1) 以上版本。
- 尚未下載 Matter 模組。請等待至少 24 小時讓系統完成下載作業。請確保裝置在這段期間內處於開機狀態，而且正在充電，以免下載作業延遲。如果您沒有在 24 小時內收到模組，可以嘗試將裝置恢復原廠設定，強制下載模組。
Fuchsia 中樞裝置記錄
如何啟用本機記錄檔擷取中樞：
- 將你的裝置序號和型號，透過電子郵件傳送至你的 Google Technical Account Manager (TAM)。您可以在裝置底下使用細小的字母找到。
- 加入許可清單後，您必須按照下列步驟啟用這項功能：
- 從 Hub 載入：
- 從畫面頂端向下滑動。
- 輕觸「設定」圖示 。
- 尋找 Fuchsia 版本：在 Google Nest Hub (2nd gen) 上，依序前往「Device information」>「Technical information」>「Fchsia Version」。
- 輕觸「Fuchsia 版本」7 次。這樣就能啟用開發人員選項
- 返回頂層選單
- 輕觸「開發人員選項」
- 輕觸「合作夥伴記錄」
- 這項功能將啟用 24 小時。之後，請在步驟 5 時重新啟用記錄功能。
- 從 Hub 載入：
- 取得中樞的 IP 位址：
- 如果中心含有畫面，請執行下列操作：
- 從畫面頂端向下滑動。
- 輕觸「設定」圖示 。
- 找出裝置 IP 位址：在 Nest Hub (2nd gen) 上，依序前往「裝置資訊」>「技術資訊」>「IP 位址」。
- 來自手機的 Google Home app (GHA)：
- 輕觸裝置以顯示裝置詳細資料頁面
- 輕按「設定」圖示 ，開啟設定頁面
- 找出裝置 IP 位址：依序前往「Device information」>「Technical information」>「IP address」。
- 如果中心含有畫面，請執行下列操作：
- 如要從中樞擷取記錄，請使用相同 Wi-Fi 網路的電腦，向中樞裝置發出 GET HTTP 要求。
- 記下端點的通訊埠和路徑：
curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file - 連線只能保持開啟一分鐘，但從緩衝區擷取的資料通常會有 20 到 30 分鐘的過去事件。
- 在理想情況下，完成測試程序後，會立即使用這個方法擷取記錄，確保緩衝區包含與測試相關的內容 (類似 Android 錯誤報告)。
- 記下端點的通訊埠和路徑：
停用 Android 記錄遮蓋功能
- 為保障隱私權與安全性，這項功能僅供工程測試之用。
- 請勿在正式版裝置或使用者使用這個選項。
- 步驟：
- 將含有未遮蓋記錄的使用者 Google 帳戶傳送至 Google TAM。
- 確認帳戶已加入許可清單後，請重新啟動手機。
驗證裝置的 VID/PID
如要開始開發與 Google 的整合作業，您必須在 Google Home 控制台建立專案並整合項目。
裝置信標的 VID/PID 值應與在 Google Home Developer Console 專案中輸入的 VID/PID 相符。
使用藍牙工程應用程式 (例如 nRF Connect for Mobile) 時，您可以在「Service Data」欄位中看到信標裝置的 VID/PID。
在 nRF Connect Android 版本的螢幕截圖中，您會看到 VID/PID 從「Service Data」欄位的第四個位元組開始列為 5A23FFFE。這表示 VID 為 5A23 以及 FFFE 的 PID，兩者皆使用小端序格式。
BLE 應用程式會以簡單的結尾顯示值，但您在 Developer Console 專案中輸入的 VID/PID 值是以大端序顯示。
請檢查根據藍牙探測器所顯示的內容，確認已將正確的值與格式輸入至 Actions 主控台。
以螢幕截圖中的值為例，Developer Console 中的 VID 和 PID 分別為 235A 和 FEFF。
確認裝置是以相容的 Matter SDK 分支版本建構
Google Matter 中樞與 Matter 1.0 相容，並且已測試使用穩定分支版本 v1.0-branch 中修訂版本的建構。請查看公開版本資訊，瞭解建議與每個新中心版本搭配使用的特定修訂版本。
配對中
驗證裝置憑證
使用自行指派 Alliance 的 VID 時，請確保裝置上有正確的憑證：
- 認證聲明 (CD)。
- 裝置認證憑證 (DAC) 及其憑證鏈結。
詳情請參閱「建立 Matter 裝置測試憑證」。
確認與 Matter 相容的中樞裝置
您的 Matter 中樞必須是 Google 支援的中心。而且必須位於與 Matter 相容的版本上。
部分中樞裝置也是 Thread 邊界路由器，因此可讓您開發及測試 Thread 裝置。其他中樞裝置僅支援 Wi-Fi 和乙太網路 Matter 裝置，除非網路中已有其他邊界路由器，才能啟用 Thread 連線。
您可以透過下列方式驗證 Hub 版本：將手指從頂部邊緣往下滑動 > 設定滾輪 > 裝置資訊 > 技術資訊 > Chromecast 韌體版本
調試失敗，並顯示「無法聯絡 Google」錯誤訊息
請確認您已在 Developer Console 中使用正確的 VID/PID 組合建立整合作業。詳情請參閱「建立 Matter 整合」一文。
調試失敗，並顯示「無法連線至裝置」錯誤訊息
如果執行 Thread 裝置時仍持續收到「無法連線至裝置」錯誤訊息，而且已用完所有可用偵錯選項，建議您前往「設定」>「應用程式」>「應用程式應用程式」>「Google Play 服務」>「儲存空間和快取」>「清除所有資料」，清除 Android 手機上儲存的偏好 Thread 憑證，以便進行簡潔設定。
測試
測試套件未顯示調試的裝置
如果您已將某部裝置與測試供應商 ID (VID) 和產品 ID (PID) 配對，但在 Developer Console 中嘗試透過測試套件測試裝置時卻未顯示，這可能是因為在多項整合項目中使用相同的測試 VID 和 PID 組合。
如要排解問題，請從 Developer Console 移除所有測試裝置，然後重新配對要測試的裝置。
如要驗證是否已配對正確，您可以將裝置的製造商和型號資訊 (CHIP_DEVICE_CONFIG_DEVICE_* 值) 設為測試韌體中的不重複值。
詳情請參閱「裝置資訊」一文。
如果還是有問題
如果採取這裡的所有疑難排解步驟後仍無法解決問題，也沒有問題！
在疑難排解步驟中，您收集了有關裝置、主控台專案和環境的重要資料。取得這些資料後，請查看支援頁面，瞭解如何以最佳方式與社群和 Google Home 支援團隊分享您的問題。