Schema der Smart-Home-Drehung
action.devices.traits.Rotation
: Diese Eigenschaft gehört zu Geräten, die die Rotation unterstützen.
Die Drehung kann entweder in Prozent oder in Grad angegeben werden. Wenn das Gerät eine Drehung um Grad unterstützt, ist die Standarddrehrichtung der Uhrzeigersinn.
Geräte-ATTRIBUTE
Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des Vorgangs SYNC
. Weitere Informationen zur Verarbeitung von SYNC
-Intents finden Sie unter Intent-Auftragsausführung.
Attribute | Typ | Beschreibung |
---|---|---|
supportsDegrees |
Boolesch |
Erforderlich. Setzen Sie diesen Wert auf „true“, wenn das Gerät eine Drehung um Grad zulässt. |
supportsPercent |
Boolesch |
Erforderlich. Auf „true“ setzen, wenn das Gerät eine Drehung um Prozent zulässt |
rotationDegreesRange |
Objekt |
Stellt den Bereich in Grad dar, um den ein Gerät drehen kann. |
rotationDegreesMin |
Number |
Erforderlich. Minimale Drehung in Grad. |
rotationDegreesMax |
Number |
Erforderlich. Maximale Drehung in Grad. |
supportsContinuousRotation |
Boolesch |
(Standard: Setzen Sie den Wert auf „true“, wenn das Gerät eine kontinuierliche Rotation zulässt. Bei einer relativen Abfrage umschließt der Befehl |
commandOnlyRotation |
Boolesch |
(Standard: Gibt an, ob das Gerät die bidirektionale (richtig) oder bidirektionale (falsch) Kommunikation unterstützt. Setze dieses Attribut auf „true“, wenn das Gerät für dieses Merkmal nicht auf einen QUERY-Intent oder Berichtsstatus reagieren kann. |
Beispiele
Gerät, das sowohl die Drehung in Prozent als auch in Grad unterstützt
{ "supportsDegrees": true, "supportsPercent": true, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 180 } }
Gerät, das nur die Drehung 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
Entitäten mit diesem Merkmal können die folgenden Status als Teil des Vorgangs QUERY
melden. Weitere Informationen zur Verarbeitung von QUERY
-Intents finden Sie unter Intent-Auftragsausführung.
Bundesstaaten | Typ | Beschreibung |
---|---|---|
rotationDegrees |
Number |
Aktueller Wert innerhalb von |
rotationPercent |
Number |
Aktueller Wert, der angibt, um wie viel Prozent das Gerät gerade gedreht ist. 0,0 bedeutet geschlossen und 100,0 für geöffnet. |
targetRotationPercent |
Number |
Ebene, die den Rotationsprozentsatz angibt, in den das Gerät aufgrund einer laufenden Rotationsänderung bewegt wird. |
Beispiele
Um wie viel ist das Gerät gedreht? (Prozent und Grad).
{ "rotationDegrees": 45, "rotationPercent": 25 }
Um wie viel ist das Gerät gedreht? (nur Grad).
{ "rotationDegrees": 45 }
Um wie viel ist das Gerät gedreht? (kontinuierlich).
{ "rotationDegrees": 270, "rotationPercent": 75 }
Ein Gerät, das sich derzeit auf eine neue Position dreht (in Prozent).
{ "rotationPercent": 75, "targetRotationPercent": 100 }
BEFEHLE auf Gerät
Geräte mit diesem Trait können im Rahmen des Vorgangs EXECUTE
auf die folgenden Befehle reagieren. Weitere Informationen zur Verarbeitung von EXECUTE
-Intents finden Sie unter Intent-Auftragsausführung.
action.devices.commands.RotateAbsolute
Legen Sie die absolute Rotation des Geräts fest.
Parameters
Die Nutzlast enthält eines der folgenden Elemente:
Legen Sie die absolute Drehung in Grad fest.
Parameters | 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.
Parameters | Typ | Beschreibung |
---|---|---|
rotationPercent |
Number |
Erforderlich. Ein absoluter Wert in Prozent, der die endgültige Rotation des Geräts angibt. |
Beispiele
Neige das Gerät um 50 %.
{ "command": "action.devices.commands.RotateAbsolute", "params": { "rotationPercent": 50 } }
Drehe 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