Deduplicazione da cloud a cloud e dispositivo Matter

Quando converti un dispositivo che attualmente utilizza (Cloud-to-cloud) in Matter, devi assicurarti che il dispositivo utilizzi lo stesso ID su Matter che utilizza quando è connesso tramite le API non Matter. In questo modo, il dispositivo viene visualizzato una sola volta nel grafico Google Home dell'utente. Google Home Graph Cloud-to-cloud i dispositivi possono essere deduplicati solo se sono associati a una struttura specifica (casa) in Google Home app (GHA).

Requisiti di SYNC

Per evitare che vengano visualizzati duplicati nel Home Graph, il cloud del partner deve inviare a Google tre nuovi campi stringa per ogni dispositivo nella SYNC risposta. Questi campi devono corrispondere agli attributi definiti nel cluster Informazioni di base per il dispositivo Matter. Inoltre, le risposte SYNC devono contenere roomHint:

  1. matterUniqueId : l'attributo UniqueId, in formato stringa, del cluster Informazioni di base.
  2. matterOriginalVendorId : l'attributo VendorId, in formato stringa esadecimale, del cluster Informazioni di base.
  3. matterOriginalProductId : l'attributo ProductId, in formato stringa esadecimale, del cluster Informazioni di base.
  4. roomHint : la stanza in cui si trova questo dispositivo.

La documentazione sugli intenti come SYNC è disponibile nella guida introduttiva cloud-to-cloud.

La risposta di esempio SYNC riportata di seguito mostra l'utilizzo dei tre nuovi campi e di roomHint:

SYNC Risposta 
{
  "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 un dispositivo che in precedenza operava sulla rete domestica di un utente utilizzando il cloud di un partner viene convertito in un dispositivo Matter, il cloud del partner deve inviare immediatamente un REQUEST SYNC a Google per aggiornare questi campi il prima possibile ed evitare la deduplicazione tardiva.

Queste stringhe non devono mai cambiare una volta fornite per un determinato dispositivo. L'ID univoco deve cambiare solo in caso di ripristino dei dati di fabbrica, in modo che il dispositivo venga visualizzato in tutte le integrazioni come un dispositivo completamente nuovo.

Associazione automatica della struttura

Non è garantito che i dispositivi Cloud-to-cloud vengano associati automaticamente a una struttura specifica. Nelle situazioni in cui l'associazione automatica della struttura non è possibile, i dispositivi Cloud-to-cloud pertinenti vengono visualizzati in una sezione dedicata della schermata principale di GHA, sotto una sezione intitolata Collegati a te, al di fuori di qualsiasi stanza. Questi dispositivi non verranno deduplicati. I dispositivi non verranno inseriti automaticamente in una struttura quando l'utente ha più di una struttura (casa) in GHA. I dispositivi potrebbero non essere strutturati per altri motivi.

Se un utente sposta manualmente un dispositivo Cloud-to-cloud in cui non è stata eseguita l'associazione automatica della struttura in una struttura, la deduplicazione potrebbe avvenire al successivo SYNC a condizione che le risposte SYNC siano conformi ai requisiti indicati in Requisiti di SYNC.