Smart-Home-Attributschema für Lüftergeschwindigkeit

action.devices.traits.FanSpeed – Diese Eigenschaft gehört zu Geräten, die die Einstellung der Lüftergeschwindigkeit unterstützen.

Lüftergeschwindigkeiten (d. h. die Luftausblasung aus dem Gerät auf verschiedenen Stufen, die Teil einer Klimaanlage oder Heizung oder in einem Auto sein kann) können Einstellungen wie „niedrig“, „mittel“ und „hoch“ oder einen Prozentsatz umfassen.

Geräteattribute

Geräte mit dieser Eigenschaft können im Rahmen des Vorgangs SYNC die folgenden Attribute melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Ausführung.

Attribute Typ Beschreibung
reversible Boolesch

(Standardeinstellung: false)

Wenn diese Option auf „wahr“ gesetzt ist, unterstützt dieses Gerät die Lüfterdrehung in beide Richtungen und kann den Befehl zum Umkehren der Lüfterrichtung akzeptieren.
commandOnlyFanSpeed Boolesch

(Standardeinstellung: false)

Gibt an, ob das Gerät die unidirektionale (wahr) oder bidirektionale (falsch) Kommunikation unterstützt. Legen Sie dieses Attribut auf „true“ fest, wenn das Gerät nicht auf eine QUERY-Intention oder den Berichtsstatus für dieses Attribut antworten kann.
Enthält einen der folgenden Elemente:
0 Objekt

Unterstützung für Geschwindigkeitseinstellungen
availableFanSpeeds Objekt

Erforderlich.

Geschwindigkeitseinstellungen, die vom Gerät unterstützt werden.
speeds Array

Erforderlich.

Liste der Geschwindigkeitseinstellungen.
[item, ...] Objekt

Geschwindigkeitseinstellung
speed_name String

Erforderlich.

Interner Name der Geschwindigkeitseinstellung. Das kann für Nutzer nicht nutzerfreundlich sein und wird in allen Sprachen verwendet.
speed_values Array

Erforderlich.

Synonyme für die Geschwindigkeitseinstellung in den einzelnen unterstützten Sprachen.
[item, ...] Objekt

Synonyme für die Geschwindigkeitseinstellung in einer bestimmten Sprache.
speed_synonym Array

Erforderlich.

Synonyme für die Geschwindigkeitseinstellung sollten gegebenenfalls sowohl im Singular als auch im Plural angegeben werden. Das erste Synonym in der Liste wird als kanonischer Name der Geschwindigkeitseinstellung betrachtet.
[item, ...] String

Synonym.
lang String

Erforderlich.

Sprachcode (ISO 639-1). Unterstützte Sprachen
ordered Boolesch

Erforderlich.

Wenn diese Option auf „wahr“ gesetzt ist, wird zusätzliche Grammatik für die Logik zum Erhöhen oder Verringern in der Reihenfolge (steigend) des Arrays „speeds“ angewendet.
1 Objekt

Unterstützung für den Prozentsatz der Geschwindigkeit.
supportsFanSpeedPercent Boolesch

Erforderlich.

(Standardeinstellung: false)

Wenn diese Option auf „wahr“ gesetzt ist, akzeptiert dieses Gerät Befehle zur Anpassung der Geschwindigkeit in Prozentwerten von 0,0 bis 100,0.

Beispiele

Gerät mit zwei Geschwindigkeitseinstellungen, Unterstützung für Rückwärtslauf und prozentuale Anpassungen.

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

GERÄTESTATUS

Entitäten mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Status melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Ausführung.

Bundesstaaten Typ Beschreibung
currentFanSpeedSetting String

Dies ist der interne Name der aktuellen Geschwindigkeitseinstellung aus dem Attribut availableFanSpeeds.
currentFanSpeedPercent Number

Gibt die aktuelle Lüftergeschwindigkeit in Prozent an. Erforderlich, wenn das supportsFanSpeedPercent-Attribut auf true festgelegt ist

Beispiele

Mit welcher Geschwindigkeit laufen die Ventilatoren im Wohnzimmer?

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

Gerätebefehle

Geräte mit dieser Eigenschaft können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Ausführung.

action.devices.commands.SetFanSpeed

Geschwindigkeit festlegen

Parameter

Die Nutzlast enthält Folgendes:

Geschwindigkeit über die Einstellungen festlegen

Parameter Typ Beschreibung
fanSpeed String

Erforderlich.

Die angeforderten Geschwindigkeitseinstellungen des Lüfters.

Geschwindigkeit als Prozentsatz festlegen

Parameter Typ Beschreibung
fanSpeedPercent Number

Erforderlich.

Der Prozentsatz der angeforderten Geschwindigkeitseinstellung.

Beispiele

Stellen Sie den Lüfter auf die höchste Stufe.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeed": "speed_high"
  }
}

Stellen Sie den Lüfter auf 50%.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeedPercent": 50
  }
}

action.devices.commands.SetFanSpeedRelative

Legen Sie die relative Geschwindigkeit fest.

Für diesen Befehl sind die folgenden Attribute erforderlich: 
{
  "commandOnlyFanSpeed": true
}

Parameter

Die Nutzlast enthält Folgendes:

Legen Sie die relative Geschwindigkeit nach Gewicht fest.

Parameter Typ Beschreibung
fanSpeedRelativeWeight Ganzzahl

Erforderlich.

Dieser Wert gibt den relativen Betrag der Geschwindigkeitsänderung an. Der Absolutwert gibt den skalierten Betrag an, während das Vorzeichen die Richtung der Änderung angibt.

Legen Sie die relative Geschwindigkeit als Prozentsatz fest.

Parameter Typ Beschreibung
fanSpeedRelativePercent Number

Erforderlich.

Dieser Wert gibt den Prozentsatz der Geschwindigkeit an, der sich ändern soll.

Beispiele

Verringern Sie die Lüftergeschwindigkeit etwas.

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

Erhöhen Sie die Lüftergeschwindigkeit um 10 Prozent.

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

action.devices.commands.Reverse

Drehrichtung des Lüfters umkehren

Für diesen Befehl sind die folgenden Attribute erforderlich: 
{
  "reversible": true
}

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Ändern Sie die Lüfterrichtung.

{
  "command": "action.devices.commands.Reverse",
  "params": {}
}

Beispieläußerungen

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

GERÄTEFEHLER

Eine vollständige Liste der Fehler und Ausnahmen
  • maxSpeedReached: Das Gerät ist bereits auf die maximale Geschwindigkeit eingestellt.
  • minSpeedReached: Das Gerät ist bereits auf die niedrigste Geschwindigkeit eingestellt.