Smart-Home-Rotationsmerkmal-Schema

action.devices.traits.Rotation: Diese Eigenschaft gehört zu Geräten, die eine Drehung unterstützen.

Die Drehung kann entweder in Prozent oder in Grad angegeben werden. Wenn das Gerät die Drehung in Grad unterstützt, ist die Standarddrehrichtung im Uhrzeigersinn.

Geräteattribute

Geräte mit diesem Merkmal können die folgenden Attribute im Rahmen des Vorgangs SYNC melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Ausführung.

Attribute Typ Beschreibung
supportsDegrees Boolesch

Erforderlich.

Legen Sie „true“ fest, wenn das Gerät eine Drehung um einen bestimmten Winkel zulässt.
supportsPercent Boolesch

Erforderlich.

Setzen Sie den Wert auf „wahr“, wenn das Gerät eine Drehung in Prozent zulässt.
rotationDegreesRange Objekt

Der Bereich in Grad, in dem sich ein Gerät drehen lässt.
rotationDegreesMin Number

Erforderlich.

Minimale Drehung in Grad.
rotationDegreesMax Number

Erforderlich.

Maximale Drehung in Grad.
supportsContinuousRotation Boolesch

(Standardeinstellung: false)

Legen Sie „true“ fest, wenn das Gerät eine kontinuierliche Drehung zulässt. Bei einer relativen Abfrage wird der Befehl RotateAbsolute am Ende des unterstützten Drehbereichs wieder an den Anfang zurückgesetzt.
commandOnlyRotation Boolesch

(Standardeinstellung: false)

Gibt an, ob das Gerät die unidirektionale (wahr) oder bidirektionale (falsch) Kommunikation unterstützt. Legen Sie dieses Attribut auf „true“ fest, wenn das Gerät nicht auf eine QUERY-Intention oder den Berichtsstatus für dieses Attribut antworten 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 Drehung unterstützt

{
  "supportsDegrees": true,
  "supportsPercent": true,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 360
  },
  "supportsContinuousRotation": true,
  "commandOnlyRotation": true
}

GERÄTESTATUS

Entitäten mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Status melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Ausführung.

Bundesstaaten Typ Beschreibung
rotationDegrees Number

Aktuelles Level in rotationDegreesRange, das angibt, um wie viele Grad das Gerät gedreht ist. Dieser Wert sollte immer relativ zur Drehung im Uhrzeigersinn angegeben werden.
rotationPercent Number

Der aktuelle Wert, der angibt, um wie viel Prozent das Gerät derzeit gedreht ist. 0,0 entspricht „Geschlossen“ und 100,0 „Geöffnet“.
targetRotationPercent Number

Stufe, die den Prozentsatz der Drehung angibt, zu der sich das Gerät bewegt oder die es erreicht, wenn sich die Drehung fortsetzt.

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
}

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

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

Gerätebefehle

Geräte mit dieser Eigenschaft können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Ausführung.

action.devices.commands.RotateAbsolute

Legen Sie die absolute Drehung des Geräts fest.

Parameter

Die Nutzlast enthält Folgendes:

Legen Sie die absolute Drehung 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 dem Attribut rotationDegreesRange entsprechen.

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

Neigen Sie das Gerät auf 50 Prozent.

{
  "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
  }
}

Drehen Sie das Gerät um 100 Grad im Uhrzeigersinn (supportsContinuousRotation: true, rotationDegrees: 270).

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 10
  }
}

Beim Festlegen der Drehung des Geräts ist ein Fehler aufgetreten.

Unterstützte Werte:

deviceJammingDetected

GERÄTEFEHLER

Eine vollständige Liste der Fehler und Ausnahmen