Schemat trait trybów inteligentnego domu
action.devices.traits.Modes
– ta cecha obejmuje wszystkie dostępne tryby i ustawienia specyficzne dla danego urządzenia.
Ta cecha należy do urządzeń z dowolną liczbą trybów „n-way”, w których tryby i ustawienia poszczególnych trybów są dowolne i unikalne dla każdego urządzenia lub typu urządzenia. Każdy tryb ma wiele możliwych ustawień, ale w danym momencie można wybrać tylko jedno – suszarka nie może jednocześnie pracować w trybie „delikatnym”, „normalnym” i „o dużym stopniu intensywności”. Ustawienie, które można łatwo włączyć lub wyłączyć, należy do cechy Toggles.
Na przykład pralka może mieć ustawienia rozmiaru wsadu i temperatury. Oba te tryby są niezależne od siebie, ale w danym momencie każdy z nich może mieć tylko jeden stan. Użytkownik może bezpośrednio ustawić tryb, na przykład temperaturę, używając polecenia takiego jak Ustaw temperaturę pralki na zimno.
Niektóre tryby są uporządkowane, a także można je regulować w górę i w dół, zwiększając lub zmniejszając poziom dźwięku. Na przykład rozmiar ładunku (mały, średni, duży) i temperatura są wyraźnie uporządkowane (pamiętaj, że temperatura nie jest rzeczywistym termostatem z liczbą docelową, jak w przypadku innych urządzeń), ale typ obciążenia (delikatne, normalne, wełna itp.) może już nie być.
Ta cecha obejmuje 1 lub więcej indywidualnych trybów, które użytkownicy mogą ustawić. Ogólnie tryby te powinny być używane w przypadku funkcji, które są odłączone od działania innych urządzeń. Powiązane działania, takie jak włączanie lub wyłączanie urządzenia, powinny wykorzystywać bardziej szczegółowe 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 |
---|---|---|
availableModes |
Tablica |
Wymagane. Lista dostępnych trybów. |
[item, ...] |
Obiekt |
Tryb dostępności. |
name |
String |
Wymagane. Wewnętrzna nazwa trybu, 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 trybu w poszczególnych obsługiwanych językach. |
[item, ...] |
Obiekt |
Synonimy trybu w danym języku. |
name_synonym |
Tablica |
Wymagane. Synonimy trybu. 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. |
settings |
Tablica |
Wymagane. Ustawienia obsługiwane w tym trybie. |
[item, ...] |
Obiekt |
Obsługiwane ustawienie. Wymaga co najmniej 2 elementów. |
setting_name |
String |
Wymagane. Wewnętrzna nazwa ustawienia trybu, 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. |
setting_values |
Tablica |
Wymagane. Synonimy ustawienia w każdym obsługiwanym języku. |
[item, ...] |
Obiekt |
Synonimy ustawienia w danym języku. |
setting_synonym |
Tablica |
Wymagane. Synonimy ustawienia. 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. |
ordered |
Wartość logiczna |
(Domyślnie: Jeśli zasada ma wartość Prawda, dodatkowa gramatyka dla logiki zwiększania/zmniejszania jest stosowana w kolejności (rosnącej) w tablicy ustawień. |
commandOnlyModes |
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. |
queryOnlyModes |
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 trybami i ustawieniami.
{ "availableModes": [ { "name": "load_mode", "name_values": [ { "name_synonym": [ "Load", "Size", "Load size" ], "lang": "en" } ], "settings": [ { "setting_name": "small_load", "setting_values": [ { "setting_synonym": [ "Small", "Half" ], "lang": "en" } ] }, { "setting_name": "medium_load", "setting_values": [ { "setting_synonym": [ "Medium", "Normal" ], "lang": "en" } ] }, { "setting_name": "large_load", "setting_values": [ { "setting_synonym": [ "Large", "Full" ], "lang": "en" } ] } ], "ordered": true }, { "name": "temp_mode", "name_values": [ { "name_synonym": [ "Temperature", "Temp" ], "lang": "en" } ], "settings": [ { "setting_name": "hot_temp", "setting_values": [ { "setting_synonym": [ "Hot", "White" ], "lang": "en" } ] }, { "setting_name": "warm_temp", "setting_values": [ { "setting_synonym": [ "Warm", "Color" ], "lang": "en" } ] }, { "setting_name": "cold_temp", "setting_values": [ { "setting_synonym": [ "Cold", "Delicate" ], "lang": "en" } ] } ], "ordered": false } ] }
Urządzenie obsługujące tryby tylko polecenia.
{ "availableModes": [ { "name": "light_mode", "name_values": [ { "name_synonym": [ "Light", "Lighting" ], "lang": "en" } ], "settings": [ { "setting_name": "day_light", "setting_values": [ { "setting_synonym": [ "Day", "Bright" ], "lang": "en" } ] }, { "setting_name": "night_light", "setting_values": [ { "setting_synonym": [ "Night", "Dark" ], "lang": "en" } ] }, { "setting_name": "reading_light", "setting_values": [ { "setting_synonym": [ "Reading", "Ambiant" ], "lang": "en" } ] } ], "ordered": false } ], "commandOnlyModes": true, "queryOnlyModes": false }
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 |
---|---|---|
currentModeSettings |
Obiekt |
Wymagane. Para klucz/wartość z trybem |
<string> |
String |
Obecnie |
Przykłady
W jakim trybie jest włączone urządzenie?
{ "currentModeSettings": { "load_mode": "small_load", "temp_mode": "cold_temp" } }
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.SetModes
Zaktualizuj ustawienia trybu.
Parametry
Parametry | Typ | Opis |
---|---|---|
updateModeSettings |
Obiekt |
Wymagane. Para klucz/wartość z trybem |
<string> |
String |
Nowy |
Przykłady
Ustaw duże obciążenie.
{ "command": "action.devices.commands.SetModes", "params": { "updateModeSettings": { "load_mode": "large_load" } } }
Przykładowe wypowiedzi
de-DE
- Stelle den Staubsauger auf Ruhemodus
en-US
- set the vacuum to energy saver mode
es-ES
- pon la lavadora en modo frío
fr-FR
- mets l'aspirateur en silencieux
hi-IN
- वैक्यूम पर कार्पेट मोड लगाएं
it-IT
- imposta l'aspirapolvere su silenzioso
ja-JP
- 掃除機 を 静音 モードに設定して
ko-KR
- 세탁기 세탁량 많음 으로 설정해
pt-BR
- acionar a função autolimpeza do aspirador
- ligar o modo de aquecimento