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

action.devices.traits.FanSpeed: Dieses Merkmal gehört zu Geräten, die die Einstellung 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 als Teil des Vorgangs SYNC melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Fulfillment.

Attribute Typ Beschreibung
reversible Boolesch

(Standardeinstellung: false)

Wenn diese Einstellung 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 „Status melden“-Intent 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 Artikel mit dem lang-Wert en ist erforderlich, um einen Sprach-Fallback zu ermöglichen.
speed_synonym Array

Erforderlich.

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

Synonym. Mindestens ein Artikel 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.

Bei Einstellung auf „true“ 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

Beispiele

Auf welcher Stufe sind die Lüfter im Wohnzimmer eingestellt?

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

GERÄTEBEFEHLE

Geräte mit diesem Merkmal können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Fulfillment.

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.

Beispiele

Stelle den Lüfter auf eine hohe Stufe.

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

Stelle den Lüfter auf 50 % ein.

{
  "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 Menge der Geschwindigkeitsänderung an. Der absolute Wert gibt den skalierten Betrag an, das numerische Vorzeichen die Richtung der Änderung.

Relative Geschwindigkeit in Prozent festlegen

Parameter Typ Beschreibung
fanSpeedRelativePercent Number

Erforderlich.

Dieser Wert gibt den Prozentsatz der Geschwindigkeitsänderung an.

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

Lüfterrichtung umkehren.

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

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Richte den Ventilator um.

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