Schema der Smart Home-Szene

action.devices.traits.Scene: Mit dieser Eigenschaft werden virtuelle Geräte zusammen mit dem Gerätetyp „SCENE“ implementiert.

Weitere Informationen finden Sie im Leitfaden zu Szenentypen.

Wenn Nutzer auf einem Gerät z. B. Befehle mit nur einer Berührung konfigurieren können – beispielsweise können die Lichter auf bestimmte Farben festgelegt oder verschiedene Sicherheitsfunktionen oder andere Aktivitäten ausgeführt werden –, kann diese Konfiguration über SYNC als benannte Szene bereitgestellt werden.

  • Partymodus starten
  • Mitternachtsszenen aktivieren.

Virtuelle Objekte können zum Zweck der Unterscheidung in Räumen platziert werden:

  • Partyzeit in der Küche beginnen
  • Aktiviere den Nachtlichtmodus in den Schlafzimmern.

Ein Unterschied zwischen Szenen und physischen Zielen besteht darin, dass Assistant automatisch Pluraleffekte auf Befehle in Szenen anwenden kann, sodass Nutzer Szenen über mehrere Partner hinweg auslösen können. Wenn ein Nutzer beispielsweise eine Szene im „Partymodus“ von zwei verschiedenen Partnern hat, einen für die Sicherheit und einen für die Beleuchtung, wird durch den Partymodus aktivieren beides ausgelöst.

Szenen interagieren mit anstehenden persönlichen Aktionen für benutzerdefinierte Grammatik, z. B. Partymodus aktivieren -> Lass uns die Party beginnen!.

Szenen sollten immer vom Nutzer bereitgestellte Namen haben und die Standardbezeichnung „BobCo Scene“ verwenden. Jede Szene ist mit einem eigenen virtuellen Gerät und eigenen Namen ausgestattet. Von Nutzern übermittelte Namen können von SYNC stammen.

Geräte-ATTRIBUTE

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

Attribute Typ Beschreibung
sceneReversible Boolesch

(Standard: false)

Gibt an, dass die Szene abgebrochen werden kann. Dieses Attribut ist nur für Szenen relevant, die den Zustand ändern und sich an den vorherigen Zustand erinnern. Das Gerät unterstützt den Befehl ActivateScene mit dem Parameter deactivate auf „true“.

Beispiele

Gerät, das eine reversible Szene unterstützt.

{
  "sceneReversible": true
}

Gerätestatus

Keine.

BEISPIELE für Geräte

Geräte mit diesem Merkmal können im Rahmen des EXECUTE-Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zum Verarbeiten von EXECUTE-Intents finden Sie unter Intent-Auftragsausführung.

action.devices.commands.ActivateScene

Szene aktivieren oder deaktivieren

Parameter

Parameter Typ Beschreibung
deactivate Boolesch

Erforderlich.

Dieser Wert ist „true“, um eine Szene abzubrechen, wenn sie rückgängig gemacht werden kann, und „false“, um eine Szene zu aktivieren.

Beispiele

Aktivieren Sie eine Szene anhand des Namens.

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

Szene mit Namen deaktivieren:

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

Gerät ERRORS

Hier finden Sie die vollständige Liste der Fehler und Ausnahmen.