Deduplizierung in die Cloud und in Matter-Geräten

Wenn Sie ein Gerät, das derzeit (Cloud-to-cloud) verwendet, in Matter umwandeln, müssen Sie darauf achten, dass das Gerät in Matter dieselbe ID verwendet, die es bei der Verbindung über Nicht-Matter-APIs verwendet. So wird sichergestellt, dass das Gerät nur einmal in der Google Home Graph des Nutzers angezeigt wird. Cloud-to-cloud-Geräte können nur dann dedupliziert werden, wenn sie in der Google Home app (GHA) einem bestimmten Gebäude (Zuhause) zugeordnet sind.

SYNC-Anforderungen

Damit im Home Graph keine Duplikate angezeigt werden, muss die Cloud des Partners für jedes Gerät in der SYNC-Antwort drei neue Stringfelder an Google senden. Diese Felder müssen mit Attributen übereinstimmen, die im Cluster für allgemeine Informationen für das Gerät Matter definiert wurden. Außerdem müssen SYNC-Antworten Folgendes enthalten: roomHint

1. matterUniqueId: Das Attribut UniqueId im Stringformat.
2. matterOriginalVendorId: Das Attribut VendorId im hexadezimalen Stringformat.
3. matterOriginalProductId: Das Attribut ProductId im hexadezimalen Stringformat.
4. roomHint: Der Raum, in dem sich dieses Gerät befindet.

Dokumentationen zu Intents wie SYNC finden Sie im Einstieg in die Cloud-zu-Cloud-Kommunikation.

Im folgenden Beispiel für die SYNC-Antwort werden die drei neuen Felder sowie roomHint verwendet:

{
  "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",
          }
        ]
      }
    ]
  }
}

Wenn ein Gerät, das zuvor im Heimnetzwerk eines Nutzers über die Cloud eines Partners betrieben wurde, in ein Matter-Gerät umgewandelt wird, muss die Cloud des Partners sofort eine REQUEST SYNC an Google senden, um diese Felder so schnell wie möglich zu aktualisieren und eine späte Deduplizierung zu vermeiden.

Diese Strings sollten sich nach der Bereitstellung für ein bestimmtes Gerät nicht mehr ändern. Die eindeutige ID sollte sich nur bei einem Zurücksetzen auf die Werkseinstellungen ändern. Dadurch wird das Gerät für alle Integrationen als völlig neues Gerät angezeigt.

Automatische Strukturverknüpfung

Cloud-to-cloud-Geräte werden nicht unbedingt automatisch mit einer bestimmten Struktur verknüpft. Wenn eine automatische Strukturverknüpfung nicht möglich ist, werden die entsprechenden Cloud-to-cloud-Geräte außerhalb der Räume in einem dafür vorgesehenen Bereich auf dem Hauptbildschirm von GHA unter dem Abschnitt Mit mir verknüpft angezeigt. Solche Geräte werden nicht dedupliziert. Geräte werden nicht automatisch in einem Gebäude platziert, wenn der Nutzer mehr als ein Gebäude (Zuhause) in der GHA hat. Geräte können aus anderen Gründen nicht strukturiert sein.

Wenn ein Nutzer ein Cloud-to-cloud-Gerät, das die automatische Strukturverknüpfung fehlgeschlagen hat, manuell in eine Struktur verschiebt, kann die Deduplizierung beim nächsten SYNC erfolgen, sofern die SYNC-Antworten den in den SYNC-Anforderungen genannten Anforderungen entsprechen.