Anulación de duplicación de dispositivos de nube a nube y Matter

Cuando conviertes un dispositivo que usa actualmente (Cloud-to-cloud) a Matter, debes asegurarte de que el dispositivo use el mismo ID en Matter que usa cuando se conecta con las APIs que no son de Matter. De esta manera, se garantiza que el dispositivo se muestre solo una vez en el Google Home Graph del usuario. Los dispositivos Cloud-to-cloud solo se pueden anular cuando están asociados con una estructura en particular (casa) en Google Home app (GHA).

Requisitos de SYNC

Para evitar que aparezcan duplicados en Home Graph, la nube del socio debe enviar tres campos de cadena nuevos para cada dispositivo en la respuesta SYNC a Google. Estos campos deben coincidir con los atributos definidos en el clúster de información básica para el dispositivo Matter. Además: Las respuestas de SYNC deben contener roomHint:

1. matterUniqueId: Es el atributo UniqueId en formato de cadena.
2. matterOriginalVendorId: Es el atributo VendorId, en formato de cadena hexadecimal.
3. matterOriginalProductId: Es el atributo ProductId, en string hexadecimal. de un conjunto de datos tengan un formato común.
4. roomHint: Es la habitación donde reside este dispositivo.

Documentación sobre intents, como SYNC puedes encontrar en el Manual de nube a nube.

La siguiente respuesta de ejemplo de SYNC muestra el uso de los tres campos nuevos, además de roomHint:

{
  "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 funcionaba en la red doméstica de un usuario con la nube de un socio se convierte en un dispositivo Matter, la nube del socio debe enviar inmediatamente un REQUEST SYNC a Google para actualizar estos campos lo más rápido posible y evitar la anulación de duplicación tardía.

Estas cadenas nunca deben cambiar una vez que se proporcionan para un dispositivo determinado. El ID único solo debe cambiar cuando se restablece la configuración de fábrica, lo que hace que el dispositivo aparezca para todas las integraciones como un dispositivo completamente nuevo.

Asociación de estructuras automática

No se garantiza que los dispositivos Cloud-to-cloud se asocien automáticamente con una estructura en particular. En situaciones en las que no es posible asociar automáticamente la estructura, la dirección Los dispositivos Cloud-to-cloud aparecerán en una sección dedicada del Pantalla principal de GHA, en una sección titulada Vinculada a tú, fuera de ninguna sala. No se anularán los duplicados de estos dispositivos. Los dispositivos harán lo siguiente no se pueden colocar automáticamente en una estructura cuando el usuario tiene más de un (casa) en GHA. Es posible que los dispositivos no se estructuren por otros motivos.

Si un usuario mueve un dispositivo Cloud-to-cloud que falló automáticamente la asociación de la estructura en una estructura de forma manual, la anulación de duplicación puede realizarse el próximo SYNC, siempre que las respuestas de SYNC cumplan con los requisitos indicados en Requisitos de SYNC.