Schemat cechy FanSpeed w inteligentnym 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 wydmuch powietrza z urządzenia na różnych poziomach, które może być częścią klimatyzacji lub jednostki grzewczej lub w samochodzie) może obejmować ustawienia takie jak niska, średnia i wysoka lub procent.

Urządzenia – ATTRIBUTES

Urządzenia z tą cechą mogą zgłaszać te atrybuty w ramach operacji SYNC. Więcej informacji o obsługiwaniu intencji SYNC znajdziesz w artykule Realizacja intencji.

Atrybuty Typ Opis
reversible Wartość logiczna

(wartość domyślna: false)

Jeśli ma wartość Prawda, urządzenie obsługuje działanie wentylatora w obu kierunkach i może przyjąć polecenie odwrócenia kierunku działania wentylatora.
commandOnlyFanSpeed Wartość logiczna

(Domyślnie: false)

Określa, czy urządzenie obsługuje komunikację w jednym kierunku (prawda) czy w obu kierunkach (fałsz). Ustaw ten atrybut na „PRAWDA”, jeśli urządzenie nie może odpowiadać na intencję QUERY ani nie może zgłaszać stanu dla tej cechy.
Zawiera którykolwiek z tych elementów:
0 Obiekt

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

Wymagany.

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

Wymagany.

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

Ustawienie szybkości.
speed_name String

Wymagany.

Wewnętrzna nazwa ustawienia szybkości. Może to być niewygodne dla użytkowników, a ta funkcja będzie dostępna we wszystkich językach.
speed_values Tablica

Wymagany.

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 prędkości powinny obejmować formę liczby pojedynczej i mnogiej (jeśli ma zastosowanie). Pierwszy synonim na liście będzie uważany za kanoniczną nazwę ustawienia prędkości.
[item, ...] String

Synonim.
lang String

Wymagany.

Kod języka (ISO 639-1). Zobacz obsługiwane języki.
ordered Wartość logiczna

Wymagany.

Jeśli ta opcja ma wartość Prawda, zostanie zastosowana dodatkowa gramatyka dla zwiększania lub zmniejszania w kolejności (rosnącej) tablicy prędkości.
1 Obiekt.

Obsługa procentowej wartości prędkości.
supportsFanSpeedPercent Wartość logiczna

Wymagany.

(Domyślnie: false)

Jeśli ma wartość Prawda, urządzenie będzie przyjmować polecenia dotyczące regulacji prędkości w procentach od 0,0 do 100,0.

Przykłady

Urządzenie z 2 prędkościami, obsługą kierunku wstecznego i możliwością zmiany prędkości w procentach.

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

STANOWISKO URZĄDZENIA

Elementy z tą cechą mogą raportować te 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ętrzna nazwa bieżącego ustawienia szybkości z atrybutu availableFanSpeeds.
currentFanSpeedPercent Number

Wskazuje bieżącą prędkość wentylatora w procentach. Wymagane, jeśli atrybut supportsFanSpeedPercent ma wartość true

Przykłady

Jaka jest prędkość wentylatorów w salonie?

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

Polecenia urządzenia

Urządzenia z tą cechą mogą reagować na te 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 następujących elementów:

Ustaw prędkość w ustawieniach.

Parametry Typ Opis
fanSpeed String

Wymagany.

Żądane ustawienia prędkości wentylatora.

Ustaw szybkość w procentach.

Parametry Typ Opis
fanSpeedPercent Number

Wymagany.

Żądany procent 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 podania tych atrybutów: 
{
  "commandOnlyFanSpeed": true
}

Parametry

Ładunek zawiera jedną z tych opcji:

Ustaw prędkość względną na podstawie wagi.

Parametry Typ Opis
fanSpeedRelativeWeight Liczba całkowita

Wymagane.

Ta wartość wskazuje względną wielkość zmiany 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ść wskazuje procentową zmianę szybkości.

Przykłady

Nieznacznie 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

Odwracanie kierunku wentylatora.

To polecenie wymaga podania 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

BŁĘDY urządzenia

Zobacz pełną listę błędów i wyjątków.
  • maxSpeedReached: urządzenie jest już ustawione na maksymalną prędkość.
  • minSpeedReached: urządzenie jest już ustawione na minimalną prędkość.