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

Al convertir un dispositivo que actualmente se utiliza (Cloud-to-cloud) a Matter, debes asegurarte que el dispositivo use el mismo ID en Matter que usa cuando se conectan con APIs que no son de Matter. Esto garantiza que el dispositivo muestra una sola vez en el Google Home Graph del usuario. Solo se puede anular el duplicado de Cloud-to-cloud dispositivo si está asociados con una estructura particular (casa) en Google Home app (GHA).

Requisitos de SYNC

Para evitar que aparezcan duplicados en Home Graph, la cuenta del socio la nube debe enviar tres campos de cadena nuevos para cada dispositivo en la SYNC respuesta a Google. Estos campos deben coincidir con los atributos definidos en el nivel Básico Clúster de información del 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 string hexadecimal. de un conjunto de datos tengan un formato común.
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, el la nube del socio debe enviar de inmediato una REQUEST SYNC a Google actualizar estos campos lo más rápido posible y evitar retrasos la anulación de duplicación.

Estas cadenas nunca deben cambiar una vez que se proporcionan para un dispositivo determinado. El El ID único solo debería cambiar al restablecer la configuración de fábrica, lo que hará que aparezca el dispositivo. a todas las integraciones como un dispositivo completamente nuevo.

Asociación de estructura automática

No se garantiza que los dispositivos Cloud-to-cloud sean automáticamente asociados con una estructura 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á la duplicación 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 estructurado 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.