Schemat cechy Smart Home FanSpeed

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

Prędkości wentylatora (czyli wydmuchiwanie powietrza z urządzenia na różnych poziomach, co może być częścią klimatyzacji lub ogrzewania albo systemu w samochodzie) mogą obejmować ustawienia takie jak niskie, średnie i wysokie lub procentowe.

Atrybuty urządzenia

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

Atrybuty Typ Opis
reversible Wartość logiczna

(Domyślnie: false)

Jeśli ma wartość Prawda, urządzenie obsługuje dmuchanie wentylatora w obu kierunkach i może akceptować polecenie zmiany kierunku.
commandOnlyFanSpeed Wartość logiczna

(Domyślnie: false)

Wskazuje, czy urządzenie obsługuje komunikację jednokierunkową (prawda) czy dwukierunkową (fałsz). Ustaw ten atrybut na „true”, jeśli urządzenie nie może odpowiadać na intencję QUERY ani zgłaszać stanu w przypadku tej cechy.
Zawiera dowolny z tych elementów:
0 Obiekt

Obsługa ustawień prędkości.
availableFanSpeeds Obiekt

Wymagany.

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

Wymagany.

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

Ustawienie prędkości.
speed_name String

Wymagany.

Wewnętrzna nazwa ustawienia szybkości. Może to być nieprzyjazne dla użytkownika i będzie udostępniane 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. Aby zapewnić działanie awaryjne w przypadku języka, wymagany jest co najmniej 1 produkt z wartością lang równą en.
speed_synonym Tablica

Wymagany.

Synonimy ustawienia prędkości powinny obejmować zarówno formy liczby pojedynczej, jak i mnogiej, jeśli ma to zastosowanie. Pierwszy synonim na liście będzie uznawany za kanoniczną nazwę ustawienia szybkości.
[item, ...] String

Synonim. Aby zapewnić działanie awaryjne w przypadku języka, wymagany jest co najmniej 1 produkt z wartością lang równą en.
lang String

Wymagany.

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

Wymagany.

Jeśli ta wartość jest ustawiona na „true”, stosowana jest dodatkowa gramatyka dla logiki zwiększania lub zmniejszania w kolejności (rosnącej) tablicy prędkości.
1 Obiekt

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

Wymagany.

(Domyślnie: false)

Jeśli ma wartość Prawda, to urządzenie będzie akceptować polecenia dostosowywania prędkości za pomocą wartości procentowej od 0,0 do 100,0.

Przykłady

Urządzenie z 2 ustawieniami prędkości, obsługą kierunku wstecznego i dostosowywaniem procentowym.

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

Stany urządzenia

Elementy z tym atrybutem mogą zgłaszać te stany w ramach operacji QUERY. Więcej informacji o obsłudze QUERY intencji znajdziesz w artykule Realizacja intencji.

Stany Typ Opis
currentFanSpeedSetting String

Jest to wewnętrzna nazwa bieżącego ustawienia prędkości z atrybutu availableFanSpeeds.
currentFanSpeedPercent Number

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

Przykłady

Z jaką prędkością działają wentylatory w salonie?

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

Polecenia dotyczące urządzenia

Urządzenia z tą cechą mogą odpowiadać na te polecenia w ramach operacji EXECUTE. Więcej informacji o obsłudze EXECUTE intencji znajdziesz w artykule Realizacja intencji.

action.devices.commands.SetFanSpeed

Ustaw szybkość.

Parametry

Ładunek zawiera jedną z tych wartości:

Ustaw szybkość w ustawieniach.

Parametry Typ Opis
fanSpeed String

Wymagany.

Żądane ustawienia prędkości wentylatora.

Ustaw szybkość w procentach.

Parametry Typ Opis
fanSpeedPercent Number

Wymagany.

Procent żądanej szybkości.

Przykłady

Ustaw wentylator na najwyższą prędkość.

{
  "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 jedną z tych wartości:

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

Parametry Typ Opis
fanSpeedRelativeWeight Liczba całkowita

Wymagany.

Ta wartość wskazuje względną wielkość zmiany prędkości. Wartość bezwzględna wskazuje przeskalowaną kwotę, a znak liczbowy – kierunek zmiany.

Ustaw prędkość względną w procentach.

Parametry Typ Opis
fanSpeedRelativePercent Number

Wymagany.

Ta wartość to procent szybkości zmiany.

Przykłady

Nieco zmniejsz prędkość wentylatora.

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

Zwiększ szybkość 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 obrotów 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 najniższą prędkość.