Deduplizierung in die Cloud und in Matter-Geräten

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

Anforderungen für SYNC

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

  1. matterUniqueId: Das Attribut UniqueId im Stringformat aus dem Cluster „Basic Information“.
  2. matterOriginalVendorId: Das Attribut VendorId im Hexadezimalstringformat aus dem Cluster „Basic Information“.
  3. matterOriginalProductId: Das Attribut ProductId im Hexadezimalstringformat aus dem Cluster „Basic Information“.
  4. roomHint: Der Raum, in dem sich dieses Gerät befindet.

Dokumentation zu Intents wie SYNC findest du in der Einführung in Cloud-to-Cloud.

Die folgende Beispielantwort SYNC zeigt die Verwendung der drei neuen Felder sowie von roomHint:

SYNC-Antwort 
{
  "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 verspätete Deduplizierung zu vermeiden.

Diese Strings sollten sich nicht mehr ändern, nachdem sie für ein bestimmtes Gerät bereitgestellt wurden. 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 Zuordnung von Gebäuden

Cloud-to-cloud-Geräte werden nicht garantiert automatisch einem bestimmten Gebäude zugeordnet. Wenn eine automatische Zuordnung zu einem Gebäude nicht möglich ist, werden die entsprechenden Cloud-to-cloud-Geräte in einem eigenen Bereich auf dem Hauptbildschirm der GHA angezeigt. Dieser Bereich heißt Mit mir verknüpft und befindet sich außerhalb aller Räume. Solche Geräte werden nicht dedupliziert. Geräte werden nicht automatisch einem Gebäude hinzugefügt, 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 können.

Wenn ein Nutzer ein Cloud-to-cloud-Gerät, das nicht automatisch mit einem Gebäude verknüpft werden konnte, manuell in ein Gebäude verschiebt, kann die Deduplizierung bei der nächsten SYNC-Anfrage erfolgen, sofern die SYNC-Antworten den Anforderungen entsprechen, die unter SYNC-Anforderungen aufgeführt sind.