Schema für Traits der Smart-Home-Fanspeed-Funktion

action.devices.traits.FanSpeed: Diese Eigenschaft gehört zu Geräten, bei denen die Geschwindigkeit eines Lüfters eingestellt werden kann.

Die Lüftergeschwindigkeit (d. h. das Versenken von Luft aus dem Gerät auf verschiedenen Stufen, die Teil einer Klimaanlage oder Heizung oder in einem Auto sein kann) kann Einstellungen wie niedrig, mittel und hoch oder einen Prozentsatz umfassen.

Geräte-ATTRIBUTE

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

Attribute Typ Beschreibung
reversible Boolesch

(Standard: false)

Wenn die Richtlinie auf „true“ gesetzt ist, kann der Lüfter in beide Richtungen geblasen werden und der Befehl zum Umkehren der Lüfterrichtung ist möglich.
commandOnlyFanSpeed Boolesch

(Standard: false)

Gibt an, ob das Gerät die unidirektionale (wahr) oder die bidirektionale (falsche) Kommunikation unterstützt. Setze dieses Attribut auf „true“, wenn das Gerät für diese Eigenschaft nicht auf einen QUERY-Intent oder Berichtsstatus reagieren kann.
Enthält eines der folgenden Elemente:
0 Objekt

Unterstützung von Geschwindigkeitseinstellungen.
availableFanSpeeds Objekt

Erforderlich.

Die vom Gerät unterstützten Geschwindigkeitseinstellungen
speeds Array

Erforderlich.

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

Geschwindigkeitseinstellung.
speed_name String

Erforderlich.

Interner Name der Geschwindigkeitseinstellung. Diese Option ist möglicherweise nicht nutzerfreundlich und wird für alle Sprachen verwendet.
speed_values Array

Erforderlich.

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

Synonym für die eingestellte Geschwindigkeit in einer bestimmten Sprache.
speed_synonym Array

Erforderlich.

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

Synonym
lang String

Erforderlich.

Sprachcode (ISO 639-1). Weitere Informationen zu unterstützten Sprachen
ordered Boolesch

Erforderlich.

Wenn der Wert auf „true“ gesetzt ist, wird zusätzliche Grammatik für Erhöhungs- oder Verringerungslogik angewendet, und zwar in der Reihenfolge (Erhöhung) des Geschwindigkeitsarrays.
1 Objekt

Unterstützung für Geschwindigkeitsprozentsatz
supportsFanSpeedPercent Boolesch

Erforderlich.

(Standard: false)

Ist die Richtlinie auf „true“ gesetzt, akzeptiert das Gerät Befehle zum Anpassen der Geschwindigkeit mit einem Prozentsatz zwischen 0,0 und 100,0.

Beispiele

Das Gerät hat zwei Geschwindigkeitseinstellungen und unterstützt die umgekehrte Richtung sowie 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ät STATES

Entitäten mit diesem Trait können die folgenden Status im Rahmen des QUERY-Vorgangs 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 supportsFanSpeedPercent-Attribut auf true gesetzt ist

Beispiele

Wie schnell sind die Lüfter im Wohnzimmer?

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

BEFEHLUNGEN auf dem Gerät

Geräte mit dieser Eigenschaft können im Rahmen des EXECUTE-Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Auftragsausfü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 gewünschten Geschwindigkeitseinstellungen des Lüfters.

Geschwindigkeit in Prozent festlegen.

Parameter Typ Beschreibung
fanSpeedPercent Number

Erforderlich.

Der angeforderte Prozentsatz für die Geschwindigkeitseinstellung.

Beispiele

Stell die Lüftung auf eine hohe Stufe.

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

Stell die Lüftung 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:

Legen Sie die relative Geschwindigkeit nach Gewichtung fest.

Parameter Typ Beschreibung
fanSpeedRelativeWeight Ganzzahl

Erforderlich.

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

Legt die relative Geschwindigkeit in Prozent fest.

Parameter Typ Beschreibung
fanSpeedRelativePercent Number

Erforderlich.

Dieser Wert stellt den Prozentsatz der Geschwindigkeit dar, die geändert werden soll.

Beispiele

Stelle die Lüftergeschwindigkeit etwas niedriger.

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

Erhöhe die Geschwindigkeit des Lüfters 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

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

Sehen Sie sich die vollständige Liste der Fehler und Ausnahmen an.
  • maxSpeedReached: Das Gerät ist bereits auf die maximale Geschwindigkeit eingestellt.
  • minSpeedReached: Das Gerät ist bereits auf die Mindestgeschwindigkeit eingestellt.