刪除雲端和 Matter 裝置

將目前使用 (Cloud-to-cloud) 的裝置轉換為 Matter 時，請務必確保裝置在 Matter 上使用的 ID 與使用非 Matter API 連線時相同。這樣一來，裝置就只會在使用者Google Home Graph上顯示一次。Cloud-to-cloud 裝置必須與 Google Home app (GHA) 中的特定結構 (住家) 建立關聯，才能重複使用。

SYNC 需求條件

為避免 Home Graph 上出現重複項目，合作夥伴的雲端必須針對 SYNC 回應中的每部裝置，向 Google 傳送三個新的字串欄位。這些欄位必須與 Matter 裝置基本資訊叢集中定義的屬性相符。此外，SYNC 回應必須包含 roomHint：

  1. matterUniqueId：字串格式的 UniqueId 屬性。
  2. matterOriginalVendorId：VendorId 屬性，格式為十六進位字串。
  3. matterOriginalProductId：ProductId 屬性，格式為十六進位字串。
  4. roomHint - 裝置所在的會議室。

如需意圖 (例如 SYNC) 的說明文件，請參閱 Cloud-to-Cloud 基礎知識。

以下範例 SYNC 回應顯示了三個新欄位和 roomHint 的用法：

SYNC 回覆 
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "agentUserId": "1836.15267389",
    "devices": [
      {
        "id": "456",
        "type": "action.devices.types.LIGHT",
        "traits": [
          "action.devices.traits.OnOff",
          "action.devices.traits.Brightness",
          "action.devices.traits.ColorSetting",
        ],
        "willReportState": true,
        "roomHint": "office",
        "deviceInfo": { ... },
        "matterUniqueId": "00112233aabbccddeeff",
        "matterOriginalVendorId": "0xfff1",
        "matterOriginalProductId": "0x1234",
        "otherDeviceIds": [
          {
            "deviceId": "local-device-id",
          }
        ]
      }
    ]
  }
}

如果裝置先前是透過合作夥伴的雲端在使用者住家網路運作，現在轉換為 Matter 裝置，合作夥伴的雲端必須立即傳送 REQUEST SYNC 給 Google，盡快更新這些欄位，以免重複資料刪除作業延遲。

為特定裝置提供這些字串後，就絕不能變更。只有在恢復原廠設定時，唯一 ID 才會變更，這會讓所有整合服務將裝置視為全新裝置。

自動關聯結構

Cloud-to-cloud 裝置不一定會自動與特定住家建立關聯。如果無法自動建立結構體關聯，相關Cloud-to-cloud裝置會顯示在GHA主畫面專區的「已連結至你」部分，位於所有房間之外。這類裝置不會重複資料刪除。如果使用者在 GHA 中有多個結構體 (住家)，裝置不會自動歸入結構體。裝置可能因為其他原因而無法完成結構化。

如果使用者將自動結構體關聯失敗的 Cloud-to-cloud 裝置手動移至結構體，只要 SYNC 回應符合「同步處理要求」中註明的規定，系統可能會在下一個 SYNC 執行重複資料刪除作業。