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.

Die Lüftergeschwindigkeiten (d. h. Luft aus dem Gerät auf verschiedenen Stufen, die Teil einer Klimaanlage, einer Heizung oder eines Autos sein kann) können Einstellungen wie „Niedrig“, „Mittel“ und „Hoch“ oder einen Prozentsatz umfassen.

Geräteattribute

Geräte mit diesem Merkmal können die folgenden Attribute im Rahmen des Vorgangs SYNC 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 (falsche) Kommunikation unterstützt. Setzen Sie dieses Attribut auf „true“, wenn das Gerät nicht auf einen QUERY-Intent oder „Report State“ für dieses Merkmal reagieren kann.
Enthält eines 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

Synonym 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 die Richtlinie auf „true“ gesetzt ist, akzeptiert das Gerät Befehle zum Anpassen der Geschwindigkeit in Prozent zwischen 0,0 und 100.

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-Auftragsausfü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 Attribut supportsFanSpeedPercent auf true festgelegt ist

Beispiele

Mit welcher Geschwindigkeit laufen die Ventilatoren im Wohnzimmer?

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

BEFEHLE für Geräte

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

Legen Sie die Geschwindigkeit fest.

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 folgende 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

Lüfterrichtung 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.