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

Cuando conviertes un dispositivo que actualmente usa (Cloud-to-cloud) a Matter, debes asegurarte de que el dispositivo use en Matter el mismo ID que usa cuando está conectado mediante 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. Solo se puede anular la duplicación de los dispositivos Cloud-to-cloud cuando están asociados con una estructura particular (casa) en el Google Home app (GHA).

Requisitos de la SYNC

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

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

La documentación sobre intents, como SYNC, se puede encontrar en el Manual de nube a Cloud.

En la siguiente respuesta de ejemplo SYNC, se muestra el uso de los tres campos nuevos así como roomHint:

SYNC Respuesta
{
  "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 a través de 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 y 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 para todas las integraciones como un dispositivo completamente nuevo.

Asociación automática de estructura

No se garantiza que los dispositivos Cloud-to-cloud se asocien automáticamente con una estructura particular. En situaciones en las que no es posible asociar automáticamente la estructura, los dispositivos Cloud-to-cloud relevantes aparecerán en una sección dedicada de la pantalla principal de GHA, en una sección titulada Vinculadas a ti, fuera de todas las habitaciones. No se anulará la duplicación de estos dispositivos. Los dispositivos no se ubicarán automáticamente en una estructura cuando el usuario tenga más de una (casa) en GHA. Es posible que los dispositivos no se estructuran por otros motivos.

Si un usuario mueve un dispositivo Cloud-to-cloud que falló en la asociación de estructura automática a una estructura de forma manual, la anulación de duplicación puede ocurrir en el siguiente SYNC siempre que las respuestas de SYNC cumplan con los requisitos que se indican en los requisitos de SYNC.