Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Smart-Home-Aktionen. Hinweis:Sie erstellen weiterhin Aktionen in der Actions Console.
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

OnOff Trait-Schema für Smart Home

action.devices.traits.OnOff: Die Grundfunktionen für alle Geräte mit Binärprogrammen für Ein- und Ausschalten, einschließlich Steckdosen und Schaltern, sowie für viele zukünftige Geräte.

Gerät ATTRIBUTE

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

Attribute Typ Beschreibung
commandOnlyOnOff Boolesch

(Standard: false)

Gibt an, ob das Gerät nur über Befehle gesteuert werden kann und keine Statusinformationen abgefragt werden kann.

queryOnlyOnOff Boolesch

(Standard: false)

Gibt an, ob das Gerät nur nach Statusinformationen abgefragt werden kann und nicht über Befehle gesteuert werden kann.

Beispiele

Gerät, das den Befehl „An/Aus“ und „Berichterstellung“ unterstützt.

{
  "commandOnlyOnOff": false,
  "queryOnlyOnOff": false
}

Gerät, das nur Ein-/Aus-Befehle unterstützt.

{
  "commandOnlyOnOff": true,
  "queryOnlyOnOff": false
}

Gerät (normalerweise ein Sensor), das nur die Berichterstellung zum Ein/Aus ermöglicht.

{
  "queryOnlyOnOff": true,
  "commandOnlyOnOff": false
}

Gerät STATES

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

Bundesstaaten Typ Beschreibung
on Boolesch

Gibt an, ob ein Gerät mit einem An-/Aus-Schalter ein- oder ausgeschaltet ist.

Beispiele

Ist das Gerät eingeschaltet?

{
  "on": true
}

Ist das Gerät ausgeschaltet?

{
  "on": false
}

Gerätebefehle

Geräte mit diesem Attribut 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.OnOff

Schalten Sie das Gerät ein oder aus.

Parameter

Parameter Typ Beschreibung
on Boolesch

Erforderlich.

Gibt an, ob das Gerät ein- oder ausgeschaltet werden soll.

Beispiele

Schalte das Gerät ein.

{
  "command": "action.devices.commands.OnOff",
  "params": {
    "on": true
  }
}

Schalte das Gerät aus.

{
  "command": "action.devices.commands.OnOff",
  "params": {
    "on": false
  }
}

Beispieläußerungen

de-DE

  • Bitte Licht aus
  • Bitte das Wohnzimmer aktivieren
  • Bitte die Küche ausstellen
  • Lampen ein

en-US

  • Schalte die Klimaanlage ab
  • meine Lampen einschalten

es-ES

  • enciende el robot de limpieza
  • Enciéndeme El Salón

fr-FR

  • Tu peux éteindre le salon ?
  • Allume la chambre
  • allume les lumières
  • éteins les lumières

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen