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