Inteligentny dom przełącza schemat trait
action.devices.traits.Toggles
– ta cecha należy do wszystkich urządzeń z ustawieniami, które mogą występować tylko w jednym z 2 stanów.
Ustawienia te mogą reprezentować przycisk fizyczny ze stanem „wł./wył.” lub „aktywny/nieaktywny”, pole wyboru w kodzie HTML lub dowolny inny rodzaj wyraźnie aktywnego/wyłączonego elementu. Jeśli ustawienie ma więcej niż 2 stany lub stan, w którym żadna z opcji binarnych nie jest wybrana, lepiej to przedstawić jako cechę Modes, co oznacza tarczę wielostanową, przyciski radiowe (fizyczne lub HTML) lub stany binarne, które nie są wyraźnie włączone/wyłączone (np. „AM/FM” lub „zimne”).
Ta cecha obejmuje 1 lub więcej indywidualnych przełączników, które użytkownik może ustawić. Ogólnie przełączniki te powinny być używane w przypadku funkcji, które nie są powiązane z innym działaniem urządzenia. Powiązane zachowania, takie jak włączanie lub wyłączanie urządzenia, powinny wykorzystywać bardziej konkretne cechy (na przykład thermostatMode
w cechu TemperatureSetting).
Urządzenie ATTRIBUTES
Urządzenia z tą cechą mogą zgłaszać poniższe atrybuty w ramach operacji SYNC
. Więcej informacji o obsłudze intencji SYNC
znajdziesz w artykule o realizacji intencji.
Atrybuty | Typ | Opis |
---|---|---|
availableToggles |
Tablica |
Wymagane. Lista dostępnych przełączników. |
[item, ...] |
Obiekt |
Przełącznik dostępnych. |
name |
String |
Wymagane. Wewnętrzna nazwa przełącznika, która będzie używana w poleceniach i stanach. Tekst ten może nie być przyjazny dla użytkownika i będzie udostępniany we wszystkich językach. |
name_values |
Tablica |
Wymagane. Synonimy przełącznika w poszczególnych obsługiwanych językach. |
[item, ...] |
Obiekt |
Synonimy przełącznika w danym języku. |
name_synonym |
Tablica |
Wymagane. Synonimy przełącznika. Pierwszy ciąg znaków na liście jest używany jako nazwa kanoniczna poziomu w danym języku. |
[item, ...] |
String |
Nazwa synonimu. |
lang |
String |
Wymagane. Kod języka (ISO 639-1). Zobacz obsługiwane języki. |
commandOnlyToggles |
Wartość logiczna |
(Domyślnie: Określa, czy urządzenie obsługuje komunikację jednokierunkową (prawda) czy dwukierunkową (fałsz). Ustaw ten atrybut na wartość true, jeśli urządzenie nie może odpowiedzieć na intencję QUERY lub stan raportu w przypadku tej cechy. |
queryOnlyToggles |
Wartość logiczna |
(Domyślnie: Wymagane, jeśli urządzenie obsługuje tylko wykonywanie zapytań. Ten atrybut wskazuje, czy urządzenie może być wywoływane tylko przez informacje o stanie i nie może nim sterować. |
Przykłady
Urządzenie z wieloma przełącznikami.
{ "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" } ] } ] }
Urządzenie z przełącznikami umożliwiającymi tylko wykonywanie poleceń.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "commandOnlyToggles": true }
Urządzenie z przełącznikami typu „tylko zapytanie”.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "queryOnlyToggles": true }
Urządzenie STATES
Encje z tą cechą mogą zgłaszać poniższe stany w ramach operacji QUERY
. Więcej informacji o obsłudze intencji QUERY
znajdziesz w artykule o realizacji intencji.
Stany | Typ | Opis |
---|---|---|
currentToggleSettings |
Obiekt |
Wymagane. Para klucz/wartość z przełącznikiem |
<string> |
Wartość logiczna |
Obecny stan przełączania. |
Przykłady
Czy sterylizacja jest włączona?
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
CommandS na urządzeniu
Urządzenia z tą cechą mogą reagować na podane niżej polecenia w ramach operacji EXECUTE
. Więcej informacji o obsłudze intencji EXECUTE
znajdziesz w artykule o realizacji intencji.
action.devices.commands.SetToggles
Ustaw dany stan przełączania.
Parametry
Parametry | Typ | Opis |
---|---|---|
updateToggleSettings |
Obiekt |
Wymagane. Para klucz/wartość z przełącznikiem |
<string> |
Wartość logiczna |
Nowy stan przełączania |
Przykłady
Włącz Oszczędzanie energii.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "energysaving_toggle": true } } }
Wyłącz filtr.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "filter_toggle": false } } }
Przykładowe wypowiedzi
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