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

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

La vitesse du ventilateur (soufflage d'air à différents niveaux, qui peuvent faire partie de la climatisation ou du chauffage, ou dans une voiture), peuvent inclure des paramètres (faible, moyen ou élevé, par exemple). ou un pourcentage.

ATTRIBUTS D'appareils

Les appareils présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération SYNC. Pour apprendre Pour en savoir plus sur la gestion des intents SYNC, consultez Traitement des intents.

Attributs Type Description
reversible Valeur booléenne

(Par défaut : false)

Si elle est définie sur "True", cet appareil permet de souffler le ventilateur dans les deux sens et d'inverser la direction du ventilateur.

commandOnlyFanSpeed Valeur booléenne

(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 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 acceptés par 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.

Synonymes du paramètre de vitesse dans chaque langue compatible.

[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 est 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 elle est définie sur "true", une grammaire supplémentaire pour la logique d'augmentation ou de diminution s'applique, dans l'ordre (croissant) du tableau "speeds".

1 Objet

Prise en charge du pourcentage de vitesse.

supportsFanSpeedPercent Valeur booléenne

Obligatoire.

(Par défaut : false)

Si elle est définie sur "True", cet appareil accepte les commandes de réglage de la vitesse à l'aide d'un pourcentage compris entre 0,0 et 100,0.

Exemples

Appareil avec deux paramètres 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
}

STATES de l'appareil

Les entités présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération QUERY. Pour apprendre Pour en savoir plus sur la gestion des intents QUERY, consultez 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 sont les ventilateurs du salon ?

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

COMMANDS d'appareils

Les appareils présentant cette caractéristique peuvent répondre aux éléments suivants : dans le cadre de l'opération EXECUTE. Pour apprendre Pour en savoir plus sur la gestion des intents EXECUTE, consultez 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 en fonction des 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ègle le ventilateur sur la température é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 en fonction du poids.

Paramètres Type Description
fanSpeedRelativeWeight Entier

Obligatoire.

Cette valeur indique l'ampleur relative du changement de vitesse. La valeur absolue indique la quantité 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

Inverser 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

<ph type="x-smartling-placeholder">

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 d'appareil

Voir la liste complète les erreurs et les 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.