Schéma du trait de rotation de la maison connectée

action.devices.traits.Rotation : cette caractéristique appartient aux appareils compatibles avec 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	Booléen	Obligatoire. Défini sur "true" si l'appareil autorise la rotation par degré.
supportsPercent	Booléen	Obligatoire. Défini sur "true" si l'appareil autorise la rotation par pourcentage
rotationDegreesRange	Objet	Représente la plage, en degrés, pendant laquelle un appareil peut pivoter.
rotationDegreesMin	Number	Obligatoire. Rotation minimale en degrés.
rotationDegreesMax	Number	Obligatoire. Rotation maximale en degrés.
supportsContinuousRotation	Booléen	(Par défaut : false) Définissez cette valeur sur "true" si l'appareil autorise la rotation continue. Lorsqu'une requête relative est exécutée, la commande RotateAbsolute encapsule la plage de rotation compatible.
commandOnlyRotation	Booléen	(Par défaut : false) Indique si l'appareil est compatible avec la communication unidirectionnelle (vrai) ou bidirectionnelle (faux). 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 qui n'accepte la rotation qu'en degrés.

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

Device STATES

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 rotationDegreesRange, qui indique le degré de rotation de l'appareil. Cette valeur doit toujours être relative à la rotation dans le sens des aiguilles d'une montre.
rotationPercent	Number	Niveau actuel indiquant le pourcentage de rotation de l'appareil. 0,0 correspond à fermé et 100,0 à ouvert.

Exemples

À quel point l'appareil fait-il pivoter ? (pourcentages et degrés).

{
  "rotationDegrees": 45,
  "rotationPercent": 25
}

À quel point l'appareil fait-il pivoter ? (degrés uniquement).

{
  "rotationDegrees": 45
}

À quel point l'appareil fait-il pivoter ? (en continu).

{
  "rotationDegrees": 270,
  "rotationPercent": 75
}

COMMANDS d'appareil

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, indiquant la rotation finale de l'appareil dans le sens des aiguilles d'une montre. La valeur doit être comprise dans l'attribut rotationDegreesRange.

Définissez la rotation absolue en pourcentage.

Paramètres	Type	Description
rotationPercent	Number	Obligatoire. Valeur absolue, en pourcentage, indiquant 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

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.