Schéma de comportement 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, et si l'appareil est compatible avec la rotation par degrés, le sens de rotation par défaut est dans le sens des aiguilles d'une montre.

ATTRIBUTS D'appareils

Les appareils présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération SYNC. Pour apprendre Pour en savoir plus sur la gestion des intents SYNC, consultez 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 de 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 : false)

Défini sur "true" si l'appareil autorise la rotation continue. Lorsqu'elle est appliquée à une requête relative, la commande RotateAbsolute englobe la plage de rotation acceptée.
commandOnlyRotation Valeur booléenne

(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 ou à l'état du 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 uniquement avec la rotation 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
}

STATES de l'appareil

Les entités présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération QUERY. Pour apprendre Pour en savoir plus sur la gestion des intents QUERY, consultez Traitement des intents.

États Type Description
rotationDegrees Number

Niveau actuel dans rotationDegreesRange qui indique le nombre de degrés de rotation de l'appareil. Cette valeur doit toujours être définie par rapport à 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 à une fermeture et 100,0 à une ouverture.
targetRotationPercent Number

Niveau indiquant le pourcentage de rotation auquel l'appareil ira ou se déplacera suite à un changement de rotation en cours.

Exemples

De combien l'appareil est-il pivoté ? (pourcentages et degrés).

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

De combien l'appareil est-il pivoté ? (en degrés uniquement).

{
  "rotationDegrees": 45
}

De combien l'appareil est-il pivoté ? (en continu).

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

Un appareil qui tourne actuellement à une nouvelle position (pourcentage).

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

COMMANDS d'appareils

Les appareils présentant cette caractéristique peuvent répondre aux éléments suivants : dans le cadre de l'opération EXECUTE. Pour apprendre Pour en savoir plus sur la gestion des intents EXECUTE, consultez 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 indique 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, qui indique 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
  }
}

Une erreur s'est produite lors de la définition de la rotation de l'appareil.

Valeurs acceptées :

deviceJammingDetected

Erreurs d'appareil

Voir la liste complète les erreurs et les exceptions.