Bienvenue dans le Centre des développeurs Google Home, la nouvelle destination pour apprendre à développer des actions pour la maison connectée. Remarque : Vous continuerez à créer des actions dans la console Actions.
Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Schéma Trait de ventilateur de maison connectée

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

Les vitesses de ventilateur (c'est-à-dire les soufflages d'air de l'appareil à différents niveaux ;

Appareil : ATTRIBUTES

Les appareils associés à 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 page Traitement des intents.

Attributs Type Description
reversible Booléen

(Par défaut : false)

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

commandOnlyFanSpeed Booléen

(Par défaut : false)

Indique si l'appareil est compatible avec la communication unidirectionnelle (vraie) ou bidirectionnelle (fausse). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ou Signaler un état 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 vitesse compatibles avec l'appareil.

speeds Array

Obligatoire.

Liste des paramètres de vitesse.

[item, ...] Objet

Paramètre de vitesse.

speed_name Chaîne

Obligatoire.

Nom interne du paramètre de vitesse. Cette option n'est pas facile à utiliser et sera partagé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 sera considéré comme le nom canonique du paramètre de vitesse.

[item, ...] Chaîne

Synonyme.

lang Chaîne

Obligatoire.

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

ordered Booléen

Obligatoire.

Si la valeur est définie sur "true", des règles de grammaire supplémentaires pour la logique d'augmentation ou de diminution s'appliquent, dans l'ordre (augmentation) du tableau des vitesses.

1 Objet

Compatibilité avec le pourcentage de vitesse

supportsFanSpeedPercent Booléen

Obligatoire.

(Par défaut : false)

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

Exemples

Appareil doté de deux paramètres de vitesse, avec une fonction d'inversion de direction et de 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
}

Appareil : STATES

Les appareils associés à 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 page Traitement des intents.

États Type Description
currentFanSpeedSetting Chaîne

Il s'agit du nom interne du paramètre de vitesse actuel de l'attribut availableFanSpeeds.

currentFanSpeedPercent Number

Indique la vitesse actuelle du ventilateur en pourcentage. Obligatoire si la valeur de l'attribut supportsFanSpeedPercent est true

Exemples

À quelle vitesse les ventilateurs se trouvent-ils dans le salon ?

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

Appareil COMMANDS

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 page 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 Chaîne

Obligatoire.

Les paramètres de vitesse demandés par 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 haut.

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

Paramètres Type Description
fanSpeedRelativeWeight Entier

Obligatoire.

Cette valeur indique le pourcentage relatif de la variation de vitesse. La valeur absolue indique le montant mis à l'échelle, tandis que le signe numérique indique le sens 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

Diminuez 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

de-DE

  • Stell die Geschwindigkeit vom Ventilator auf hoch

en-US

  • abaissez la climatisation du ventilateur à moyen

es-ES

  • cambia la velocidad del ventilador medio

fr-FR

  • auvent au maximum

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.