Smart-Home-Szenenmerkmal-Schema

action.devices.traits.Scene – Diese Eigenschaft wird verwendet, um virtuelle Geräte zusammen mit dem SCENE-Gerätetyp zu implementieren.

Weitere Informationen finden Sie im Leitfaden zu Szenentypen.

Wenn Nutzer beispielsweise auf einem Gerät eine Befehlsgruppierung per Berührung konfigurieren können, z. B. Lampen auf bestimmte Farben stellen oder verschiedene Sicherheitsfunktionen sequenzieren oder eine andere Kombination von Aktivitäten ausführen, kann diese Konfiguration über SYNC als benannte Szene freigegeben werden. Assistant stellt diese Szenen Nutzern dann über eine einfache Aktivierungsgrammatik zur Verfügung:

  • Partymodus starten
  • Aktiviere die Mitternachtsszene.

Als virtuelle Objekte können Szenen zur Klärung der Bedeutung (falls zutreffend) in Räumen platziert werden:

  • Die Party kann losgehen.
  • Aktivieren Sie den Nachtlichtmodus in den Schlafzimmern.

Ein Unterschied zwischen Szenen und physischen Zielen besteht darin, dass Assistant Szenenbefehle automatisch im Plural ausführt. So können Nutzer Szenen bei mehreren Partnern auslösen. Wenn ein Nutzer beispielsweise eine Szene „Partymodus“ bei zwei verschiedenen Partnern hat, eine für die Sicherheit und eine für die Beleuchtung, wird durch Partymodus aktivieren beides ausgelöst.

Szenen passen gut zu bevorstehenden persönlichen Aktionen für benutzerdefinierte Grammatik (z. B. Partymodus aktivieren -> Los gehts!).

Szenen sollten immer von Nutzern angegebene Namen haben, anstatt die Standardbenennung „BobCo-Szene“. Jede Szene ist ein eigenes virtuelles Gerät mit eigenem Namen. Vom Nutzer bereitgestellte Namen können von SYNC stammen.

Geräteattribute

Geräte mit diesem Merkmal können die folgenden Attribute im Rahmen des Vorgangs SYNC melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute Typ Beschreibung
sceneReversible Boolesch

(Standardeinstellung: false)

Gibt an, dass diese Szene abgebrochen werden kann. Dieses Attribut ist nur für Szenen relevant, in denen der Status geändert wird und bei denen der vorherige Zustand gespeichert wird. Das Gerät unterstützt den Befehl ActivateScene mit dem Parameter deactivate auf „wahr“.

Beispiele

Gerät, das eine umkehrbare Szene unterstützt

{
  "sceneReversible": true
}

GERÄTESTATUS

Keine.

BEFEHLE für Geräte

Geräte mit dieser Eigenschaft können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Ausführung.

action.devices.commands.ActivateScene

Aktivieren oder deaktivieren Sie eine Szene.

Parameter

Parameter Typ Beschreibung
deactivate Boolesch

Erforderlich.

„True“, um eine Szene abzubrechen, wenn sie umkehrbar ist, „false“, um eine Szene zu aktivieren.

Beispiele

Eine Szene nach Namen aktivieren

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": false
  }
}

Deaktivieren Sie eine Szene anhand des Namens.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": true
  }
}

GERÄTEFEHLER

Eine vollständige Liste der Fehler und Ausnahmen