Deduplicazione da cloud a cloud e dispositivo Matter

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

Requisiti di SYNC

Per evitare che vengano visualizzati duplicati in Home Graph, il cloud del partner deve inviare tre nuovi campi di stringa per ogni dispositivo nella risposta SYNC a Google. 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 di stringa esadecimale.
3. matterOriginalProductId: l'attributo ProductId in formato di stringa esadecimale.
4. roomHint: la stanza in cui si trova il dispositivo.

La documentazione relativa a intent come SYNC è disponibile nel panoramica di Cloud-to-Cloud.

La risposta SYNC di esempio riportata di seguito mostra l'utilizzo dei tre nuovi campi, nonché di 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 un dispositivo che in precedenza operava 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 messaggio REQUEST SYNC a Google per aggiornare questi campi il più rapidamente possibile per evitare la deduplica tardiva.

Queste stringhe non devono mai cambiare una volta fornite per un determinato dispositivo. L'ID unico dovrebbe cambiare solo in caso di ripristino dei dati di fabbrica, il che fa apparire il dispositivo come un dispositivo completamente nuovo per tutte le integrazioni.

Associazione automatica della struttura

Non è garantito che i dispositivi Cloud-to-cloud vengano automaticamente associati a una determinata struttura. Nelle situazioni in cui non è possibile l'associazione automatica della struttura, i dispositivi Cloud-to-cloud pertinenti verranno visualizzati in una sezione dedicata della schermata principale di Cloud-to-cloud, nella sezione Collegati al tuo account, al di fuori di qualsiasi stanza.GHA Questi dispositivi non verranno deduplicati. I dispositivi non verranno posizionati automaticamente in una casa se l'utente ha più di una casa nel GHA. I dispositivi potrebbero non essere strutturati per altri motivi.

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