Eliminação de duplicação de dispositivos entre nuvens e Matter

Ao converter um dispositivo que usa (Cloud-to-cloud) para Matter, verifique se ele usa o mesmo ID no Matter que usa quando conectado com as APIs não Matter. Isso garante que o dispositivo apareça apenas uma vez no Google Home Graph do usuário. Os dispositivos Cloud-to-cloud só podem ser deduplicados quando estão associados a uma estrutura (casa) específica no Google Home app (GHA).

Requisitos do SYNC

Para evitar que duplicatas apareçam no Home Graph, a nuvem do parceiro precisa enviar três novos campos de string para cada dispositivo na resposta SYNC ao Google. Esses campos precisam corresponder aos atributos definidos no cluster de informações básicas do dispositivo Matter. Além disso, as respostas de SYNC precisam conter roomHint:

1. matterUniqueId: o atributo UniqueId em formato de string.
2. matterOriginalVendorId: o atributo VendorId, no formato de string hexadecimal.
3. matterOriginalProductId: o atributo ProductId, no formato de string hexadecimal.
4. roomHint: o ambiente em que o dispositivo está.

A documentação sobre intents, como SYNC pode ser encontrada na introdução sobre nuvem a nuvem.

O exemplo de resposta SYNC abaixo mostra o uso dos três novos campos e 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",
          }
        ]
      }
    ]
  }
}

Quando um dispositivo que estava operando em uma rede doméstica usando a nuvem de um parceiro é convertido em um dispositivo Matter, a nuvem do parceiro precisa enviar imediatamente um REQUEST SYNC ao Google para atualizar esses campos o mais rápido possível e evitar a deduplicação tardia.

Essas strings nunca devem mudar depois de serem fornecidas para um determinado dispositivo. O ID exclusivo só muda em uma redefinição de fábrica, o que faz com que o dispositivo apareça para todas as integrações como um dispositivo totalmente novo.

Associação automática de estrutura

Não há garantia de que os dispositivos Cloud-to-cloud sejam automaticamente associados a uma estrutura específica. Em situações em que não é possível fazer a associação automática de estrutura, os dispositivos Cloud-to-cloud relevantes aparecem em uma seção dedicada da tela principal do GHA, em uma seção chamada Vinculado a você, fora de qualquer ambiente. Esses dispositivos não serão duplicados. Os dispositivos não serão colocados automaticamente em uma estrutura quando o usuário tiver mais de uma estrutura (casa) no GHA. Os dispositivos podem não ser estruturados por outros motivos.

Se um usuário mover manualmente um dispositivo Cloud-to-cloud que não conseguiu fazer a associação automática de estrutura para uma estrutura, a remoção de duplicação poderá ocorrer no próximo SYNC, desde que as respostas do SYNC estejam de acordo com os requisitos observados em Requisitos de SYNC.