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.
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 : 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 : 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 : 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 entités présentant 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 |
currentFanSpeedPercent |
Number |
Indique la vitesse actuelle du ventilateur en pourcentage. Obligatoire si la valeur de l'attribut |
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 aufhoch
en-US
-
drop
the AC fan speed tomedium
es-ES
-
cambia la velocidad del
ventilador amedio
fr-FR
-
mets
la ventilation aumaximum
hi-IN
-
बेडरूम में पंखे
की गति
मीडियम करें
it-IT
-
metti
il condizionatore in salotto a velocitàmedia
ja-JP
-
エアコン の風量を高速 にセット
ko-KR
-
선풍기 강풍 으로 틀어 줘
nl-NL
-
zet de snelheid van
de ventilator opmedium
pt-BR
-
definir a velocidade do
ventilador parabaixa -
põe
a ventoinha nomá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.