Deduplizierung in die Cloud und in Matter-Geräten

Wenn Sie ein Gerät, das derzeit (Cloud-to-cloud) in Matter umwandeln, muss es dieselbe ID in Matter verwenden wie bei der Verbindung über die Nicht-Matter APIs. So wird das Gerät nur einmal im Google Home Graph des Nutzers angezeigt. Cloud-to-cloud Geräte können nur dedupliziert werden, wenn sie in der Google Home app (GHA) mit einer bestimmten Struktur (Zuhause) verknüpft sind.

Anforderungen für SYNC

Damit keine Duplikate im Home Graph 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 den Attributen übereinstimmen, die im Cluster „Allgemeine Informationen“ 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 „Allgemeine Informationen“.
2. matterOriginalVendorId : Das Attribut VendorId im hexadezimalen String format aus dem Cluster „Allgemeine Informationen“.
3. matterOriginalProductId : Das Attribut ProductId im hexadezimalen Stringformat aus dem Cluster „Allgemeine Informationen“.
4. roomHint : Der Raum, in dem sich dieses Gerät befindet.

Informationen zu Intents wie SYNC finden Sie im Leitfaden zu Cloud-zu-Cloud.

Die folgende SYNC-Beispielantwort zeigt die Verwendung der drei neuen Felder sowie von 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",
          }
        ]
      }
    ]
  }
}

Wenn ein Gerät, das zuvor im Heimnetzwerk eines Nutzers mit der Cloud eines Partners verwendet 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 nie ändern. Die eindeutige ID sollte sich nur beim Zurücksetzen auf die Werkseinstellungen ändern. Dann wird das Gerät für alle Integrationen als völlig neues Gerät angezeigt.

Automatische Zuordnung zu einer Struktur

Cloud-to-cloud Geräte werden nicht garantiert automatisch einer bestimmten Struktur zugeordnet. Wenn die automatische Zuordnung zu einer Struktur nicht möglich ist, werden die entsprechenden Cloud-to-cloud Geräte im Hauptbildschirm der GHA's in einem separaten Bereich unter der Überschrift Mit Ihnen verknüpft außerhalb von Räumen angezeigt. Solche Geräte werden nicht dedupliziert. Geräte werden nicht automatisch in einer Struktur platziert, wenn der Nutzer in der GHA mehr als eine Struktur (Zuhause) hat.GHA 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 einer Struktur zugeordnet wurde, manuell in eine Struktur verschiebt, kann die Deduplizierung bei der nächsten SYNC erfolgen, sofern die SYNC Antworten den Anforderungen entsprechen, die unter Anforderungen für SYNC aufgeführt sind.