刪除雲端和 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 傳送 以盡快更新這些欄位，以避免延遲。

為裝置提供這些字串後，這些字串不可變更。專屬 ID 只能在恢復原廠設定時變更，讓所有整合服務顯示為全新的裝置。

自動結構關聯

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

如果使用者將無法自動結構關聯的 Cloud-to-cloud 裝置移至結構，只要 SYNC 回應符合「SYNC 需求」所述的要求，簡化作業可能會在下一個 SYNC 發生。