刪除雲端和 Matter 裝置

將目前使用 (Cloud-to-cloud) 的裝置轉換為 Matter 時,您必須確保裝置在透過非 Matter API 連線時,在 Matter 上使用的 ID。這樣可確保裝置在使用者 Google Home Graph 上只會顯示一次。Cloud-to-cloud 裝置只有在與 Google Home app (GHA) 中的特定結構 (住家) 相關聯時,才能刪除重複的裝置。

SYNC 規定

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

  1. matterUniqueId:字串格式的 UniqueId 屬性。
  2. matterOriginalVendorIdVendorId 屬性,採十六進位字串格式。
  3. matterOriginalProductIdProductId 屬性,採十六進位字串格式。
  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 上執行簡化作業。