Schemat cechy trybów inteligentnego domu
action.devices.traits.Modes – ta cecha obejmuje wszystkie dostępne tryby i ustawienia urządzenia.
Ta cecha należy do dowolnych urządzeń z dowolną liczbą „n-way” tryby, w których tryby i ustawienia każdego z nich są dowolne i różnią się od rodzaju urządzenia. Każdy tryb ma wiele możliwych ustawień, ale w danym momencie możesz wybrać tylko jedno. suszarka nie może muszą być „delikatne”, „normalne”, i „ciężka” jednocześnie. Ustawienie, które po prostu Możliwość włączenia lub wyłączenia należy do cechy Toggles.
Na przykład pralka może mieć ustawienia rozmiaru ładunków i temperatury. Są to tryby, ponieważ są od siebie niezależne, ale każdy może znajdować się tylko w jednym stanie naraz. Użytkownik może ustawić tryb, taki jak bezpośrednio, używając polecenia takiego jak Ustaw temperaturę pralki na „zimno”.
Niektóre środki transportu są „uporządkowane” i można je również regulować za pomocą strzałek w górę i w dół, zwiększanie/zmniejszanie wymowy. Na przykład rozmiar wczytywanych elementów (mały, średni, duży) temperatura jest wyraźnie uporządkowana (pamiętaj, że nie jest to rzeczywista wartość termostatu z wartością docelową, tak jak w przypadku innych urządzeń, ale typem obciążenia (delikatne tkaniny, zwykłe, wełny itd.) mogą nie być.
Ta cecha obejmuje co najmniej 1 tryb, który użytkownicy mogą ustawić. Ogólnie rzecz biorąc,
trybów tych należy używać w przypadku funkcji, które nie są połączone z innym urządzeniem.
zachowanie użytkownika. Powiązane działania, takie jak włączanie i wyłączanie urządzenia, powinny
używać bardziej konkretnych cech (np. thermostatMode w
cecha TemperatureSetting).
Urządzenia – ATTRIBUTES
Urządzenia z tą cechą mogą zgłaszać te problemy
jako część operacji SYNC. Aby się uczyć
więcej informacji o obsłudze intencji SYNC znajdziesz tutaj
Realizacja intencji.
| Atrybuty | Typ | Opis |
|---|---|---|
availableModes |
Tablica |
Wymagane. Lista dostępnych środków transportu. |
[item, ...] |
Obiekt. |
Tryb „Dostępny”. |
name |
String |
Wymagane. Wewnętrzna nazwa trybu, która będzie używana w poleceniach i stanach. Może być on nieprzyjazny dla użytkownika i będzie udostępniany we wszystkich językach. |
name_values |
Tablica |
Wymagane. Synonimy trybu w każdym obsługiwanym języku. |
[item, ...] |
Obiekt. |
Synonimy trybu w danym języku. |
name_synonym |
Tablica |
Wymagane. Synonimy trybu. Pierwszy ciąg na liście jest używany jako kanoniczna nazwa 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. Może być on nieprzyjazny 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 na liście jest używany jako kanoniczna nazwa 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, logika zwiększania/zmniejszania gramatyki jest stosowana w kolejności rosnącej/malejącej w 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 reagować na intencję QUERY ani stan raportu dla tej cechy. |
queryOnlyModes |
Wartość logiczna |
(Domyślnie: Wymagane, jeśli urządzenie obsługuje tylko wykonywanie zapytań. Ten atrybut wskazuje, że do urządzenia można wysyłać zapytania tylko w celu uzyskania informacji o stanie i nie można 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 w trybie „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
Jednostki o tej cechie mogą zgłaszać:
stanów w ramach operacji QUERY. Aby się uczyć
więcej informacji o obsłudze intencji QUERY znajdziesz tutaj
Realizacja intencji.
| Stany | Typ | Opis |
|---|---|---|
currentModeSettings |
Obiekt. |
Wymagane. Para klucz-wartość z trybem |
<string> |
String |
Obecnie |
Przykłady
W jakim trybie działa urządzenie?
{
"currentModeSettings": {
"load_mode": "small_load",
"temp_mode": "cold_temp"
}
}
Polecenia na urządzeniu
Urządzenia z tą cechą mogą reagować na:
w ramach operacji EXECUTE. Aby się uczyć
więcej informacji o obsłudze intencji EXECUTE znajdziesz tutaj
Realizacja 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