Schéma des traits de rotation de la maison connectée
action.devices.traits.Rotation
: cette caractéristique appartient aux appareils qui acceptent la rotation.
La rotation peut être spécifiée en pourcentage ou en degrés. Si l'appareil est compatible avec la rotation en degrés, le sens de rotation par défaut est dans le sens des aiguilles d'une montre.
ATTRIBUTS D'APPAREIL
Les appareils dotés de cette caractéristique peuvent signaler les attributs suivants dans le cadre de l'opération SYNC
. Pour en savoir plus sur la gestion des intents SYNC
, consultez la section Traitement des intents.
Attributs | Type | Description |
---|---|---|
supportsDegrees |
Valeur booléenne |
Obligatoire. Défini sur "true" si l'appareil autorise la rotation par degré. |
supportsPercent |
Valeur booléenne |
Obligatoire. Défini sur "true" si l'appareil autorise la rotation en pourcentage |
rotationDegreesRange |
Objet |
Représente la plage, en degrés, de rotation d'un appareil. |
rotationDegreesMin |
Number |
Obligatoire. Rotation minimale en degrés. |
rotationDegreesMax |
Number |
Obligatoire. Rotation maximale en degrés. |
supportsContinuousRotation |
Valeur booléenne |
(Par défaut : Définissez cette valeur sur "true" si l'appareil autorise la rotation continue. Lorsqu'une requête relative est exécutée, la commande |
commandOnlyRotation |
Valeur booléenne |
(Par défaut : Indique si l'appareil est compatible avec la communication unidirectionnelle (true) ou bidirectionnelle (false). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ni à un état de rapport pour cette caractéristique. |
Exemples
Appareil compatible avec la rotation en pourcentage et en degrés.
{ "supportsDegrees": true, "supportsPercent": true, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 180 } }
Appareil compatible avec la rotation en degrés uniquement.
{ "supportsDegrees": true, "supportsPercent": false, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 90 } }
Appareil compatible uniquement avec les commandes de rotation continue.
{ "supportsDegrees": true, "supportsPercent": true, "rotationDegreesRange": { "rotationDegreesMin": 0, "rotationDegreesMax": 360 }, "supportsContinuousRotation": true, "commandOnlyRotation": true }
État de l'appareil
Les entités dotées de cette caractéristique peuvent signaler les états suivants dans le cadre de l'opération QUERY
. Pour en savoir plus sur la gestion des intents QUERY
, consultez la section Traitement des intents.
États | Type | Description |
---|---|---|
rotationDegrees |
Number |
Niveau actuel dans |
rotationPercent |
Number |
Niveau actuel indiquant le pourcentage de rotation actuel de l'appareil. 0,0 correspond à fermé et 100,0 à ouvert. |
targetRotationPercent |
Number |
Niveau indiquant le pourcentage de rotation vers lequel l'appareil ira ou se déplacera en raison d'un changement de rotation en cours. |
Exemples
Quel est le degré de rotation de l'appareil ? (pourcentages et degrés).
{ "rotationDegrees": 45, "rotationPercent": 25 }
Quel est le degré de rotation de l'appareil ? (degrés uniquement).
{ "rotationDegrees": 45 }
Quel est le degré de rotation de l'appareil ? (en continu).
{ "rotationDegrees": 270, "rotationPercent": 75 }
Un appareil qui tourne actuellement à une nouvelle position (pourcentage)
{ "rotationPercent": 75, "targetRotationPercent": 100 }
Appareil COMMANDS
Les appareils dotés de cette caractéristique peuvent répondre aux commandes suivantes dans le cadre de l'opération EXECUTE
. Pour en savoir plus sur la gestion des intents EXECUTE
, consultez la section Traitement des intents.
action.devices.commands.RotateAbsolute
Définissez la rotation absolue de l'appareil.
Paramètres
La charge utile contient l'un des éléments suivants:
Définissez la rotation absolue en degrés.
Paramètres | Type | Description |
---|---|---|
rotationDegrees |
Number |
Obligatoire. Valeur absolue, en degrés, qui spécifie la rotation finale de l'appareil dans le sens des aiguilles d'une montre. La valeur doit être comprise dans l'attribut |
Définissez la rotation absolue en pourcentage.
Paramètres | Type | Description |
---|---|---|
rotationPercent |
Number |
Obligatoire. Valeur absolue, en pourcentage, qui spécifie la rotation finale de l'appareil. |
Exemples
Inclinez l'appareil à 50 %.
{ "command": "action.devices.commands.RotateAbsolute", "params": { "rotationPercent": 50 } }
Faites pivoter l'appareil de 15 degrés dans le sens inverse des aiguilles d'une montre (rotationDegrees: 45
).
{ "command": "action.devices.commands.RotateAbsolute", "params": { "rotationDegrees": 30 } }
Faites pivoter l'appareil de 100 degrés dans le sens des aiguilles d'une montre (supportsContinuousRotation: true
, rotationDegrees: 270
).
{ "command": "action.devices.commands.RotateAbsolute", "params": { "rotationDegrees": 10 } }
Erreurs associées
Une erreur s'est produite lors du paramétrage de la rotation de l'appareil.
Valeurs acceptées :
deviceJammingDetected