Schemat cechy „Szybkość wentylatora” w inteligentnym domu

action.devices.traits.FanSpeed – ta cecha należy do urządzeń, które umożliwiają ustawianie prędkości wentylatora.

Szybkość wentylatora (czyli wydmuchnięcie powietrza z urządzenia o różnych poziomach, co może być częścią klimatyzacja lub ogrzewanie lub w samochodzie) może uwzględniać ustawienia, takie jak niski, średni i wysoki poziom lub procent.

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
reversible Wartość logiczna

(Domyślnie: false)

Jeśli zasada ma wartość Prawda, urządzenie umożliwia dmuchanie wentylatora w obu kierunkach i może przyjąć polecenie odwrócenia kierunku.
commandOnlyFanSpeed Wartość logiczna

(Domyślnie: false)

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.
Zawiera dowolne z tych elementów:
0 Obiekt.

Obsługa ustawień szybkości.
availableFanSpeeds Obiekt.

Wymagane.

Ustawienia prędkości obsługiwane przez urządzenie.
speeds Tablica

Wymagane.

Lista ustawień prędkości.
[item, ...] Obiekt.

Ustawienie szybkości.
speed_name String

Wymagane.

Wewnętrzna nazwa ustawienia szybkości. Może być on nieprzyjazny dla użytkownika i będzie udostępniany we wszystkich językach.
speed_values Tablica

Wymagane.

Synonimy ustawienia szybkości w poszczególnych obsługiwanych językach.
[item, ...] Obiekt.

Synonim ustawienia szybkości w danym języku.
speed_synonym Tablica

Wymagane.

Synonimy ustawienia szybkości powinny w stosownych przypadkach obejmować zarówno formy liczby pojedynczej, jak i mnogiej. Pierwszy synonim na liście jest traktowany jako kanoniczna nazwa 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ść true (prawda), logika zwiększania lub zmniejszania szybkości jest dodawana w kolejności rosnącej lub malejącej w tablicy prędkości.
1 Obiekt.

Obsługa wartości procentowej szybkości.
supportsFanSpeedPercent Wartość logiczna

Wymagane.

(Domyślnie: false)

Jeśli zasada ma wartość Prawda, urządzenie akceptuje polecenia do regulacji szybkości w procentach od 0,0 do 100,0.

Przykłady

Urządzenie z 2 ustawieniami prędkości oraz możliwością zmiany kierunku i procentowania.

{
  "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

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
currentFanSpeedSetting String

To jest nazwa wewnętrzna bieżącego ustawienia szybkości z atrybutu availableFanSpeeds.
currentFanSpeedPercent Number

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

Przykłady

Z jaką prędkością pracują wentylatory w salonie?

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}

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

Ustaw szybkość.

Parametry

Ładunek zawiera jeden z następujących elementów:

Ustaw szybkość według ustawień.

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 szybkości.

Przykłady

Ustaw wentylator na wysokim poziomie.

{
  "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 następujących atrybutów: 
{
  "commandOnlyFanSpeed": true
}

Parametry

Ładunek zawiera jeden z następujących elementów:

Ustaw prędkość względną według wagi.

Parametry Typ Opis
fanSpeedRelativeWeight Liczba całkowita

Wymagane.

Ta wartość określa względną zmianę prędkości. Wartość bezwzględna wskazuje skalowaną wartość, a znak numeryczny wskazuje kierunek zmiany.

Ustaw szybkość względną w procentach.

Parametry Typ Opis
fanSpeedRelativePercent Number

Wymagane.

Ta wartość określa procent zmiany prędkości.

Przykłady

Zmniejsz szybkość wentylatora.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativeWeight": -1
  }
}

Zwiększ szybkość wentylatora o 10 procent.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativePercent": 10
  }
}

action.devices.commands.Reverse

Odwróć kierunek wentylatora.

To polecenie wymaga następujących 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 jest już ustawiona maksymalna prędkość.
  • minSpeedReached: na urządzeniu jest już ustawiona minimalna prędkość.