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.
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: 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: 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: 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 |
currentFanSpeedPercent |
Number |
Gibt die aktuelle Lüftergeschwindigkeit in Prozent an. Erforderlich, wenn das Attribut |
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.