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 im Rahmen des Vorgangs SYNC die folgenden Attribute 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 einschalten
  • Bitte die Küche ausstellen
  • Lampen an

en-US

  • turn off the AC
  • turn on my lights

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

hi-IN

  • किचन को ऑन करो
  • बत्तियाँ जला दें
  • बालकनी ऑफ कर दो
  • लाइट ऑफ करो

it-IT

  • Accendimi la luce in cucina
  • accendere in cucina
  • spegni la luce della camera
  • spengi camera bimbi

ja-JP

  • ベッドルーム をつけて
  • リビング をオフにして
  • 照明 をオンにして
  • 照明 を消して

ko-KR

  • 거실 꺼 줘
  • 거실 에어컨 전원 켜
  • 거실 켜 줘
  • 에어컨 전원 꺼 줘

nl-NL

  • babykamer aandoen
  • doe het licht aan
  • doe het licht uit

pt-BR

  • Acender a luz .
  • Apagar a luz .
  • acender a sala
  • quero desligar o quarto

sv-SE

  • stäng av lampan
  • sätt på ljuset

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen