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 par degré, le sens de rotation par défaut est dans le sens des aiguilles d'une montre.

ATTRIBUTS de l'appareil

Les appareils disposant de cette caractéristique peuvent signaler les attributs suivants lors de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez 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 en pourcentage

rotationDegreesRange Objet

Représente la plage en degrés qu'un appareil peut faire 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éfini sur "true" si l'appareil autorise la rotation continue. Lorsqu'une requête relative est donné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 (true) ou bidirectionnelle (false). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ou Report Report 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 ne prend en charge que 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
}

Appareil 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 Traitement des intents.

États Type Description
rotationDegrees Number

Niveau actuel dans rotationDegreesRange, indiquant 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 actuel de l'appareil. 0,0 correspond à fermé et 100,0 à ouvrir.

Exemples

Quelle est la rotation de l'appareil ? (pourcentages et degrés).

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

Quelle est la rotation de l'appareil ? (uniquement les degrés).

{
  "rotationDegrees": 45
}

Quelle est la rotation de l'appareil ? (continu).

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

Appareil COMMANDS

Les appareils disposant 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 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 dans le sens des aiguilles d'une montre de l'appareil. La valeur doit correspondre à 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
  }
}

Tournez l'appareil de 100 degrés vers la droite (supportsContinuousRotation: true, rotationDegrees: 270).

{
  "command": "action.devices.commands.RotateAbsolute",
  "params": {
    "rotationDegrees": 10
  }
}

Une erreur s'est produite lors de la configuration de la rotation de l'appareil.

Valeurs acceptées :

deviceJammingDetected

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.