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

Ao converter um dispositivo que atualmente usa (Cloud-to-cloud) para Matter, você deve garantir que o dispositivo use o mesmo ID em Matter que ele usa quando conectado usando as APIs não-Matter. Assim, o dispositivo aparece apenas uma vez no Google Home Graph do usuário. Os dispositivos Cloud-to-cloud só podem ser desduplicados quando estiverem associados a uma estrutura específica (origem) no Google Home app (GHA).

Requisitos do SYNC

Para evitar que duplicados apareçam noHome Graph, a nuvem do parceiro deve enviar três novos campos de string para cada dispositivo noSYNC resposta ao Google. Esses campos devem corresponder aos atributos definidos no Cluster de Informações Básicas para o dispositivo Matter. Além disso, as respostas de SYNC precisam conter roomHint:

1. matterUniqueId — O atributo UniqueId, em formato de string, do cluster Informações Básicas.
2. matterOriginalVendorId: o atributo VendorId, no formato de string hexadecimal, do cluster "Informações básicas".
3. matterOriginalProductId: o atributo ProductId, no formato de string hexadecimal, do cluster "Informações básicas".
4. roomHint - A sala onde este dispositivo se encontra.

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 a associação automática de estrutura não é possível, os dispositivos Cloud-to-cloud relevantes aparecem em uma seção dedicada da tela principal do GHA, em uma seção intitulada 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 duplicidade poderá ocorrer no próximo SYNC, desde que as respostas do SYNC estejam de acordo com os requisitos observados em Requisitos de SYNC.