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.

Prędkość wentylatora (czyli wydmuchowanie powietrza z urządzenia o różnych poziomach, które może być częścią klimatyzacji lub systemu ogrzewania albo samochodu) może obejmować ustawienia takie jak niska, średnia, wysoka lub wartość procentowa.

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: false)

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: false)

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: false)

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 availableFanSpeeds.

currentFanSpeedPercent Number

Wskazuje bieżącą szybkość wentylatora w procentach. Wymagany, jeśli atrybut supportsFanSpeedPercent ma wartość true

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 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ść.