本頁面由 Cloud Translation API 翻譯而成。

Matter 疑難排解

建築物

確認你的手機是否相容

所有 Android O (8.1，API 級別 27) 以上版本的裝置都與 Matter 相容。請按照下列步驟操作，檢查手機是否已有必要的模組。

設定 Android Debug Bridge

排解問題前，請先設定 Android Debug Bridge (adb)。會議前置作業：

在電腦上安裝「ADB」。
在 Android 手機上開啟開發人員選項和 USB 偵錯功能。

驗證 Google Play 服務 (GPS) Matter 模組

如要確認您是否有 Google Play services Matter 模組，請執行下列步驟：

設定 Android Debug Bridge。
使用 USB 傳輸線將 Android 手機連接到電腦。
在終端機中執行這個指令，確認已安裝必要的 Matter 模組：
```
  adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
  
```
如果輸出內容與下方內容類似，就表示已安裝 Matter 模組：
```
com.google.android.gms.home [v222110900]
```
請注意，上述版本號碼可能與您的裝置不同。
在終端機中執行這個指令，確認已安裝必要的 Thread 模組：
```
  adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
  
```
如果您看到類似以下範例的輸出內容，就表示您已安裝 Thread 模組：
```
com.google.android.gms.threadnetwork [v222106301]
```
請注意，裝置上的版本號碼可能不同。

如果模組不在清單中，表示有以下任一種情況：

你的 Android 版本已過時。請確認其為 Android O (8.1) 以上版本。
尚未下載 Matter 模組。請等待至少 24 小時，讓下載內容。請確保您的裝置處於開機狀態且正在充電，以免下載時間延遲。如果您在 24 小時內仍未收到模組，可以嘗試將裝置恢復原廠設定，強制下載模組。

Fuchsia 中樞裝置記錄

如何為本機記錄擷取啟用中樞：

將含有裝置序號和型號的電子郵件傳送到 Google Technical Account Manager (TAM)。就如裝置底下的小字母所示。
列入許可清單後，請按照下列步驟啟用這項功能：
- 透過中心：
  1. 從畫面頂端向下滑動。
  2. 輕觸「設定」圖示
  3. 找出 Fuchsia 版本：在 Google Nest Hub (2nd gen) 上，依序前往「裝置資訊」>「技術資訊」>「 Fuchsia 版本」。
  4. 輕觸「Fuchsia 版本」7 次。這會啟用開發人員選項
  5. 返回頂層選單
  6. 輕觸「開發人員選項」
  7. 輕觸「合作夥伴記錄」
- 這項功能將啟用 24 小時。之後，請從步驟 5 開始重新啟用記錄功能。
取得中樞的 IP 位址：
- 如果中樞內有螢幕，請嘗試下列操作：
  1. 從畫面頂端向下滑動。
  2. 輕觸「設定」圖示
  3. 找出裝置 IP 位址：在 Nest Hub (2nd gen) 上，依序前往「Device information」(裝置資訊) >「Technical information」(技術資訊) >「IP 位址」(IP 位址)。
- 透過手機使用「Google Home app (GHA)」：
  1. 輕觸裝置，開啟裝置詳細資料頁面
  2. 輕觸「設定」圖示開啟設定頁面
  3. 找出裝置 IP 位址：依序前往「裝置資訊」>「技術資訊」>「IP 位址」
如要從中樞裝置擷取記錄，您需要透過使用相同 Wi-Fi 網路的電腦，向中樞發出 GET HTTP 要求。
- 請記下端點的通訊埠和路徑：
```
curl -k -X GET https://ip-address:8443/setup/get_logs --output output-file
```
- 連線僅可保持開啟一分鐘，但從緩衝區擷取的資料通常需要 20 至 30 分鐘的過往事件。
  - 在理想情況下，完成測試程序後，系統會立即使用此方法擷取記錄，確保緩衝區包含與測試相關的內容 (與 Android 錯誤報告類似)。

停用 Android 記錄遮蓋功能

為了保障隱私權和安全性，這項功能只能用於工程測試目的。
請勿在正式版裝置或使用者中使用這個選項。
步驟：
1. 針對有未遮蓋記錄的使用者，將他們的 Google 帳戶傳送給你的 Google TAM。
2. 確認帳戶已加入許可清單後，請重新啟動手機。

驗證裝置的 VID/PID

如果您想開始開發與 Google 的整合服務，必須在 Google Home 控制台中建立專案和整合功能。

藍牙 Sniffer 疑難排解

裝置信標的 VID/PID 值應與您在 Google Home Developer Console 專案中輸入的 VID/PID 相符。

VID 0xFFF1：0xFFF4 保留用於測試。這些模組可用於基本佣金和控制測試，但在下列開發階段中則無法使用：
- 測試
- 實測
- OTA

使用 nRF Connect for Mobile 等藍牙工程應用程式，您可以在「Service Data」欄位中查看信標裝置的 VID/PID。

在 nRF Connect Android 版本的螢幕截圖中，從「Service Data」欄位的第四個位元組開始，VID/PID 會顯示為 5A23FFFE。這表示 VID 為 5A23 以及 FFFE 的 PID，兩者皆採用小結尾格式。

BLE 應用程式顯示的值以小端序顯示，但您在 Developer Console 專案中輸入的 VID/PID 值是很大的端子。

根據藍牙 Sniffer，驗證是否已在 Actions Console 專案中輸入正確的值和格式。

就範例螢幕截圖中的值而言，Developer Console 中的 VID 和 PID 分別為 235A 和 FEFF。

注意：專案中不應再使用 235A 的 VID，此處僅用於說明。請務必使用 Matter 規格規範的 VID，或是「建立 Matter 整合」頁面所述的其中一個測試 VID。

確認裝置是否使用相容的 Matter SDK 分支版本建構

Google Matter Hub 與 Matter 1.0 相容，而且已針對使用穩定版 v1.0-branch 的修訂版本進行測試。請參閱公開版本資訊，瞭解每個新的中樞版本建議使用的特定修訂版本。

配對中

驗證裝置憑證

使用自己 Alliance 指派的 VID 時，請確保您裝置上具有正確的憑證：

認證聲明 (CD)。
裝置認證憑證 (DAC) 及其憑證鏈結。

詳情請參閱「建立 Matter 裝置測試憑證」。

確認與 Matter 相容的中樞裝置

您的 Matter 中樞必須是 Google 支援的中樞。也必須位於與 Matter 相容的版本上。

部分中樞裝置也是 Thread 邊界路由器，因此可讓您開發及測試 Thread 裝置。除非您的網路有其他邊界路由器，才能啟用 Thread 連線，否則其他中樞裝置僅支援 Wi-Fi 和乙太網路 Matter 裝置。

您可以使用以下方式驗證您的中樞版本：從上邊緣往下滑動 > 設定輪廓 > 裝置資訊 > 技術資訊 > 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 支援團隊分享最佳問題。