将当前使用 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
:
matterUniqueId
- 字符串格式的UniqueId
属性。matterOriginalVendorId
-VendorId
属性,采用十六进制字符串格式。matterOriginalProductId
-ProductId
属性,采用十六进制字符串格式。roomHint
- 此设备所在的房间。
您可以在 Cloud-to-Cloud 入门指南中找到关于 SYNC
等 intent 的文档。
下面的 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
时发生重复信息删除。