Schéma illustrant le parcours de vitesse du ventilateur de 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 (c'est-à-dire le souffle de l'appareil à différents niveaux, pouvant faire partie d'un système de climatisation ou de chauffage, ou dans une voiture) peut inclure des paramètres tels que faible, moyen, élevé ou un pourcentage.

Attributs d'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 Booléen

(Par défaut : false)

Si elle est définie sur "True", cet appareil peut lancer le ventilateur dans les deux sens et accepter la commande d'inversion de sens.

commandOnlyFanSpeed Booléen

(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 ni à un état de rapport pour cette caractéristique.

Contient l'un des éléments suivants:
0 Objet

Compatibilité avec les paramètres de vitesse.

availableFanSpeeds Objet

Obligatoire.

Paramètres de débit compatibles avec l'appareil.

speeds Array

Obligatoire.

Liste des paramètres de vitesse.

[item, ...] Objet

Paramètre "Vitesse".

speed_name String

Obligatoire.

Nom interne du paramètre de vitesse. Elle peut être non conviviale et sera partagée dans toutes les langues.

speed_values Array

Obligatoire.

Synonymes du paramètre de vitesse dans toutes les langues compatibles.

[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 pluriel et au singulier, 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 Booléen

Obligatoire.

Si la valeur est "true", une grammaire supplémentaire pour la logique d'augmentation ou de diminution s'applique, dans l'ordre (augmenter) du tableau des vitesses.

1 Objet

Prise en charge du pourcentage de vitesse.

supportsFanSpeedPercent Booléen

Obligatoire.

(Par défaut : false)

Si cette règle 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 paramètres de vitesse, possibilité d'inverser la direction et d'ajuster le 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
}

Device 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 la section Traitement des intents.

États Type Description
currentFanSpeedSetting String

Il s'agit du 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 sont les ventilateurs du salon ?

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

COMMANDS d'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éfinir 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.

Réglages 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é.

Exemples

Réglez le ventilateur en mode élevé.

{
  "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 en fonction du poids.

Paramètres Type Description
fanSpeedRelativeWeight Entier

Obligatoire.

Cette valeur indique le degré relatif de changement 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

Baissez légèrement 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

Inversez la direction du ventilateur.

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

Paramètres

Paramètres Type Description

Aucune propriété

Exemples

Inversez la direction 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 medel

ERREURS sur l'appareil

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