刪除雲端和 Matter 裝置

將目前使用 (Cloud-to-cloud) 的裝置轉換為 Matter 時，您必須確保裝置在 Matter 上使用的 ID 與使用非 Matter API 連線時使用的 ID 相同。這樣一來，裝置就只會在使用者的 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 等意圖的說明文件，請參閱雲端到雲端入門指南。

以下 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，以便盡快更新這些欄位，避免發生遲延的去重問題。

這些字串一旦提供給特定裝置，就不得再變更。只有在恢復原廠設定時，才應變更 Unique ID，這會讓裝置在所有整合中顯示為全新裝置。

自動結構關聯

Cloud-to-cloud 裝置無法保證會自動與特定結構體建立關聯。如果無法自動建立結構體關聯，相關的 Cloud-to-cloud 裝置會顯示在 GHA 主畫面的專屬部分，位於標題為「已與你連結」的部分下方，且不在任何房間內。系統不會為這類裝置進行去重。如果使用者在 GHA 中有多個結構體 (住家)，裝置就不會自動放入結構體中。裝置可能會因為其他原因而無法結構化。

如果使用者將自動結構關聯失敗的 Cloud-to-cloud 裝置手動移至結構，只要 SYNC 回應符合「同步處理需求」一節所述的規定，系統就可能在下一次 SYNC 時進行去重作業。