Smart Home-Schema für das Attribut „FanSpeed“

action.devices.traits.FanSpeed: Dieses Attribut gehört zu Geräten, die das Einstellen der Lüftergeschwindigkeit unterstützen.

Die Gebläsestufen (d. h. die Luft, die mit verschiedenen Stufen aus dem Gerät geblasen wird, was Teil einer Klimaanlage oder 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 zur Verarbeitung von SYNC-Intents finden Sie unter Intent-Ausführung.

Attribute Typ Beschreibung
reversible Boolesch

(Standardeinstellung: false)

Wenn diese Option auf „true“ gesetzt ist, unterstützt das Gerät das Blasen des Lüfters in beide Richtungen und kann den Befehl zum Umkehren der Lüfterrichtung empfangen.
commandOnlyFanSpeed Boolesch

(Standardeinstellung: false)

Gibt an, ob das Gerät die Einwegkommunikation (true) oder die Zweiwegkommunikation (false) unterstützt. Setzen Sie dieses Attribut auf „true“, wenn das Gerät nicht auf einen QUERY-Intent oder einen Report State für dieses Merkmal reagieren kann.
Enthält eines der folgenden Elemente:
0 Objekt

Unterstützung für Geschwindigkeitseinstellungen.
availableFanSpeeds Objekt

Erforderlich.

Vom Gerät unterstützte Geschwindigkeitseinstellungen.
speeds Array

Erforderlich.

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

Geschwindigkeitseinstellung.
speed_name String

Erforderlich.

Interner Name der Geschwindigkeitseinstellung. Das ist nicht nutzerfreundlich und wird in allen Sprachen angezeigt.
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. Mindestens ein Element mit dem lang-Wert en ist erforderlich, um einen Sprach-Fallback zu ermöglichen.
speed_synonym Array

Erforderlich.

Synonyme für die Geschwindigkeitseinstellung sollten sowohl Singular- als auch Pluralformen enthalten, sofern zutreffend. Das erste Synonym in der Liste gilt als kanonischer Name der Geschwindigkeitseinstellung.
[item, ...] String

Synonym: Mindestens ein Element mit dem lang-Wert en ist erforderlich, um einen Sprach-Fallback zu ermöglichen.
lang String

Erforderlich.

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

Erforderlich.

Wenn auf „true“ gesetzt, wird zusätzliche Grammatik für die Logik zum Erhöhen oder Verringern in der Reihenfolge (aufsteigend) des Geschwindigkeitsarrays angewendet.
1 Objekt

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

Erforderlich.

(Standardeinstellung: false)

Wenn diese Option auf „true“ gesetzt ist, akzeptiert dieses Gerät Befehle zum Anpassen der Geschwindigkeit mit einem Prozentsatz von 0,0 bis 100,0.

Beispiele

Gerät mit zwei Geschwindigkeitseinstellungen, Unterstützung für die Rückwärtsrichtung 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

Für Entitäten mit diesem Merkmal können im Rahmen des Vorgangs QUERY die folgenden Status gemeldet werden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Fulfillment.

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

Wert muss zwischen 0 und 100 liegen

Beispiele

Wie schnell drehen sich die Ventilatoren im Wohnzimmer?

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

GERÄTEBEFEHLE

Geräte mit diesem Merkmal reagieren möglicherweise auf die folgenden Befehle im Rahmen des Vorgangs EXECUTE. Weitere Informationen zur Verarbeitung von EXECUTE-Intents finden Sie unter Intent-Ausführung.

action.devices.commands.SetFanSpeed

Geschwindigkeit festlegen

Parameter

Die Nutzlast enthält eines der folgenden Elemente:

Geschwindigkeit über die Einstellungen festlegen

Parameter Typ Beschreibung
fanSpeed String

Erforderlich.

Die angeforderten Geschwindigkeitseinstellungen des Ventilators.

Geschwindigkeit prozentual festlegen.

Parameter Typ Beschreibung
fanSpeedPercent Number

Erforderlich.

Der angeforderte Prozentsatz für die Geschwindigkeitseinstellung.

Wert muss zwischen 0 und 100 liegen

Beispiele

Stell die Lüftung auf eine hohe Stufe.

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

Stelle das Gebläse 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 eines der folgenden Elemente:

Relative Geschwindigkeit nach Gewicht festlegen

Parameter Typ Beschreibung
fanSpeedRelativeWeight Ganzzahl

Erforderlich.

Dieser Wert gibt die relative Änderung der Geschwindigkeit an. Der absolute Wert gibt die skalierte Menge an, während das numerische Vorzeichen die Richtung der Änderung angibt.

Wert muss zwischen -5 und 5 liegen

Relative Geschwindigkeit in Prozent festlegen.

Parameter Typ Beschreibung
fanSpeedRelativePercent Number

Erforderlich.

Dieser Wert gibt den Prozentsatz der Geschwindigkeitsänderung an.

Wert muss zwischen -100 und 100 liegen

Beispiele

Stelle die Lüftung etwas niedriger.

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

Erhöhe die Lüftergeschwindigkeit um 10 %.

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

action.devices.commands.Reverse

Die Richtung des Ventilators wird geändert.

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

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Richtung des Ventilators umkehren

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

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.