Deduplicazione da cloud a cloud e dispositivo Matter

Durante la conversione di un dispositivo che attualmente utilizza (Cloud-to-cloud) per Matter, devi assicurarti che il dispositivo usi lo stesso ID usato su Matter se si è connessi tramite API diverse da 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 a Google tre nuovi campi di stringa per ogni dispositivo nella risposta 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 stringa esadecimale formato.
  3. matterOriginalProductId: l'attributo ProductId in formato di stringa esadecimale.
  4. roomHint: la stanza in cui si trova il dispositivo.

Documentazione su intenti come SYNC è disponibile nel documento introduttivo su Cloud-to-Cloud.

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

Risposta di 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 utilizzava la rete domestica di un utente il cloud di un partner viene convertito in un dispositivo Matter, cloud del partner deve inviare immediatamente REQUEST SYNC a Google per aggiornare questi campi il più rapidamente possibile per evitare ritardi senza la deduplicazione.

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

Associazione automatica della struttura

Non è garantito che i dispositivi Cloud-to-cloud vengano automaticamente associati a una determinata struttura. Nei casi in cui non è possibile associare la struttura automatica, Cloud-to-cloud dispositivi verranno visualizzati in una sezione dedicata dell' Schermata principale di GHA, in una sezione intitolata Collegato a te, all'esterno di qualsiasi stanza. Questi dispositivi non verranno deduplicati. I dispositivi non vengano posizionati automaticamente in una struttura quando l'utente ne ha (casa) in 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.