刪除雲端和 Matter 裝置

將目前使用 (Cloud-to-cloud) 的裝置轉換為 Matter 時，您必須確保裝置在透過非 Matter API 連線時使用的 Matter 上使用相同的 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 主畫面中的專屬部分，位於任何會議室外的名為「LinkedIn」部分。系統不會刪除這類裝置上的重複資料。使用者在 GHA 中有多個結構 (住家) 時，系統不會自動將裝置放置在結構中。裝置可能基於其他原因而無法建構。

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