Schemat inteligentnego przełącznika domu
action.devices.traits.Toggles
– ten atrybut należy do każdego urządzenia, którego ustawienia mogą istnieć tylko w jednym z 2 stanów.
Ustawienia te mogą reprezentować fizyczny przycisk ze stanem włączenia/wyłączenia, stanem aktywnym lub nieaktywnym, polem wyboru w kodzie HTML lub dowolnym innym elementem, który jest wyraźnie włączony lub wyłączony. Jeśli ustawienie zawiera więcej niż 2 stany lub ma stan, w którym nie wybrano żadnej z opcji binarnych, lepiej jest określić go za pomocą opcji Tryby, która odpowiada skrótom wielostanowym, przyciskom radiowym (fizycznym lub HTML) bądź stanom binarnym, które nie są jednoznacznie włączone/wyłączone (np. „AM/FM” lub „gorące/zimne”).
Ta cecha obejmuje co najmniej jeden przełącznik, który użytkownicy mogą ustawić. Ogólnie przełączniki powinny służyć do obsługi funkcji, które nie są powiązane z innym działaniem urządzenia. Połączone zachowanie, na przykład włączanie i wyłączanie urządzenia, powinno korzystać z bardziej szczegółowych cech (np. thermostatMode
w typie TemperatureSetting).
ATRYBUTY urządzenia
W ramach operacji SYNC
urządzenia z tą cechą mogą zgłaszać wymienione poniżej atrybuty. Więcej informacji o obsłudze intencji SYNC
znajdziesz w sekcji Realizacja intencji.
Atrybuty | Typ | Opis |
---|---|---|
availableToggles |
Tablica |
Wymagany. Lista dostępnych przełączników. |
[item, ...] |
Obiekt |
Przełącznik jest dostępny. |
name |
Ciąg |
Wymagany. Wewnętrzna nazwa przełącznika, która będzie używana w poleceniach i stanach. Może nie być odpowiedni dla użytkowników i będzie dostępny we wszystkich językach. |
name_values |
Tablica |
Wymagany. Synonimy przełącznika w każdym obsługiwanym języku. |
[item, ...] |
Obiekt |
Synonimy przełącznika w danym języku. |
name_synonym |
Tablica |
Wymagany. Synonimy przełącznika. Pierwszy ciąg znaków z tej listy jest używany jako kanoniczna nazwa poziomu w danym języku. |
[item, ...] |
Ciąg |
Nazwa synonimu. |
lang |
Ciąg |
Wymagany. Kod języka (ISO 639-1). Zobacz obsługiwane języki. |
commandOnlyToggles |
Wartość logiczna |
(domyślnie: Wskazuje, 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 tego atrybutu. |
queryOnlyToggles |
Wartość logiczna |
(domyślnie: Wymagane, jeśli urządzenie obsługuje wykonywanie tylko zapytań. Ten atrybut wskazuje, że do urządzenia można wysyłać zapytania tylko o informacje o stanie i nie można nim sterować. |
Przykłady
Urządzenie z kilkoma 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 poleceń.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "commandOnlyToggles": true }
Urządzenie z przełącznikami umożliwiającymi tylko wyświetlanie zapytań.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "queryOnlyToggles": true }
Urządzenie STATES
W ramach operacji QUERY
encje o tym atrybucie mogą raportować te stany. Więcej informacji o obsłudze intencji QUERY
znajdziesz w sekcji Realizacja intencji.
Stany | Typ | Opis |
---|---|---|
currentToggleSettings |
Obiekt |
Wymagany. Para klucz/wartość używa przełącznika |
<string> |
Wartość logiczna |
Bieżący stan przełącznika. |
Przykłady
Czy sterylizacja jest włączona?
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
Polecenie urządzenia
W ramach operacji EXECUTE
urządzenia z tą cechą mogą odpowiadać na podane niżej polecenia. Więcej informacji o obsłudze intencji EXECUTE
znajdziesz w sekcji Realizacja intencji.
action.devices.commands.SetToggles
Ustaw dany stan przełącznika.
Parametry
Parametry | Typ | Opis |
---|---|---|
updateToggleSettings |
Obiekt |
Wymagany. Para klucz-wartość zawiera przełącznik |
<string> |
Wartość logiczna |
Nowy stan przełącznika |
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 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