Trait-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 entweder in Prozent oder in Grad angegeben werden und wenn das Gerät eine Drehung unterstützt. Grad drehen, ist die Standarddrehrichtung im Uhrzeigersinn.

Geräte-ATTRIBUTES

Auf Geräten mit diesem Trait kann Folgendes gemeldet werden im Rahmen des SYNC-Vorgangs verwenden. Weitere Informationen Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Absichtliche Umsetzung.

Attribute	Typ	Beschreibung
supportsDegrees	Boolesch	Erforderlich. Setzen Sie den 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, den ein Gerät drehen kann.
rotationDegreesMin	Number	Erforderlich. Minimale Drehung in Grad.
rotationDegreesMax	Number	Erforderlich. Maximale Drehung in Grad.
supportsContinuousRotation	Boolesch	(Standardeinstellung: false) Legen Sie den Wert auf „true“ fest, wenn das Gerät eine kontinuierliche Drehung zulässt. Bei einer relativen Abfrage umschließt der Befehl RotateAbsolute den unterstützten Rotationsbereich.
commandOnlyRotation	Boolesch	(Standardeinstellung: false) Gibt an, ob das Gerät die unidirektionale (wahr) oder bidirektionale (falsche) Kommunikation unterstützt. Setzen Sie dieses Attribut auf „true“, wenn das Gerät nicht auf einen QUERY-Intent oder „Report State“ für dieses Merkmal reagieren kann.

Beispiele

Gerät, das sowohl 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 melden möglicherweise Folgendes: QUERY-Bundesstaaten. Weitere Informationen Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Absichtliche Umsetzung.

Bundesstaaten	Typ	Beschreibung
rotationDegrees	Number	Aktueller Pegel in rotationDegreesRange, der angibt, um wie viel Grad das Gerät gedreht wird. Dieser Wert sollte immer relativ zur Drehung im Uhrzeigersinn sein.
rotationPercent	Number	Aktuelle Stufe, die angibt, um wie viel Prozent das Gerät derzeit gedreht ist. 0,0 entspricht geschlossen und 100,0 für Öffnen.
targetRotationPercent	Number	Pegel, der den Prozentsatz für die Drehung angibt, zu dem das Gerät aufgrund einer fortlaufenden Änderung der Drehung hin bewegt wird.

Beispiele

Um wie viel wird das Gerät gedreht? (in Prozent und Grad).

{
  "rotationDegrees": 45,
  "rotationPercent": 25
}

Um wie viel wird das Gerät gedreht? (nur Grad).

{
  "rotationDegrees": 45
}

Um wie viel wird das Gerät gedreht? (fortlaufend).

{
  "rotationDegrees": 270,
  "rotationPercent": 75
}

Ein Gerät, das sich gerade in eine neue Position dreht (in Prozent).

{
  "rotationPercent": 75,
  "targetRotationPercent": 100
}

Gerät "COMMANDS"

Geräte mit diesem Merkmal können auf Folgendes reagieren im Rahmen des EXECUTE-Vorgangs ausgeführt. Weitere Informationen Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Absichtliche Umsetzung.

action.devices.commands.RotateAbsolute

Legen Sie die absolute Drehung des Geräts fest.

Parameter

Die Nutzlast enthält eines der folgenden Elemente:

Legen Sie die absolute Drehung in Grad fest.

Parameter	Typ	Beschreibung
rotationDegrees	Number	Erforderlich. Ein absoluter Wert in Grad, der die letzte Drehung des Geräts im Uhrzeigersinn angibt. Der Wert muss im Attribut „rotationDegreesRange“ liegen.

Legen Sie die absolute Drehung 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 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 Gerätedrehung ist ein Fehler aufgetreten.

Unterstützte Werte:

deviceJammingDetected

Gerätefehler

Vollständige Liste der Fehler und Ausnahmen.