Schemat funkcji sterowania szybkością wentylatora inteligentnego domu
action.devices.traits.FanSpeed
– ta cecha należy do urządzeń, które umożliwiają ustawianie prędkości wentylatora.
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 |
---|---|---|
reversible |
Wartość logiczna |
(Domyślnie: Jeśli zasada ma wartość Prawda, urządzenie obsługuje dmuchanie wentylatora w obu kierunkach i może przyjmować polecenie odwrotnego kierunku wentylatora. |
commandOnlyFanSpeed |
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. |
Zawiera następujące produkty: | ||
0
|
Obiekt |
Obsługa ustawień szybkości. |
availableFanSpeeds |
Obiekt |
Wymagane. Ustawienia szybkości obsługiwane przez urządzenie. |
speeds |
Tablica |
Wymagane. Lista ustawień szybkości. |
[item, ...] |
Obiekt |
Ustawienie prędkości. |
speed_name |
String |
Wymagane. Wewnętrzna nazwa ustawienia prędkości. Tekst ten może nie być przyjazny dla użytkownika i będzie udostępniany we wszystkich językach. |
speed_values |
Tablica |
Wymagane. Synonimy ustawienia szybkości w każdym obsługiwanym języku. |
[item, ...] |
Obiekt |
Synonim ustawienia szybkości w danym języku. |
speed_synonym |
Tablica |
Wymagane. Synonimy związane z ustawieniem szybkości powinny obejmować zarówno liczbę pojedynczą, jak i mnogą, jeśli ma to zastosowanie. Pierwszy synonim na liście jest uznawany za kanoniczną nazwę ustawienia szybkości. |
[item, ...] |
String |
Synonim. |
lang |
String |
Wymagane. Kod języka (ISO 639-1). Zobacz obsługiwane języki. |
ordered |
Wartość logiczna |
Wymagane. Jeśli zasada ma wartość prawda, obowiązuje dodatkowa gramatyka dla logiki zwiększania lub zmniejszania w kolejności (rosnącej) w tablicy szybkości. |
1
|
Obiekt |
Obsługa procentowej wartości szybkości. |
supportsFanSpeedPercent |
Wartość logiczna |
Wymagane. (Domyślnie: Jeśli zasada ma wartość Prawda, urządzenie akceptuje polecenia do zmiany szybkości w procentach od 0,0 do 100,0. |
Przykłady
Urządzenie z 2 ustawieniami prędkości, obsługą odwrotnego kierunku i zmiany procentowej.
{ "availableFanSpeeds": { "speeds": [ { "speed_name": "speed_low", "speed_values": [ { "speed_synonym": [ "Low", "Slow" ], "lang": "en" } ] }, { "speed_name": "speed_high", "speed_values": [ { "speed_synonym": [ "High", "Fast" ], "lang": "en" } ] } ], "ordered": true }, "reversible": true, "supportsFanSpeedPercent": 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 |
---|---|---|
currentFanSpeedSetting |
String |
Jest to wewnętrzną nazwa bieżącego ustawienia prędkości podanej w atrybucie |
currentFanSpeedPercent |
Number |
Wskazuje bieżącą szybkość wentylatora w procentach. Wymagany, jeśli atrybut |
Przykłady
Jaką prędkość pracują wentylatory w salonie?
{ "currentFanSpeedSetting": "speed_low", "currentFanSpeedPercent": 10 }
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.SetFanSpeed
Ustaw prędkość.
Parametry
Ładunek zawiera jeden z tych elementów:
Określ szybkość w ustawieniach.
Parametry | Typ | Opis |
---|---|---|
fanSpeed |
String |
Wymagane. Żądane ustawienia prędkości wentylatora. |
Ustaw szybkość w procentach.
Parametry | Typ | Opis |
---|---|---|
fanSpeedPercent |
Number |
Wymagane. Żądana wartość procentowa ustawienia prędkości. |
Przykłady
Ustaw wysoki poziom wentylatora.
{ "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeed": "speed_high" } }
Ustaw wentylator na 50%.
{ "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeedPercent": 50 } }
action.devices.commands.SetFanSpeedRelative
Ustaw prędkość względną.
To polecenie wymaga tych atrybutów:{ "commandOnlyFanSpeed": true }
Parametry
Ładunek zawiera jeden z tych elementów:
Ustaw prędkość względną według wagi.
Parametry | Typ | Opis |
---|---|---|
fanSpeedRelativeWeight |
Liczba całkowita |
Wymagane. Ta wartość wskazuje względną zmianę prędkości. Wartość bezwzględna oznacza skalowaną wartość, a znak liczbowy wskazuje kierunek zmiany. |
Ustaw prędkość względną w procentach.
Parametry | Typ | Opis |
---|---|---|
fanSpeedRelativePercent |
Number |
Wymagane. Ta wartość określa procent prędkości do zmiany. |
Przykłady
Trochę zmniejsz prędkość wentylatora.
{ "command": "action.devices.commands.SetFanSpeedRelative", "params": { "fanSpeedRelativeWeight": -1 } }
Zwiększ prędkość wentylatora o 10 procent.
{ "command": "action.devices.commands.SetFanSpeedRelative", "params": { "fanSpeedRelativePercent": 10 } }
action.devices.commands.Reverse
Odwróć kierunek wentylatora.
To polecenie wymaga tych atrybutów:{ "reversible": true }
Parametry
Parametry | Typ | Opis |
---|---|---|
Brak właściwości |
Przykłady
Odwróć kierunek wentylatora.
{ "command": "action.devices.commands.Reverse", "params": {} }
Przykładowe wypowiedzi
de-DE
- stell die Geschwindigkeit vom Ventilator auf hoch
en-US
- drop the AC fan speed to medium
es-ES
- cambia la velocidad del ventilador a medio
fr-FR
- mets la ventilation au maximum
hi-IN
- बेडरूम में पंखे की गति मीडियम करें
it-IT
- metti il condizionatore in salotto a velocità media
ja-JP
- エアコン の風量を 高速 にセット
ko-KR
- 선풍기 강풍 으로 틀어 줘
nl-NL
- zet de snelheid van de ventilator op medium
pt-BR
- definir a velocidade do ventilador para baixa
- põe a ventoinha no máximo
sv-SE
- Ställ in fläkten på medel
Urządzenie ERRORS
Zobacz pełną listę błędów i wyjątków.maxSpeedReached
: urządzenie jest już ustawione na maksymalną prędkość.minSpeedReached
: urządzenie ma już ustawioną minimalną prędkość.