云到云和 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 - 此设备所在的房间。

如需关于 intent(例如 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 设备,合作伙伴的云必须立即向 Google 发送 REQUEST SYNC,以尽快更新这些字段,以免重复数据删除。

这些字符串一旦提供给给定设备,就不能再更改。唯一 ID 应在恢复出厂设置后更改,这样一来,设备将作为全新的设备显示在所有集成中。

自动结构关联

不能保证 Cloud-to-cloud 设备与特定结构自动关联。如果无法实现自动结构关联,相关 Cloud-to-cloud 设备将显示在 GHA 主屏幕的专用部分(位于标题为已与您关联的章节中,且位于房间外)。此类设备不会被删除重复信息。当用户的 GHA 中有多个结构(住宅)时,设备不会自动置于结构中。设备可能会因其他原因而无法结构化。

如果用户将未通过自动结构关联的 Cloud-to-cloud 设备手动移至结构中,只要 SYNC 响应符合 SYNC 要求中所述的要求,就可能在下一个 SYNC 执行重复信息删除。