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

如需了解 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 的相关要求中所述的要求。