Smart-Home-Schalter für die Ausführung wechseln
action.devices.traits.Toggles
: Diese Eigenschaft gehört zu allen Geräten mit Einstellungen, die nur in einem von zwei Zuständen vorhanden sein können.
Diese Einstellungen können eine physische Schaltfläche mit einem aktivierten/deaktivierten bzw. aktiven/inaktiven Zustand, ein Kästchen in HTML oder eine andere Art von speziell aktiviertem/deaktiviertem Element sein. Wenn die Einstellung mehr als zwei Zustände hat oder einen Zustand hat, in dem keine der binären Optionen ausgewählt ist, wird sie besser als Eigenschaft Modi dargestellt, die der Mehrfachauswahl von Wahlmenüs, Optionsfeldern (physisch oder HTML) oder binären Zuständen, die nicht explizit aktiviert/deaktiviert sind (z. B. "AM/FM" oder "Hot/Kalt") entspricht.
Diese Eigenschaft deckt einen oder mehrere einzelne Schalter ab, die Nutzer festlegen können. Diese Ein-/Aus-Schaltflächen sollten im Allgemeinen für Funktionen verwendet werden, bei denen die Verknüpfung mit anderem Geräteverhalten nicht aufgehoben wurde. Verknüpftes Verhalten, z. B. das Ein- oder Ausschalten des Geräts, sollte spezifischere Merkmale verwenden, z. B. thermostatMode
im Attribut TemperatureSetting.
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 |
---|---|---|
availableToggles |
Array |
Erforderlich. Liste der verfügbaren Ein-/Aus-Schaltflächen. |
[item, ...] |
Objekt |
Ein-/Aus-Schaltfläche verfügbar. |
name |
String |
Erforderlich. Interner Name des Schalters, der in Befehlen und Status verwendet wird. Diese Funktion kann nicht nutzerfreundlich sein und wird in allen Sprachen verwendet. |
name_values |
Array |
Erforderlich. Synonyme für den Schalter in jeder unterstützten Sprache. |
[item, ...] |
Objekt |
Synonyme für den Schalter in einer bestimmten Sprache. |
name_synonym |
Array |
Erforderlich. Synonyme für die Ein-/Aus-Schaltfläche. Der erste String in dieser Liste wird als kanonischer Name der Ebene in dieser Sprache verwendet. |
[item, ...] |
String |
Synonym name. |
lang |
String |
Erforderlich. Sprachcode (ISO 639-1) Siehe unterstützte Sprachen. |
commandOnlyToggles |
Boolesch |
(Standard: Gibt an, ob das Gerät die Einweg- (wahr) oder Zwei-Wege-Kommunikation (falsch) unterstützt. Legen Sie dieses Attribut auf „true“ fest, wenn das Gerät für einen dieser Merkmale nicht auf einen QUERY-Intent oder einen Berichtsstatus reagieren kann. |
queryOnlyToggles |
Boolesch |
(Standard: Erforderlich, wenn das Gerät die Ausführung nur für Abfragen unterstützt. Dieses Attribut gibt an, ob das Gerät nur für Statusinformationen abgefragt werden kann und nicht gesteuert werden kann. |
Beispiele
Gerät mit Mehrfachschalter.
{ "availableToggles": [ { "name": "sterilization_toggle", "name_values": [ { "name_synonym": [ "clean", "bio clean" ], "lang": "en" } ] }, { "name": "energysaving_toggle", "name_values": [ { "name_synonym": [ "energy saving", "eco" ], "lang": "en" } ] } ] }
Gerät mit Ein-/Aus-Schaltflächen
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "filtered", "filter" ], "lang": "en" } ] } ], "commandOnlyToggles": true }
Gerät mit Ein-/Aus-Schaltflächen für Abfragen
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "filtered", "filter" ], "lang": "en" } ] } ], "queryOnlyToggles": true }
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 |
---|---|---|
currentToggleSettings |
Objekt |
Erforderlich. Schlüssel/Wert-Paar mit dem Schalter |
<string> |
Boolesch |
Aktueller Ein-/Aus-Status. |
Beispiele
Ist die Sterilisierung aktiviert?
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": 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.SetToggles
Legen Sie einen bestimmten Umschaltzustand fest.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
updateToggleSettings |
Objekt |
Erforderlich. Schlüssel/Wert-Paar mit dem Schalter |
<string> |
Boolesch |
Neuer Ein-/Aus-Status |
Beispiele
Schalte den Energiesparmodus ein.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "energysaving_toggle": true } } }
Filter deaktivieren.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "filter_toggle": false } } }
Beispieläußerungen
de-DE
-
Bitte schalte
Power Cool am Kühlschrank aus -
stelle
den Kühlschrank aufPower Cool
en-US
-
activate
power freeze forthe freezer -
cancel
power cool forthe kitchen fridge
es-ES
-
pon el
enfriamiento rápido enla nevera -
quita el
enfriamiento rápido
fr-FR
-
mets le mode
power cool surle réfrigérateur -
Éteins le mode
power freeze duréfrigérateur .
hi-IN
-
रेफ़्रिजरेटर कापावर कूल मोड बंद कर दो -
रेफ़्रिजरेटर मेंपावर कूल मोड चालू करो
it-IT
-
disattiva il
power freeze del freezer -
imposta la funzione
power freeze del surgelatore
ja-JP
-
冷蔵庫 の急速冷凍 つけて -
冷蔵庫 の急速冷凍 を切ってくれる
ko-KR
-
냉장고 급속 냉장 해제해 -
냉장고 모드급속 냉장 으로 바꿔
nl-NL
-
Zet
de power cool uit opde koelkast -
zet
de koelkast opsuperkoelen
pt-BR
-
Ativa a função
power freeze nocongelador . -
Desativa o
bloqueio infantil doforno . -
desligar o
power cool dageladeira -
iniciar o modo
power freeze dofreezer
sv-SE
-
Stäng av
power cool ikylskåpet -
sätt på
power freeze påfrysen