Schema der Smart-Home-Rotationseigenschaft

action.devices.traits.Rotation: Diese Trait 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 SYNC-Vorgangs. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute Typ Beschreibung
supportsDegrees Boolesch

Erforderlich.

Setzen Sie den Wert auf „true“, wenn das Gerät die Drehung um Grad zulässt.
supportsPercent Boolesch

Erforderlich.

Auf „true“ setzen, wenn das Gerät eine Drehung um Prozent zulässt
rotationDegreesRange Objekt

Der Bereich in Grad, um den ein Gerät drehen kann.
rotationDegreesMin Number

Erforderlich.

Minimale Drehung in Grad.
rotationDegreesMax Number

Erforderlich.

Maximale Drehung in Grad.
supportsContinuousRotation Boolesch

(Standard: false)

Setzen Sie diesen Wert auf „true“, wenn das Gerät eine kontinuierliche Drehung zulässt. Bei einer relativen Abfrage umgibt der Befehl RotateAbsolute den unterstützten Rotationsbereich.
commandOnlyRotation Boolesch

(Standard: false)

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.

Beispiele

Gerät, das sowohl eine 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 kontinuierliche Rotation unterstützt.

{
  "supportsDegrees": true,
  "supportsPercent": true,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 360
  },
  "supportsContinuousRotation": true,
  "commandOnlyRotation": 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
rotationDegrees Number

Aktuelle Ebene innerhalb von rotationDegreesRange, die angibt, um wie viel Grad das Gerät gedreht wurde. Dieser Wert sollte immer relativ zur Drehung im Uhrzeigersinn sein.
rotationPercent Number

Aktueller Wert, der angibt, wie viel Prozent das Gerät derzeit gedreht ist. 0,0 entspricht geschlossen und 100,0 ist offen.

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
}

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.RotateAbsolute

Legen Sie die absolute Rotation 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 Absolutwert in Grad, der die endgültige Drehung des Geräts im Uhrzeigersinn angibt. Der Wert muss innerhalb des Attributs rotationDegreesRange liegen.

Legen Sie die absolute Rotation in Prozent fest.

Parameter 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
  }
}

Beim Festlegen der Gerätedrehung ist ein Fehler aufgetreten.

Unterstützte Werte:

deviceJammingDetected

Gerät ERRORS

Sehen Sie sich die vollständige Liste der Fehler und Ausnahmen an.