Deduplizierung in die Cloud und in Matter-Geräten

Wenn Sie ein Gerät, das derzeit (Cloud-to-cloud) verwendet, auf Matter umstellen, muss auf dem Gerät dieselbe ID für Matter verwendet werden wie bei der Verbindung über APIs, die nicht Matter sind. 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 in der Home Graph keine Duplikate angezeigt werden, muss die Cloud des Partners drei neue Stringfelder für jedes Gerät in der SYNC-Antwort an Google senden. Diese Felder müssen mit Attributen übereinstimmen, die im Cluster „Grundlegende Informationen“ für das Matter-Gerät definiert sind. Außerdem müssen SYNC-Antworten Folgendes enthalten: roomHint

1. matterUniqueId: Das UniqueId-Attribut im Stringformat.
2. matterOriginalVendorId: Das Attribut VendorId im Hexadezimalformat.
3. matterOriginalProductId: Das Attribut ProductId im Hexadezimalformat.
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.

In der Beispielantwort für SYNC unten sind die drei neuen Felder sowie roomHint zu sehen:

{
  "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 Gebäudeverknüpfung

Cloud-to-cloud-Geräte werden nicht garantiert automatisch einem bestimmten Gebäude zugeordnet. Wenn eine automatische Gebäudeverknüpfung nicht möglich ist, werden die entsprechenden Cloud-to-cloud-Geräte in einem speziellen Bereich des Hauptbildschirms von GHA angezeigt, in einem Bereich mit dem Titel Mit Ihnen verknüpft, außerhalb von Räumen. 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. Es kann auch andere Gründe geben, warum Geräte nicht strukturiert werden.

Wenn ein Nutzer ein Cloud-to-cloud-Gerät, bei dem die automatische Gebäudeverknüpfung fehlgeschlagen ist, manuell in ein Gebäude verschiebt, kann die Deduplizierung bei der nächsten SYNC-Aufnahme erfolgen, sofern die SYNC-Antworten den in den SYNC-Anforderungen aufgeführten Anforderungen entsprechen.