Schéma du trait Smart Home FanSpeed

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

Les vitesses de ventilation (c'est-à-dire l'air soufflé par l'appareil à différents niveaux, qui peuvent faire partie d'un système de climatisation ou de chauffage, ou dans une voiture) peuvent inclure des paramètres tels que "basse", "moyenne" et "haute", 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 Fulfillment d'intent.

Attributs Type Description
reversible Valeur booléenne

(Par défaut : false)

Si la valeur est définie sur "true", cet appareil peut souffler de l'air dans les deux sens et accepter la commande d'inversion du sens du ventilateur.
commandOnlyFanSpeed Valeur booléenne

(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 à une intention QUERY ni à un rapport d'état pour ce trait.
Contient l'un des éléments suivants :
0 Objet

Compatibilité avec les réglages de vitesse.
availableFanSpeeds Objet

Obligatoire.

Paramètres de vitesse pris en charge par l'appareil.
speeds Array

Obligatoire.

Liste des vitesses.
[item, ...] Objet

Réglage de la vitesse.
speed_name String

Obligatoire.

Nom interne du paramètre de vitesse. Cela peut être peu pratique pour les utilisateurs et sera partagé dans toutes les langues.
speed_values Array

Obligatoire.

Synonymes du paramètre de vitesse dans chaque langue acceptée.
[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 secours.
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 réglage de la vitesse.
[item, ...] String

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

Obligatoire.

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

Obligatoire.

Si la valeur est définie sur "true", une grammaire supplémentaire pour la logique d'augmentation ou de diminution s'appliquera, 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 la 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 réglages de vitesse, compatible avec le sens inverse et les 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 des appareils

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 Fulfillment d'intent.

États Type Description
currentFanSpeedSetting String

Il s'agit du 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

Exemples

À quelle vitesse tournent les 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 Fulfillment d'intent.

action.devices.commands.SetFanSpeed

Définissez la vitesse.

Paramètres

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

Définissez la vitesse dans les paramètres.

Paramètres Type Description
fanSpeed String

Obligatoire.

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

Définissez la vitesse en pourcentage.

Paramètres Type Description
fanSpeedPercent Number

Obligatoire.

Pourcentage de réglage de la vitesse demandé.

Exemples

Mets la ventilation sur "élevée".

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

Règle 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 par poids.

Paramètres Type Description
fanSpeedRelativeWeight Entier

Obligatoire.

Cette valeur indique l'ampleur relative de la modification de la vitesse. La valeur absolue indique le montant mis à l'échelle, tandis que le signe numérique indique le sens de la variation.

Définissez la vitesse relative en pourcentage.

Paramètres Type Description
fanSpeedRelativePercent Number

Obligatoire.

Cette valeur représente le pourcentage de variation de la vitesse.

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

J'inverse 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 liées à 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.