Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Smart-Home-Aktionen. Hinweis:Sie erstellen weiterhin Aktionen in der Actions Console.
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

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 in Prozent oder Grad angegeben werden. Wenn das Gerät die Drehung in Grad unterstützt, ist die Standardrichtung im Uhrzeigersinn.

Gerät ATTRIBUTE

Geräte mit diesem Attribut können die folgenden Attribute als Teil des Vorgangs SYNC melden. Weitere Informationen zum Umgang mit 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.

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

rotationDegreesRange Objekt

Der Bereich in Grad, um den ein Gerät gedreht werden kann.

rotationDegreesMin Number

Erforderlich.

Minimale Drehung in Grad.

rotationDegreesMax Number

Erforderlich.

Maximale Drehung in Grad.

supportsContinuousRotation Boolesch

(Standard: false)

Wird auf „true“ gesetzt, wenn das Gerät eine 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 Einweg- (wahr) oder Zwei-Wege-Kommunikation (falsch) unterstützt. Legen Sie dieses Attribut auf „true“ fest, wenn das Gerät für einen dieser Merkmale nicht auf einen QUERY-Intent oder einen Berichtsstatus reagieren kann.

Beispiele

Gerät, das sowohl die Drehung in Prozent als auch Grad unterstützt.

{
  "supportsDegrees": true,
  "supportsPercent": true,
  "rotationDegreesRange": {
    "rotationDegreesMin": 0,
    "rotationDegreesMax": 180
  }
}

Gerät, das nur Drehungen 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

Geräte mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Zustände melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten Typ Beschreibung
rotationDegrees Number

Aktuelle Stufe innerhalb von rotationDegreesRange, die angibt, wie stark das Gerät gedreht wird. Dieser Wert sollte sich immer im Verhältnis zur Drehung im Uhrzeigersinn beziehen.

rotationPercent Number

Aktuelle Stufe, die angibt, wie viel Prozent das Gerät gerade dreht. 0,0 entspricht geschlossen und 100,0 zum Öffnen.

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
}

Gerätebefehle

Geräte mit diesem Attribut können im Rahmen des Vorgangs EXECUTE 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 Drehung des Geräts fest.

Parameter

Die Nutzlast enthält einen der folgenden Werte:

Legen Sie die absolute Rotation 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 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 Drehung des Geräts angibt.

Beispiele

Neige das Gerät auf 50 %.

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

Drehe 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ät ERRORS

Vollständige Liste der Fehler und Ausnahmen