Al convertir un dispositivo que usa actualmente (Cloud-to-cloud) to Matter, you must ensure that the device uses the same ID on Matter that it uses when connected using the non-Matter APIs. Doing so ensures that the device shows just once on the user's Google Home Graph.)
A fin de evitar que se muestren duplicados en Home Graph, la nube del socio debe enviar a Google tres campos de strings nuevos para cada dispositivo en la respuesta SYNC
. Estos campos deben coincidir con los atributos definidos en el clúster de información básica del dispositivo Matter:
matterUniqueId
: Es el atributoUniqueId
en formato de string.matterOriginalVendorId
: Es el atributoVendorId
, en formato de string hexadecimal.matterOriginalProductId
: Es el atributoProductId
, en formato de string hexadecimal.
Puedes encontrar documentación sobre intents como SYNC
en la Guía de Cloud a Cloud.
La respuesta SYNC
de ejemplo a continuación muestra el uso de los tres campos nuevos:
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", } ] } ] } }
Cuando un dispositivo que antes operaba en la red doméstica de un usuario mediante la nube de un socio se convierte en un dispositivo Matter, la nube del socio debe enviar de inmediato un REQUEST SYNC
a Google para actualizar estos campos lo más rápido posible a fin de evitar la anulación de duplicación tardía.
Estas strings nunca deben cambiar una vez que se proporcionan para un dispositivo determinado. El ID único solo debería cambiar cuando se restablece la configuración de fábrica, lo que hace que el dispositivo aparezca en todas las integraciones como un dispositivo completamente nuevo.