Schema für Smart-Home-Szeneneigenschaften

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

Weitere Informationen finden Sie in der Anleitung zum Szenentyp.

Wenn Nutzer auf einem Gerät beispielsweise Befehle mit nur einer Berührung konfigurieren können, um Lampen auf bestimmte Farben einzustellen oder verschiedene Sicherheitsfunktionen zu sequenzieren oder eine beliebige andere Kombination von Aktivitäten auszuführen, kann diese Konfiguration über SYNC als benannte Szene bereitgestellt werden. Assistant stellt Nutzern diese Szenen dann über eine einfache Aktivierungsgrammatik zur Verfügung:

  • Partymodus starten
  • Aktiviere die Mitternachtsszene.

Als virtuelle Objekte können Szenen zur Unterscheidung in Räumen (falls relevant) platziert werden:

  • Partyzeit in der Küche starten
  • Aktiviere den Nachtsichtmodus in den Schlafzimmern.

Ein Unterschied zwischen Szenen und physischen Zielen besteht darin, dass Assistant automatisch Pluraleffekte auf Scene-Befehle anwendet, sodass Nutzer Szenen über mehrere Partner hinweg auslösen können. Wenn ein Nutzer beispielsweise eine Partymodus-Szene mit zwei verschiedenen Partnern hat, einen für die Sicherheit und einen für Lampen, werden beide durch Partymodus aktivieren ausgelöst.

Szenen werden gut mit zukünftigen persönlichen Aktionen für benutzerdefinierte Grammatik interagieren (z. B. Partymodus aktivieren -> Los gehts!).

Szenen sollten immer vom Nutzer vergebene Namen haben, anstatt die Standardbenennung „BobCo Scene“ zu verwenden. Jede Szene ist ein eigenes virtuelles Gerät mit eigenen Namen. Von Nutzern angegebene Namen können aus SYNC stammen.

Geräte-ATTRIBUTE

Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des SYNC-Vorgangs. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute Typ Beschreibung
sceneReversible Boolesch

(Standard: false)

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

Beispiele

Gerät, das eine umkehrbare Szene unterstützt

{
  "sceneReversible": true
}

Gerät STATES

Keine.

BEFEHLE auf Gerät

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-Auftragsausfü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 anhand des Namens aktivieren

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

Eine Szene anhand des Namens deaktivieren.

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

Gerät ERRORS

Sehen Sie sich die vollständige Liste der Fehler und Ausnahmen an.