Schema für Smart-Home-Rotation
action.devices.traits.Rotation
: Diese Eigenschaft gehört zu Geräten, die eine Rotation unterstützen.
Die Drehung kann in Prozent oder in Grad angegeben werden. Wenn das Gerät die Rotation in Grad unterstützt, ist die Standardrichtungsrichtung im Uhrzeigersinn.
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 |
---|---|---|
supportsDegrees |
Boolesch |
Erforderlich. Wird auf „true“ gesetzt, wenn das Gerät die Drehung in Grad zulässt. |
supportsPercent |
Boolesch |
Erforderlich. Wird auf „true“ gesetzt, wenn das Gerät die Rotation in Prozent zulässt |
rotationDegreesRange |
Objekt |
Geben Sie den Bereich in Grad an, in dem ein Gerät gedreht werden kann. |
rotationDegreesMin |
Number |
Erforderlich. Mindestdrehung in Grad. |
rotationDegreesMax |
Number |
Erforderlich. Maximale Drehung in Grad. |
supportsContinuousRotation |
Boolesch |
(Standard: Wird auf „true“ gesetzt, wenn das Gerät die kontinuierliche Rotation zulässt. Bei einer relativen Abfrage schließt der Befehl |
commandOnlyRotation |
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. |
Beispiele
Gerät, das sowohl die Rotation als auch das prozentuale Targeting unterstützt
{ "supportsDegrees": true, "supportsPercent": true, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 180 } }
Gerät, das nur das Drehen 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ä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 |
---|---|---|
rotationDegrees |
Number |
Aktuelle Stufe innerhalb von |
rotationPercent |
Number |
Aktuelle Stufe, die angibt, wie viel Prozent das Gerät aktuell gedreht wird. 0,0 entspricht geschlossen und 100,0 offen. |
Beispiele
Wie stark ist das Gerät gedreht? (Prozent und Grad)
{ "rotationDegrees": 45, "rotationPercent": 25 }
Wie stark ist das Gerät gedreht? (nur in Grad)
{ "rotationDegrees": 45 }
Wie stark ist das Gerät gedreht? (kontinuierlich)
{ "rotationDegrees": 270, "rotationPercent": 75 }
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.RotateAbsolute
Legen Sie die absolute Drehung des Geräts fest.
Parameter
Die Nutzlast enthält eine der folgenden Optionen:
Legen Sie die absolute Drehung in Grad fest.
Parameter | Typ | Beschreibung |
---|---|---|
rotationDegrees |
Number |
Erforderlich. Ein absoluter Wert in Grad, der die endgültige Drehung im Uhrzeigersinn angibt. Der Wert muss im Attribut |
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
Nimm das Gerät auf 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 } }
Weitere Informationen
Beim Festlegen des Geräts ist ein Fehler aufgetreten.
Unterstützte Werte:
deviceJammingDetected