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

Ao converter um dispositivo que está em uso (Cloud-to-cloud) para Matter, será preciso garantir que o dispositivo usa o mesmo ID no Matter que usa. quando conectados usando APIs que não são Matter. Isso garante que que o dispositivo mostra apenas uma vez no Google Home Graph do usuário. A duplicação de Cloud-to-cloud dispositivos só pode ser eliminada ao ser associadas a uma estrutura específica (casa) no Google Home app (GHA).

SYNC requisitos

Para evitar que duplicatas apareçam no Home Graph, o arquivo cloud deve enviar três novos campos de string para cada dispositivo no SYNC resposta ao Google. Esses campos devem corresponder aos atributos definidos na documentação Cluster de informações para o dispositivo Matter. Além disso, As respostas de SYNC precisam conter roomHint:

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

A documentação sobre intents como SYNC podem ser encontradas na Introdução à nuvem para nuvem.

O exemplo de resposta SYNC abaixo mostra o uso dos três novos campos, bem como 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 na rede doméstica de um usuário usando nuvem de um parceiro for convertida em um dispositivo Matter, a para a nuvem do parceiro precisa enviar imediatamente REQUEST SYNC ao Google para atualizar esses campos o mais rápido possível e evitar atrasos e eliminação de duplicação.

Essas strings nunca devem mudar depois de fornecidas para um determinado dispositivo. A O ID exclusivo só deve ser alterado em uma redefinição para a configuração original, o que faz o dispositivo aparecer a todas as integrações como um dispositivo totalmente novo.

Associação automática de estrutura

Não há garantia de que dispositivos Cloud-to-cloud sejam automaticamente associados a uma estrutura específica. Em situações em que a associação automática de estrutura não for possível, os eventos Cloud-to-cloud dispositivo vai aparecer em uma seção dedicada do Tela principal do app GHA, em uma seção chamada Vinculado a você, fora das salas. Esses dispositivos não vão ser eliminados. Os dispositivos vão não serão colocados automaticamente em uma estrutura quando o usuário tiver mais de um (casa) no GHA. Os dispositivos podem não ser estruturados por outros motivos.

Se um usuário mover um dispositivo Cloud-to-cloud que apresente falhas automáticas a associação da estrutura em uma estrutura manualmente, a eliminação de duplicação pode ocorrer nos próximos SYNC, desde que as respostas de SYNC estejam em conformidade com os requisitos indicados nos requisitos de sincronização.