Wenn Sie ein Gerät, das derzeit (Cloud-to-cloud) verwendet, zu Matter konvertieren, müssen Sie dafür sorgen, dass das Gerät dieselbe ID für Matter verwendet wie bei einer 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 einem bestimmten Gebäude (Zuhause) verknüpft sind.
SYNC
-Anforderungen
Damit keine Duplikate auf der Home Graph angezeigt werden, müssen in der SYNC
-Antwort an Google drei neue Stringfelder für jedes Gerät in der Cloud des Partners gesendet werden. Diese Felder müssen mit Attributen übereinstimmen, die im Cluster „Basic Information“ (Grundlegende Informationen) für das Matter-Gerät definiert sind. Außerdem müssen SYNC
-Antworten roomHint
enthalten:
matterUniqueId
: Das AttributUniqueId
im Stringformat.matterOriginalVendorId
: Das AttributVendorId
im Hexadezimalstringformat.matterOriginalProductId
: Das AttributProductId
im Hexadezimalstringformat.roomHint
: Der Raum, in dem sich dieses Gerät befindet.
Die Dokumentation zu Intents wie SYNC
finden Sie in der Cloud-to-Cloud-Einführung.
In der Beispielantwort SYNC
unten sehen Sie 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 ein 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 nicht mehr ändern, sobald sie für ein bestimmtes Gerät angegeben wurden. Die eindeutige ID sollte sich nur bei einem Zurücksetzen auf die Werkseinstellungen ändern. Das Gerät wird dann für alle Integrationen als völlig neues Gerät angezeigt.
Automatische Zuordnung von Strukturen
Es wird nicht garantiert, dass Cloud-to-cloud-Geräte automatisch einer bestimmten Struktur zugeordnet werden. Wenn eine automatische Zuordnung der Struktur nicht möglich ist, werden die entsprechenden Cloud-to-cloud-Geräte auf dem Hauptbildschirm von GHA in einem separaten Bereich 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 mehr als eine Struktur (Zuhause) in GHA hat. Geräte können aus anderen Gründen nicht strukturiert werden.
Wenn ein Nutzer ein Cloud-to-cloud-Gerät, bei dem die automatische Zuordnung zu einem Gebäude fehlgeschlagen ist, manuell in ein Gebäude verschiebt, kann die Deduplizierung beim nächsten SYNC
erfolgen, sofern die SYNC
-Antworten den in den SYNC-Anforderungen genannten Anforderungen entsprechen.