Schéma du trait FanSpeed (Vitesse du ventilateur) pour la maison connectée

action.devices.traits.FanSpeed : ce trait appartient aux appareils qui permettent de régler la vitesse d'un ventilateur.

Les vitesses du ventilateur (c'est-à-dire le débit d'air de l'appareil à différents niveaux, qui peuvent faire partie d'un climatiseur ou d'un chauffage, ou dans une voiture) peuvent inclure des paramètres tels que faible, moyen et élevé, ou un pourcentage.

ATTRIBUTS de l'appareil

Les appareils dotés de ce trait peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Exécution des intents.

Attributs Type Description
reversible Valeur booléenne

(Par défaut : false)

Si la valeur est "true", cet appareil peut souffler dans les deux sens et accepter la commande permettant d'inverser le sens de rotation du ventilateur.
commandOnlyFanSpeed Valeur booléenne

(Par défaut : false)

Indique si l'appareil est compatible avec une 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 ce trait.
Contient l'un des éléments suivants :
0 Objet

Prise en charge des paramètres de vitesse.
availableFanSpeeds Objet

Obligatoire.

Paramètres de vitesse compatibles avec l'appareil.
speeds Array

Obligatoire.

Liste des paramètres de vitesse.
[item, ...] Objet

Paramètre de vitesse.
speed_name String

Obligatoire.

Nom interne du paramètre de vitesse. Il peut ne pas être convivial et sera partagé dans toutes les langues.
speed_values Array

Obligatoire.

Synonymes du paramètre de vitesse dans chaque langue compatible.
[item, ...] Objet

Synonyme du paramètre de vitesse dans une langue donnée. Au moins un élément avec une valeur lang de en est requis pour fournir une langue de remplacement.
speed_synonym Array

Obligatoire.

Synonymes du paramètre de vitesse, y compris les formes singulières et plurielles, le cas échéant. Le premier synonyme de la liste sera considéré comme le nom canonique du paramètre de vitesse.
[item, ...] String

Synonyme. Au moins un élément avec une valeur lang de en est requis pour fournir une langue de remplacement.
lang String

Obligatoire.

Code de langue (ISO 639-1). Découvrez les langues disponibles.
ordered Valeur booléenne

Obligatoire.

Si la valeur est "true", une grammaire supplémentaire pour la logique d'augmentation ou de diminution s'appliquera, dans l'ordre (croissant) de l'array des vitesses.
1 Objet

Prise en charge du pourcentage de vitesse.
supportsFanSpeedPercent Valeur booléenne

Obligatoire.

(Par défaut : false)

Si la valeur est "true", cet appareil accepte les commandes permettant de régler la vitesse à l'aide d'un pourcentage compris entre 0,0 et 100,0.

Exemples

Appareil avec deux paramètres de vitesse, prise en charge de l'inversion du sens de rotation et des ajustements en pourcentage.

{
  "availableFanSpeeds": {
    "speeds": [
      {
        "speed_name": "speed_low",
        "speed_values": [
          {
            "speed_synonym": [
              "Low",
              "Slow"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "speed_name": "speed_high",
        "speed_values": [
          {
            "speed_synonym": [
              "High",
              "Fast"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  },
  "reversible": true,
  "supportsFanSpeedPercent": true
}

ÉTATS de l'appareil

Les entités dotées de ce trait peuvent signaler les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez Exécution des intents.

États Type Description
currentFanSpeedSetting String

Représente le nom interne du paramètre de vitesse actuel à partir de l'attribut availableFanSpeeds.
currentFanSpeedPercent Number

Indique la vitesse actuelle du ventilateur en pourcentage. Obligatoire si l'attribut supportsFanSpeedPercent est défini sur true

La valeur doit être comprise entre 0 et 100.

Exemples

Quelle est la vitesse des ventilateurs du salon ?

{
  "currentFanSpeedSetting": "speed_low",
  "currentFanSpeedPercent": 10
}

COMMANDES de l'appareil

Les appareils dotés de ce trait 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 Exécution des intents.

action.devices.commands.SetFanSpeed

Définir la vitesse.

Paramètres

La charge utile contient l'un des éléments suivants :

Définir la vitesse par paramètres.

Paramètres Type Description
fanSpeed String

Obligatoire.

Paramètres de vitesse demandés pour le ventilateur.

Définir la vitesse en pourcentage.

Paramètres Type Description
fanSpeedPercent Number

Obligatoire.

Pourcentage du paramètre de vitesse demandé.

La valeur doit être comprise entre 0 et 100.

Exemples

Mets le ventilateur sur "élevé".

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeed": "speed_high"
  }
}

Mets le ventilateur sur 50%.

{
  "command": "action.devices.commands.SetFanSpeed",
  "params": {
    "fanSpeedPercent": 50
  }
}

action.devices.commands.SetFanSpeedRelative

Définir la vitesse relative.

Cette commande nécessite les attributs suivants : 
{
  "commandOnlyFanSpeed": true
}

Paramètres

La charge utile contient l'un des éléments suivants :

Définir la vitesse relative par pondération.

Paramètres Type Description
fanSpeedRelativeWeight Entier

Obligatoire.

Cette valeur indique la quantité relative de changement de vitesse. La valeur absolue indique la quantité mise à l'échelle, tandis que le signe numérique indique le sens du changement.

La valeur doit être comprise entre -5 et 5.

Définir la vitesse relative en pourcentage.

Paramètres Type Description
fanSpeedRelativePercent Number

Obligatoire.

Cette valeur représente le pourcentage de vitesse à modifier.

La valeur doit être comprise entre -100 et 100.

Exemples

Baisse un peu la vitesse du ventilateur.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativeWeight": -1
  }
}

Augmente la vitesse du ventilateur de 10 %.

{
  "command": "action.devices.commands.SetFanSpeedRelative",
  "params": {
    "fanSpeedRelativePercent": 10
  }
}

action.devices.commands.Reverse

Inverser le sens de rotation du ventilateur.

Cette commande nécessite les attributs suivants : 
{
  "reversible": true
}

Paramètres

Paramètres Type Description

Aucune propriété

Exemples

Inverse le sens de rotation du ventilateur.

{
  "command": "action.devices.commands.Reverse",
  "params": {}
}

Exemples d'énoncés

de-DE

  • stell die Geschwindigkeit vom Ventilator auf hoch

en-US

  • drop the AC fan speed to medium

es-ES

  • cambia la velocidad del ventilador a medio

fr-FR

  • mets la ventilation au maximum

hi-IN

  • बेडरूम में पंखे की गति मीडियम करें

it-IT

  • metti il condizionatore in salotto a velocità media

ja-JP

  • エアコン の風量を 高速 にセット

ko-KR

  • 선풍기 강풍 으로 틀어 줘

nl-NL

  • zet de snelheid van de ventilator op medium

pt-BR

  • definir a velocidade do ventilador para baixa
  • põe a ventoinha no máximo

sv-SE

  • Ställ in fläkten på medel

ERREURS de l'appareil

Consultez la liste complète des erreurs et des exceptions.
  • maxSpeedReached : l'appareil est déjà réglé sur la vitesse maximale.
  • minSpeedReached : l'appareil est déjà réglé sur la vitesse minimale.