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

Cuando conviertas un dispositivo que actualmente usa (Cloud-to-cloud) en 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 la Google Home Graph del usuario. Los dispositivos Cloud-to-cloud solo se pueden desduplicar cuando están asociados a una estructura (casa) en particular en el Google Home app (GHA).

Requisitos de SYNC

Para evitar que aparezcan duplicados en el 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 SYNC deben contener roomHint:

1. matterUniqueId: Es el atributo UniqueId, en formato de cadena, del clúster de información básica.
2. matterOriginalVendorId: Es el atributo VendorId, en formato de cadena hexadecimal, del clúster de información básica.
3. matterOriginalProductId: Es el atributo ProductId, en formato de cadena hexadecimal, del clúster de información básica.
4. roomHint: Es la habitación en la que se encuentra este dispositivo.

La documentación sobre intents, como SYNC, se puede encontrar en la guía básica de Cloud-to-Cloud.

En el siguiente ejemplo de respuesta SYNC, se muestra el uso de los tres campos nuevos, así como 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 de inmediato un REQUEST SYNC a Google para actualizar estos campos lo antes 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 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.

Asociación automática de estructuras

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 la asociación automática de la estructura, los dispositivos Cloud-to-cloud pertinentes aparecerán en una sección dedicada de la pantalla principal de GHA, en una sección titulada Vinculados a ti, fuera de cualquier habitación. No se anulará la duplicación de esos dispositivos. Los dispositivos no se colocarán automáticamente en una estructura cuando el usuario tenga más de una estructura (casa) en el GHA. Es posible que los dispositivos no se estructuren por otros motivos.

Si un usuario mueve de forma manual un dispositivo Cloud-to-cloud que falló en la asociación automática de la estructura a una estructura, es posible que se realice la anulación de duplicación en la próxima SYNC, siempre que las respuestas de SYNC cumplan con los requisitos que se indican en Requisitos de SYNC.