Schema der FanSpeed-Smart-Home-Steuerung

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

Lüftergeschwindigkeiten (das Blasen von Luft aus dem Gerät auf verschiedenen Ebenen, z. B. in einer Klimaanlage, einer Heizung oder in einem Auto) können Einstellungen wie „Niedrig“, „Mittel“ und „Hoch“ oder einen Prozentsatz enthalten.

Geräte-ATTRIBUTE

Geräte mit diesem Merkmal können im Rahmen des SYNC-Vorgangs die folgenden Attribute melden. Weitere Informationen zum Verarbeiten von SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute	Typ	Beschreibung
reversible	Boolesch	(Standard: false) Wenn die Einstellung auf „true“ gesetzt ist, unterstützt das Gerät den Lüfter in beide Richtungen und lässt den Befehl annehmen, um die Lüfterrichtung umzukehren.
commandOnlyFanSpeed	Boolesch	(Standard: false) Gibt an, ob das Gerät die Verwendung von Einweg- (wahr) oder Zwei-Wege-Kommunikation (falsch) unterstützt. Setzen Sie dieses Attribut auf „true“, wenn das Gerät für diese Eigenschaft nicht auf einen QUERY-Intent oder einen Berichtstatus reagieren kann.
Enthält eines der folgenden Elemente:
0	Objekt	Support für Geschwindigkeitseinstellungen.
availableFanSpeeds	Objekt	Erforderlich. Vom Gerät unterstützte Geschwindigkeitseinstellungen.
speeds	Array	Erforderlich. Liste der Geschwindigkeitseinstellungen.
[item, ...]	Objekt	Geschwindigkeit festlegen.
speed_name	String	Erforderlich. Interner Name der Geschwindigkeitseinstellung. Das Spiel kann nicht nutzerfreundlich sein und wird in allen Sprachen verwendet.
speed_values	Array	Erforderlich. Synonyme für die Geschwindigkeitseinstellung in den unterstützten Sprachen.
[item, ...]	Objekt	Synonym für die Geschwindigkeitseinstellung in einer bestimmten Sprache.
speed_synonym	Array	Erforderlich. Synonyme für die Einstellung für die Geschwindigkeit sollten, falls zutreffend, sowohl Singular- als auch Pluralformen enthalten. Das erste Synonym in der Liste wird als kanonischer Name der Geschwindigkeitseinstellung betrachtet.
[item, ...]	String	Synonyme.
lang	String	Erforderlich. Sprachcode (ISO 639-1). Siehe unterstützte Sprachen
ordered	Boolesch	Erforderlich. Wird die Richtlinie auf „true“ gesetzt, wird eine zusätzliche Grammatik für die Logik zur Erhöhung oder Verringerung in der Reihenfolge des Speeds-Arrays angewendet (steigend).
1	Objekt	Unterstützung für Geschwindigkeitsprozentsatz.
supportsFanSpeedPercent	Boolesch	Erforderlich. (Standard: false) Wenn du den Wert auf „true“ setzt, akzeptiert das 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 Umkehrrichtung 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 Merkmal können im Rahmen des QUERY-Vorgangs die folgenden Status melden: Weitere Informationen zum Verarbeiten von QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten	Typ	Beschreibung
currentFanSpeedSetting	String	Das 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 gesetzt ist

Beispiele

Welche Geschwindigkeit haben die Fans im Wohnzimmer?

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

BEISPIELE für Geräte

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

action.devices.commands.SetFanSpeed

Geschwindigkeit festlegen

Parameter

Die Nutzlast enthält eine der folgenden Optionen:

Geschwindigkeit nach Einstellungen festlegen.

Parameter	Typ	Beschreibung
fanSpeed	String	Erforderlich. Angeforderte Geschwindigkeitseinstellungen des Lüfters

Geschwindigkeit nach Prozentsatz festlegen.

Parameter	Typ	Beschreibung
fanSpeedPercent	Number	Erforderlich. Angeforderte Geschwindigkeitseinstellung in Prozent

Beispiele

Stell den Lüfter auf hoch.

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

Stell den Lüfter auf 50%.

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

action.devices.commands.SetFanSpeedRelative

Relative Geschwindigkeit festlegen

Für diesen Befehl sind die folgenden Attribute erforderlich:

{
  "commandOnlyFanSpeed": true
}

Parameter

Die Nutzlast enthält eine der folgenden Optionen:

Legen Sie die relative Geschwindigkeit nach Gewicht fest.

Parameter	Typ	Beschreibung
fanSpeedRelativeWeight	Ganzzahl	Erforderlich. Dieser Wert gibt den relativen Wert der Geschwindigkeitsänderung an. Der Absolutwert gibt den skalierten Betrag an, während das numerische Zeichen die Richtung der Änderung angibt.

Legen Sie die relative Geschwindigkeit in Prozent fest.

Parameter	Typ	Beschreibung
fanSpeedRelativePercent	Number	Erforderlich. Dieser Wert stellt die prozentuale Geschwindigkeit dar, die geändert werden soll.

Beispiele

Die Lüftung langsamer verringern.

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

Die Lüftergeschwindigkeit lässt sich um 10 % erhöhen.

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

action.devices.commands.Reverse

Richtung des Lüfters umkehren.

Für diesen Befehl sind die folgenden Attribute erforderlich:

{
  "reversible": true
}

Parameter

Parameter	Typ	Beschreibung
Keine Attribute

Beispiele

Die Lüfterrichtung 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ät ERRORS

Hier finden Sie die vollständige Liste der Fehler und Ausnahmen.

• maxSpeedReached: Das Gerät ist bereits auf die höchste Geschwindigkeit eingestellt.
• minSpeedReached: Das Gerät ist bereits auf die minimale Geschwindigkeit eingestellt.