Schema für Smart-Home-Szenenmerkmale

action.devices.traits.Scene: Dieses Merkmal wird verwendet, um virtuelle Geräte zusammen mit dem SCENE-Gerätetyp zu implementieren.

Weitere Informationen finden Sie in der Anleitung für Szenentypen.

Ist es z. B. möglich, mit nur einer Berührung Mit Befehlen können Sie die Beleuchtung auf bestimmte Farben einstellen oder die Reihenfolge der Sicherheitsvorkehrungen festlegen, oder eine andere Kombination von Aktivitäten verwenden, über SYNC als benannte Szene angezeigt. Assistant macht sie dann Szenen, die Nutzern durch einfache Aktivierungsgrammatik zur Verfügung stehen:

  • Partymodus starten
  • Aktiviere die Mitternachtsszene.

Als virtuelle Objekte können Szenen in Räumen (falls relevant) für Begriffserklärung:

  • Partyzeit in der Küche.
  • Den Nachtlichtmodus in den Schlafzimmern aktivieren.

Ein Unterschied zwischen Szenen und physischen Zielen besteht darin, dass Assistant automatisch Pluraleffekte auf Scene-Befehle anwenden, sodass Nutzer von mehreren Partnern. Wenn ein Nutzer einen „Partymodus“ hat, Szene zwei verschiedenen Partnern, einen für Sicherheit und einen für Lampen, Partymodus aktivieren werden beide ausgelöst.

Szenen passen gut zu anstehenden persönlichen Aktionen für benutzerdefinierte Grammatik zum Beispiel Partymodus aktivieren -> Legen wir los!

Szenen sollten immer den vom Nutzer bereitgestellten Namen haben (nicht die Standardeinstellung „BobCo-Szene“). Namensgebung. Jede Szene ist ein eigenes virtuelles Gerät mit einem eigenen Namen. Von Nutzern bereitgestellte Namen können aus SYNC stammen.

Geräte-ATTRIBUTES

Auf Geräten mit diesem Trait kann Folgendes gemeldet werden im Rahmen des SYNC-Vorgangs verwenden. Weitere Informationen Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Absichtliche Umsetzung.

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, wobei der Parameter deactivate auf „true“ gesetzt ist.

Beispiele

Gerät, das Aufnahmen umdrehen kann.

{
  "sceneReversible": true
}

Gerät: STATES

Keine.

Gerät "COMMANDS"

Geräte mit diesem Merkmal können auf Folgendes reagieren im Rahmen des EXECUTE-Vorgangs ausgeführt. Weitere Informationen Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Absichtliche Umsetzung.

action.devices.commands.ActivateScene

Aktivieren oder deaktivieren Sie eine Szene.

Parameter

Parameter Typ Beschreibung
deactivate Boolesch

Erforderlich.

„True“, um eine Szene abzubrechen, wenn sie umgedreht werden kann, „false“, um eine Szene zu aktivieren.

Beispiele

Aktiviere eine Szene anhand des Namens.

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

Deaktiviere eine Szene anhand des Namens.

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

Gerätefehler

Vollständige Liste der Fehler und Ausnahmen.