Schéma du Trait FanSpeed pour la maison connectée

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

La vitesse du ventilateur (soufflage d'air de l'appareil à différents niveaux, qui peut faire partie d'un système de climatisation ou de chauffage, ou dans une voiture) peut inclure des paramètres tels que faible, moyen et élevé, ou un pourcentage.

ATTRIBUTS de l'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
reversible Valeur booléenne

(Par défaut : false)

Si cette valeur est définie sur "True", cet appareil permet de faire souffler le ventilateur dans les deux sens et peut accepter la commande pour inverser la direction du ventilateur.
commandOnlyFanSpeed Valeur booléenne

(Par défaut : false)

Indique si l'appareil prend en charge 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.
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. Cette approche peut ne pas être conviviale et sera utilisée dans toutes les langues.
speed_values Array

Obligatoire.

Synonyme du paramètre de vitesse dans chaque langue prise en charge.
[item, ...] Objet

Synonyme du paramètre de vitesse dans une langue donnée.
speed_synonym Array

Obligatoire.

Les synonymes du paramètre de vitesse doivent inclure les formes au singulier et au pluriel, 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.
lang String

Obligatoire.

Code de langue (ISO 639-1) Consultez la liste des langues acceptées.
ordered Valeur booléenne

Obligatoire.

Si ce paramètre est défini sur "true", une grammaire supplémentaire pour la logique d'augmentation ou de diminution s'applique, dans l'ordre (croissant) du tableau des vitesses.
1 Objet

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

Obligatoire.

(Par défaut : false)

Si cette valeur est définie sur "True", cet appareil accepte les commandes permettant d'ajuster la vitesse à l'aide d'un pourcentage compris entre 0,0 et 100,0.

Exemples

Appareil avec deux vitesses, marche arrière et 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 avec 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
currentFanSpeedSetting String

Nom interne du paramètre de vitesse actuel issu de l'attribut availableFanSpeeds.
currentFanSpeedPercent Number

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

Exemples

À quelle vitesse tournent les ventilateurs du salon ?

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

COMMANDES DE L'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.SetFanSpeed

Définissez la vitesse.

Paramètres

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

Définissez la vitesse en fonction des paramètres.

Paramètres Type Description
fanSpeed String

Obligatoire.

Réglages de vitesse demandés pour le ventilateur.

Définissez la vitesse en pourcentage.

Paramètres Type Description
fanSpeedPercent Number

Obligatoire.

Pourcentage du paramètre de vitesse demandé.

Exemples

Mettez le ventilateur en vitesse élevée.

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

Réglez le ventilateur sur 50 %.

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

action.devices.commands.SetFanSpeedRelative

Définissez 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éfinissez la vitesse relative en fonction du poids.

Paramètres Type Description
fanSpeedRelativeWeight Entier

Obligatoire.

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

Définissez la vitesse relative en pourcentage.

Paramètres Type Description
fanSpeedRelativePercent Number

Obligatoire.

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

Exemples

Baisse un peu la vitesse du ventilateur.

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

Augmentez la vitesse du ventilateur de 10 %.

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

action.devices.commands.Reverse

Inversez 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

Inversez 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 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.