Schema für Smart-Home-Rotation
action.devices.traits.Rotation
: Diese Eigenschaft gehört zu Geräten, die die Rotation unterstützen.
Die Drehung kann in Prozent oder Grad angegeben werden. Wenn das Gerät die Drehung in Grad unterstützt, ist die Standardrichtung im Uhrzeigersinn.
Gerät ATTRIBUTE
Geräte mit diesem Attribut können im Rahmen des Vorgangs SYNC
die folgenden Attribute melden. Weitere Informationen zum Umgang mit SYNC
-Intents finden Sie unter Intent-Auftragsausführung.
Attribute | Typ | Beschreibung |
---|---|---|
supportsDegrees |
Boolesch |
Erforderlich. Wird auf „true“ gesetzt, wenn das Gerät die Drehung in Grad zulässt. |
supportsPercent |
Boolesch |
Erforderlich. Auf „true“ setzen, wenn das Gerät die Drehung um Prozent zulässt |
rotationDegreesRange |
Objekt |
Der Bereich in Grad, um den ein Gerät gedreht werden kann. |
rotationDegreesMin |
Number |
Erforderlich. Minimale Drehung in Grad. |
rotationDegreesMax |
Number |
Erforderlich. Maximale Drehung in Grad. |
supportsContinuousRotation |
Boolesch |
(Standard: Wird auf „true“ gesetzt, wenn das Gerät eine kontinuierliche Rotation zulässt. Bei einer relativen Abfrage schließt der Befehl |
commandOnlyRotation |
Boolesch |
(Standard: Gibt an, ob das Gerät die Einweg- (wahr) oder Zwei-Wege-Kommunikation (falsch) unterstützt. Legen Sie dieses Attribut auf „true“ fest, wenn das Gerät für einen dieser Merkmale nicht auf einen QUERY-Intent oder einen Berichtsstatus reagieren kann. |
Beispiele
Gerät, das sowohl die Drehung in Prozent als auch Grad unterstützt.
{ "supportsDegrees": true, "supportsPercent": true, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 180 } }
Gerät, das nur Drehungen in Grad unterstützt.
{ "supportsDegrees": true, "supportsPercent": false, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 90 } }
Gerät, das nur Befehle für die kontinuierliche Rotation unterstützt.
{ "supportsDegrees": true, "supportsPercent": true, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 360 }, "supportsContinuousRotation": true, "commandOnlyRotation": true }
Gerät STATES
Geräte mit diesem Attribut können im Rahmen des Vorgangs QUERY
die folgenden Zustände melden. Weitere Informationen zum Umgang mit QUERY
-Intents finden Sie unter Intent-Auftragsausführung.
Bundesstaaten | Typ | Beschreibung |
---|---|---|
rotationDegrees |
Number |
Aktuelle Stufe innerhalb von |
rotationPercent |
Number |
Aktuelle Stufe, die angibt, wie viel Prozent das Gerät gerade dreht. 0,0 entspricht geschlossen und 100,0 zum Öffnen. |
Beispiele
Wie stark ist das Gerät gedreht? (Prozent und Grad).
{ "rotationDegrees": 45, "rotationPercent": 25 }
Wie stark ist das Gerät gedreht? (nur Grad).
{ "rotationDegrees": 45 }
Wie stark ist das Gerät gedreht? (kontinuierlich).
{ "rotationDegrees": 270, "rotationPercent": 75 }
Gerätebefehle
Geräte mit diesem Attribut können im Rahmen des Vorgangs EXECUTE
auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE
-Intents finden Sie unter Intent-Auftragsausführung.
action.devices.commands.RotateAbsolute
Legen Sie die absolute Drehung des Geräts fest.
Parameter
Die Nutzlast enthält einen der folgenden Werte:
Legen Sie die absolute Rotation in Grad fest.
Parameter | Typ | Beschreibung |
---|---|---|
rotationDegrees |
Number |
Erforderlich. Ein absoluter Wert in Grad, der die endgültige Drehung des Geräts im Uhrzeigersinn angibt. Der Wert muss innerhalb des Attributs |
Legen Sie die absolute Rotation in Prozent fest.
Parameter | Typ | Beschreibung |
---|---|---|
rotationPercent |
Number |
Erforderlich. Ein absoluter Wert in Prozent, der die endgültige Drehung des Geräts angibt. |
Beispiele
Neige das Gerät auf 50 %.
{ "command": "action.devices.commands.RotateAbsolute", "params": { "rotationPercent": 50 } }
Drehen Sie das Gerät um 15 Grad gegen den Uhrzeigersinn (rotationDegrees: 45
).
{ "command": "action.devices.commands.RotateAbsolute", "params": { "rotationDegrees": 30 } }
Drehe das Gerät um 100 Grad im Uhrzeigersinn (supportsContinuousRotation: true
, rotationDegrees: 270
).
{ "command": "action.devices.commands.RotateAbsolute", "params": { "rotationDegrees": 10 } }
Ähnliche Fehler
Beim Festlegen der Drehung des Geräts ist ein Fehler aufgetreten.
Unterstützte Werte:
deviceJammingDetected