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.
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 : 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 : 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 : 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 |
currentFanSpeedPercent |
Number |
Indique la vitesse actuelle du ventilateur en pourcentage. Obligatoire si l'attribut |
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 på 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.