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.
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 : 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 : 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 : 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 |
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'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 på 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.