Schemat Inteligentnego trybu domu
action.devices.traits.Modes
– ten atrybut obejmuje wszystkie dostępne tryby i ustawienia trybu urządzenia.
Ta cecha należy do każdego urządzenia z dowolną liczbą trybów „n-way”, w której tryby i ustawienia dla każdego z nich mogą być inne i niepowtarzalne dla każdego urządzenia lub typu urządzenia. Każdy tryb może mieć wiele ustawień, ale tylko jeden może być wybierany naraz. Suszarka nie może działać w trybie „delikatnym”, „normalnym” i „intensywnym” (jednocześnie). Ustawienie, które można łatwo włączyć lub wyłączyć, należy do kategorii Przełączniki.
Pralka może na przykład mieć ustawienia rozmiaru i temperatury wczytywania. Oba te tryby są niezależne od siebie, ale mogą występować tylko w jednym stanie. Użytkownik może ustawić tryb taki jak temperatura, używając polecenia takiego jak Ustaw temperaturę prania na zimno.
Niektóre tryby są „uporządkowane” i można je dostosowywać, zwiększając lub zmniejszając szczegółowość. Na przykład rozmiar obciążenia (mały, średni, duży) i temperatura są wyraźnie podane (uwaga: temperatura nie jest wartością termiczną z celem liczbowym, jak na innych urządzeniach), ale typ wczytywania (delikatne, normalne, wełna itp.) może nie być regulowany.
Ta cecha obejmuje co najmniej jeden tryb, który może skonfigurować użytkownik. Ogólnie tych trybów należy używać w przypadku funkcji, które nie są powiązane z innym zachowaniem 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 |
---|---|---|
availableModes |
Tablica |
Wymagany. Lista dostępnych trybów. |
[item, ...] |
Obiekt |
Tryb dostępny. |
name |
Ciąg |
Wymagany. Wewnętrzna nazwa trybu, 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 trybu w każdym obsługiwanym języku. |
[item, ...] |
Obiekt |
Synonimy trybu w danym języku. |
name_synonym |
Tablica |
Wymagany. Synonimy trybu. 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. |
settings |
Tablica |
Wymagany. Obsługiwane ustawienia tego trybu. |
[item, ...] |
Obiekt |
Obsługiwane ustawienie. Wymagany jest co najmniej 2 elementy. |
setting_name |
Ciąg |
Wymagany. Wewnętrzna nazwa ustawienia trybu, które będzie używane w poleceniach i stanach. Może nie być odpowiedni dla użytkowników i będzie dostępny we wszystkich językach. |
setting_values |
Tablica |
Wymagany. Synonimy ustawienia w każdym obsługiwanym języku. |
[item, ...] |
Obiekt |
Synonimy ustawienia w danym języku. |
setting_synonym |
Tablica |
Wymagany. Synonimy ustawienia. 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. |
ordered |
Wartość logiczna |
(domyślnie: Jeśli zasada ma wartość Prawda, obowiązuje gramatyka dodatkowa w celu zwiększenia lub zmniejszania wartości w kolejności (rosnąco) tablicy ustawień. |
commandOnlyModes |
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. |
queryOnlyModes |
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 różnymi 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 w trybie poleceń.
{ "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
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 |
---|---|---|
currentModeSettings |
Obiekt |
Wymagany. Para klucz-wartość korzysta z trybu |
<string> |
Ciąg |
Obecnie |
Przykłady
W jakim trybie jest urządzenie?
{ "currentModeSettings": { "load_mode": "small_load", "temp_mode": "cold_temp" } }
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.SetModes
Zaktualizuj ustawienia trybu.
Parametry
Parametry | Typ | Opis |
---|---|---|
updateModeSettings |
Obiekt |
Wymagany. Para klucz-wartość korzysta z trybu |
<string> |
Ciąg |
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 aufRuhemodus
en-US
-
set
the vacuum toenergy saver mode
es-ES
-
pon
la lavadora en modofrío
fr-FR
-
mets
l'aspirateur ensilencieux
hi-IN
-
वैक्यूम परकार्पेट मोड लगाएं
it-IT
-
imposta
l'aspirapolvere susilenzioso
ja-JP
-
掃除機 を静音 モードに設定して
ko-KR
-
세탁기 세탁량 많음 으로 설정해
pt-BR
-
acionar a função
autolimpeza doaspirador -
ligar o modo de
aquecimento