Deduplicazione da cloud a cloud e dispositivo Matter

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

Requisiti per SYNC

Per evitare che vengano visualizzati 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 delle 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 sugli intent come SYNC è disponibile nel Primir Cloud-to-Cloud.

L'esempio di risposta SYNC riportato 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 utilizzava la 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 ed evitare la deduplicazione in ritardo.

Queste stringhe non dovrebbero mai cambiare una volta fornite per un determinato dispositivo. L'ID univoco dovrebbe cambiare solo con il ripristino dei dati di fabbrica, il che rende il dispositivo 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 verranno visualizzati in una sezione dedicata della schermata principale di GHA, in una sezione intitolata Collegati a te, all'esterno delle stanze. Questi dispositivi non verranno deduplicati. I dispositivi non verranno posizionati automaticamente in una struttura se l'utente ha più di una struttura (casa) in GHA. I dispositivi potrebbero non essere strutturati per altri motivi.

Se un utente sposta manualmente in una struttura un dispositivo Cloud-to-cloud che non ha superato l'associazione automatica della struttura, la deduplicazione potrebbe avvenire sul SYNC successivo, purché le risposte di SYNC siano conformi ai requisiti indicati nella sezione Requisiti di sincronizzazione.