刪除雲端和 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. matterUniqueIdUniqueId 屬性,以字串格式表示。
  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 執行去重作業。