Smart Home schaltet Trait-Schema ein/aus
action.devices.traits.Toggles
: Diese Trait gehört zu allen Geräten, deren Einstellungen nur einen von zwei Status haben.
Diese Einstellungen können eine physische Schaltfläche mit einem Ein/Aus oder Aktiv/Inaktiv-Status, ein Kästchen in HTML oder ein anderes speziell aktiviertes/deaktiviertes Element sein. Wenn die Einstellung mehr als zwei Zustände hat oder einen Status hat, in dem keine der binären Optionen ausgewählt ist, wird sie besser als Modes-Merkmal dargestellt. Diese Eigenschaft entspricht Drehknöpfen mit mehreren Zuständen, Optionsfeldern (physisch oder HTML) oder binären Zuständen, die nicht explizit ein-/ausgeschaltet sind (z. B. „AM/FM“ oder „heiß/kalt“).
Diese Trait umfasst eine oder mehrere einzelne Ein-/Aus-Schaltflächen, die Nutzer festlegen können. Im Allgemeinen sollten diese Ein-/Aus-Schaltflächen für Funktionen verwendet werden, die nicht mit anderen Geräteverhalten verknüpft sind. Bei verknüpften Verhaltensmustern, z. B. beim Ein- oder Ausschalten des Geräts, sollten spezifischere Eigenschaften verwendet werden (z. B. thermostatMode
im Trait TemperatureSetting).
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 |
---|---|---|
availableToggles |
Array |
Erforderlich. Liste der verfügbaren Ein-/Aus-Schaltflächen. |
[item, ...] |
Objekt |
Ein-/Aus-Schaltfläche für „Verfügbar“. |
name |
String |
Erforderlich. Interner Name der Ein-/Aus-Schaltfläche, der in Befehlen und Status verwendet wird. Diese Option ist möglicherweise nicht nutzerfreundlich und wird für alle Sprachen verwendet. |
name_values |
Array |
Erforderlich. Synonyme der Ein-/Aus-Schaltfläche in den einzelnen unterstützten Sprachen. |
[item, ...] |
Objekt |
Synonyme der Ein-/Aus-Schaltfläche 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). Weitere Informationen zu unterstützten Sprachen |
commandOnlyToggles |
Boolesch |
(Standard: Gibt an, ob das Gerät die unidirektionale (wahr) oder die bidirektionale (falsche) Kommunikation unterstützt. Setze dieses Attribut auf „true“, wenn das Gerät für diese Eigenschaft nicht auf einen QUERY-Intent oder 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 vom Gerät nur Statusinformationen abgefragt und nicht gesteuert werden können. |
Beispiele
Gerät mit Mehrfach-Ein-/Aus-Schaltfläche.
{ "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 nur mit Befehl.
{ "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
Entitäten mit diesem Trait können die folgenden Status im Rahmen des QUERY
-Vorgangs 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 der Ein-/Aus-Schaltfläche |
<string> |
Boolesch |
Aktueller Status der Ein-/Aus-Schaltfläche. |
Beispiele
Ist die Sterilisation eingeschaltet?
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
BEFEHLE auf dem Gerät
Geräte mit dieser Eigenschaft können im Rahmen des EXECUTE
-Vorgangs 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 Schalterstatus fest.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
updateToggleSettings |
Objekt |
Erforderlich. Schlüssel/Wert-Paar mit der Ein-/Aus-Schaltfläche |
<string> |
Boolesch |
Neue Ein-/Aus-Schaltfläche |
Beispiele
Aktiviere den Energiesparmodus.
{ "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 auf Power Cool
en-US
- activate power freeze for the freezer
- cancel power cool for the kitchen fridge
es-ES
- pon el enfriamiento rápido en la nevera
- quita el enfriamiento rápido
fr-FR
- mets le mode power cool sur le réfrigérateur
- Éteins le mode power freeze du ré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 op de koelkast
- zet de koelkast op superkoelen
pt-BR
- Ativa a função power freeze no congelador .
- Desativa o bloqueio infantil do forno .
- desligar o power cool da geladeira
- iniciar o modo power freeze do freezer
sv-SE
- Stäng av power cool i kylskåpet
- sätt på power freeze på frysen