Deduplicazione da cloud a cloud e dispositivo Matter

Quando converti in Matter un dispositivo che attualmente utilizza (Cloud-to-cloud), devi assicurarti che su Matter venga utilizzato lo stesso ID che usa per la connessione tramite API non Matter. In questo modo assicurerai che il dispositivo venga visualizzato una sola volta sul Google Home Graph dell'utente. Cloud-to-cloud dispositivi possono essere deduplicati solo quando sono associati a una particolare struttura (casa) in Google Home app (GHA).

SYNC requisiti

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

  1. matterUniqueId: l'attributo UniqueId in formato stringa.
  2. matterOriginalVendorId: l'attributo VendorId, in formato stringa esadecimale.
  3. matterOriginalProductId: l'attributo ProductId, in formato stringa esadecimale.
  4. roomHint: la stanza in cui si trova il dispositivo.

La documentazione su intent come SYNC è disponibile nel Cloud-to-Cloud Primer.

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

Risposta SYNC 
{
  "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 funzionava sulla rete di casa 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 più rapidamente possibile per evitare la deduplicazione.

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

Associazione automatica della struttura

Non è garantito che i dispositivi Cloud-to-cloud vengano associati automaticamente a una particolare struttura. Nelle situazioni in cui non è possibile eseguire l'associazione automatica della struttura, i dispositivi Cloud-to-cloud pertinenti verranno visualizzati in una sezione dedicata della schermata principale di GHA, in una sezione intitolata Collegati a te, all'esterno di qualsiasi stanza. Questi dispositivi non verranno deduplicati. I dispositivi non verranno posizionati 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 un dispositivo Cloud-to-cloud che non ha superato manualmente l'associazione della struttura automatica in una struttura, la deduplicazione potrebbe avvenire il giorno SYNC successivo, purché le risposte SYNC siano conformi ai requisiti indicati in Requisiti di sincronizzazione.