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: false)

Wird auf „true“ gesetzt, wenn das Gerät die kontinuierliche Rotation zulässt. Bei einer relativen Abfrage schließt der Befehl RotateAbsolute den unterstützten Rotationsbereich ein.

commandOnlyRotation Boolesch

(Standard: false)

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 rotationDegreesRange, die angibt, wie oft das Gerät gedreht wird. Dieser Wert sollte immer relativ zum Uhrzeigersinn sein.

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 rotationDegreesRange angegeben werden.

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

Beim Festlegen des Geräts ist ein Fehler aufgetreten.

Unterstützte Werte:

deviceJammingDetected

Gerät ERRORS

Hier finden Sie die vollständige Liste der Fehler und Ausnahmen.