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.

Prędkości wentylatorów (tj. wentylator na różnych poziomach, które mogą być częścią systemu klimatyzacji lub ogrzewania albo w samochodzie), mogą zawierać ustawienia takie jak „niski”, średni, wysoki lub procentowy.

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: false) 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: 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 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: false) 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 availableFanSpeeds.
currentFanSpeedPercent	Number	Wskazuje aktualną prędkość wentylatora według wartości procentowych. Wymagane, jeśli atrybut supportsFanSpeedPercent ma wartość true

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