Deduplizierung in die Cloud und in Matter-Geräten

Wenn Sie ein Gerät, das derzeit (Cloud-to-cloud) in Matter umwandeln, muss das Gerät dieselbe ID in Matter verwenden, die es verwendet, wenn es über die Nicht-Matter APIs verbunden ist. So wird sichergestellt , dass das Gerät nur einmal im Google Home Graph des Nutzers angezeigt wird. 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.

unterstützt.

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 in der Einführung zu Cloud-zu-Cloud.

In der folgenden SYNC-Beispielantwort wird die Verwendung der drei neuen Felder sowie von roomHint gezeigt:

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 nach der Bereitstellung für ein bestimmtes Gerät nie ändern. Die eindeutige ID sollte sich nur beim 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 Strukturen

Cloud-to-cloud Geräte werden nicht garantiert automatisch einer bestimmten Struktur zugeordnet. Wenn die automatische Zuordnung von Strukturen nicht möglich ist, werden die entsprechenden Cloud-to-cloud Geräte in einem separaten Bereich des GHA's Hauptbildschirms unter einem Abschnitt mit dem Titel Mit dir 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, bei dem die automatische Zuordnung von Strukturen fehlgeschlagen ist, manuell in eine Struktur verschiebt, kann die Deduplizierung beim nächsten SYNC erfolgen, sofern die SYNC-Antworten den Anforderungen entsprechen, die unter Anforderungen für SYNC aufgeführt sind.