刪除雲端和 Matter 裝置

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

SYNC 需求條件

為避免 Home Graph 上出現重複項目，合作夥伴的雲端必須在傳送給 Google 的 SYNC 回應中，為每部裝置傳送三個新的字串欄位。這些欄位必須與 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 時簡化。