Schemat cechy inteligentnego wentylatora domu HomeSpeed
action.devices.traits.FanSpeed
– ten atrybut należy do urządzeń, które obsługują ustawienie prędkości wentylatora.
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 |
---|---|---|
reversible |
Wartość logiczna |
(domyślnie: Jeśli ma wartość Prawda, to urządzenie obsługuje wentylator w obu kierunkach i może przyjmować polecenia odwrócenia kierunku wentylatora. |
commandOnlyFanSpeed |
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. |
Zawiera dowolne z tych elementów: | ||
0
|
Obiekt |
Obsługa ustawień szybkości. |
availableFanSpeeds |
Obiekt |
Wymagany. Ustawienia szybkości obsługiwane przez urządzenie. |
speeds |
Tablica |
Wymagany. Lista ustawień prędkości. |
[item, ...] |
Obiekt |
Ustawienie szybkości. |
speed_name |
Ciąg |
Wymagany. Wewnętrzna nazwa ustawienia szybkości. Może nie być odpowiedni dla użytkowników i będzie dostępny we wszystkich językach. |
speed_values |
Tablica |
Wymagany. Synonimy ustawienia szybkości w każdym obsługiwanym języku. |
[item, ...] |
Obiekt |
synonim ustawienia szybkości w danym języku. |
speed_synonym |
Tablica |
Wymagany. Synonimy ustawienia szybkości powinny mieć formę liczby pojedynczej i mnogiej (w stosownych przypadkach). Pierwszy synonim na liście jest uznawany za kanoniczną nazwę ustawienia szybkości. |
[item, ...] |
Ciąg |
Synonim. |
lang |
Ciąg |
Wymagany. Kod języka (ISO 639-1). Zobacz obsługiwane języki. |
ordered |
Wartość logiczna |
Wymagany. Jeśli ma wartość Prawda, stosowana jest dodatkowa gramatyka służąca do zwiększania i zmniejszania wartości w kolejności (zwiększanie) tablicy prędkości. |
1
|
Obiekt |
Obsługa procentowej szybkości. |
supportsFanSpeedPercent |
Wartość logiczna |
Wymagany. (domyślnie: Jeśli ma wartość Prawda, urządzenie akceptuje polecenia dotyczące zmiany prędkości na podstawie wartości procentowej od 0,0 do 100,0. |
Przykłady
Urządzenie z 2 ustawieniami prędkości i obsługą cofania i procentowej korekty.
{ "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
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 |
---|---|---|
currentFanSpeedSetting |
Ciąg |
Jest to wewnętrzna nazwa bieżącego ustawienia szybkości z atrybutu |
currentFanSpeedPercent |
Number |
Wskazuje aktualną prędkość wentylatora według wartości procentowych. Wymagane, jeśli atrybut |
Przykłady
Jak szybko są wentylatory w salonie?
{ "currentFanSpeedSetting": "speed_low", "currentFanSpeedPercent": 10 }
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.SetFanSpeed
Ustaw szybkość.
Parametry
Ładunek zawiera jeden z tych elementów:
Ustaw szybkość według ustawień.
Parametry | Typ | Opis |
---|---|---|
fanSpeed |
Ciąg |
Wymagany. Żądane ustawienia prędkości wentylatora. |
Ustaw szybkość według wartości procentowych.
Parametry | Typ | Opis |
---|---|---|
fanSpeedPercent |
Number |
Wymagany. Żądany procent ustawienia szybkości. |
Przykłady
Ustaw wentylator na wysokie.
{ "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 szybkość względną.
To polecenie wymaga tych atrybutów:{ "commandOnlyFanSpeed": true }
Parametry
Ładunek zawiera jeden z tych elementów:
Ustaw względną szybkość według wagi.
Parametry | Typ | Opis |
---|---|---|
fanSpeedRelativeWeight |
Liczba całkowita |
Wymagany. Ta wartość określa względną zmianę szybkości. Wartość bezwzględna wskazuje powiększoną kwotę, a znak numeryczny wskazuje kierunek zmiany. |
Ustaw szybkość względną według wartości procentowych.
Parametry | Typ | Opis |
---|---|---|
fanSpeedRelativePercent |
Number |
Wymagany. Ta wartość to procent szybkości zmiany. |
Przykłady
Schowaj prędkość wentylatora.
{ "command": "action.devices.commands.SetFanSpeedRelative", "params": { "fanSpeedRelativeWeight": -1 } }
Zwiększ prędkość wentylatora o 10%.
{ "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
: na urządzeniu ustawiono już maksymalną prędkość.minSpeedReached
: urządzenie ma już ustawioną minimalną prędkość.