Schéma de Trait pour la maison connectée
action.devices.traits.Modes
: cette caractéristique couvre tous les modes disponibles et les paramètres spécifiques à chaque mode sur un appareil.
Cette caractéristique appartient à tous les appareils avec un nombre arbitraire de modes "n-way", dans lesquels les modes et les paramètres de chaque mode sont arbitraires et uniques pour chaque appareil ou type d'appareil. Chaque mode offre plusieurs paramètres, mais il n'est possible de sélectionner qu'un seul sèche-linge à la fois. Un sèche-linge ne peut pas être à la fois en mode délicat, normal et intensive. Un paramètre qui peut simplement être activé ou désactivé appartient à la caractéristique Toggles.
Par exemple, une machine à laver peut configurer des réglages pour le volume de chargement et la température. Il s'agit dans les deux cas de modes, car ils sont indépendants l'un de l'autre, mais chacun ne peut se trouver que dans un seul état à la fois. L'utilisateur peut définir explicitement un mode comme la température à l'aide d'une commande telle que Définir la température du lave-linge sur froid.
Certains modes sont "classés" et peuvent également être ajustés à l'aide du texte à la hausse ou à la baisse, ou du texte augmenter/diminuer. Par exemple, la taille de charge (petite, moyenne, grande) et la température sont clairement ordonnées (notez que la température n'est pas un thermostat réel avec une cible numérique, comme sur d'autres appareils), mais le type de charge (délicats, normal, laine, etc.) peut ne pas l'être.
Cette caractéristique couvre un ou plusieurs modes individuels que les utilisateurs peuvent définir. En général, ces modes doivent être utilisés pour des fonctionnalités dissociées des autres comportements de l'appareil. Les comportements associés, tels que l'allumage ou l'arrêt de l'appareil lui-même, doivent utiliser des caractéristiques plus spécifiques (par exemple, thermostatMode
dans la caractéristique TemperatureSetting).
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 |
---|---|---|
availableModes |
Array |
Obligatoire. Liste des modes disponibles. |
[item, ...] |
Objet |
Mode disponible. |
name |
String |
Obligatoire. Nom interne du mode, qui sera utilisé dans les commandes et les états. Elle peut être non conviviale et sera partagée dans toutes les langues. |
name_values |
Array |
Obligatoire. Synonymes du mode dans chaque langue disponible. |
[item, ...] |
Objet |
Synonymes du mode dans une langue donnée. |
name_synonym |
Array |
Obligatoire. Synonymes du mode. La première chaîne de cette liste est utilisée comme nom canonique du niveau dans cette langue. |
[item, ...] |
String |
Nom du synonyme. |
lang |
String |
Obligatoire. Code de langue (ISO 639-1). Consultez la liste des langues acceptées. |
settings |
Array |
Obligatoire. Paramètres compatibles avec ce mode. |
[item, ...] |
Objet |
Paramètre compatible. Nécessite au moins deux éléments. |
setting_name |
String |
Obligatoire. Nom interne du paramètre de mode, qui sera utilisé dans les commandes et les états. Elle peut être non conviviale et sera partagée dans toutes les langues. |
setting_values |
Array |
Obligatoire. Synonymes du paramètre dans chacune des langues disponibles. |
[item, ...] |
Objet |
Synonymes du paramètre dans une langue donnée. |
setting_synonym |
Array |
Obligatoire. Synonymes du paramètre. La première chaîne de cette liste est utilisée comme nom canonique du niveau dans cette langue. |
[item, ...] |
String |
Nom du synonyme. |
lang |
String |
Obligatoire. Code de langue (ISO 639-1). Consultez la liste des langues acceptées. |
ordered |
Booléen |
(Par défaut : Si la valeur est "true", une grammaire supplémentaire pour la logique d'augmentation/diminution s'applique, dans l'ordre (croissant) du tableau des paramètres. |
commandOnlyModes |
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. |
queryOnlyModes |
Booléen |
(Par défaut : Obligatoire si l'appareil permet l'exécution de requêtes uniquement. Cet attribut indique si l'appareil ne peut être interrogé que pour des informations d'état, et ne peut pas être contrôlé. |
Exemples
Appareil avec modes et paramètres multiples.
{ "availableModes": [ { "name": "load_mode", "name_values": [ { "name_synonym": [ "Load", "Size", "Load size" ], "lang": "en" } ], "settings": [ { "setting_name": "small_load", "setting_values": [ { "setting_synonym": [ "Small", "Half" ], "lang": "en" } ] }, { "setting_name": "medium_load", "setting_values": [ { "setting_synonym": [ "Medium", "Normal" ], "lang": "en" } ] }, { "setting_name": "large_load", "setting_values": [ { "setting_synonym": [ "Large", "Full" ], "lang": "en" } ] } ], "ordered": true }, { "name": "temp_mode", "name_values": [ { "name_synonym": [ "Temperature", "Temp" ], "lang": "en" } ], "settings": [ { "setting_name": "hot_temp", "setting_values": [ { "setting_synonym": [ "Hot", "White" ], "lang": "en" } ] }, { "setting_name": "warm_temp", "setting_values": [ { "setting_synonym": [ "Warm", "Color" ], "lang": "en" } ] }, { "setting_name": "cold_temp", "setting_values": [ { "setting_synonym": [ "Cold", "Delicate" ], "lang": "en" } ] } ], "ordered": false } ] }
Appareil avec modes "Commande uniquement"
{ "availableModes": [ { "name": "light_mode", "name_values": [ { "name_synonym": [ "Light", "Lighting" ], "lang": "en" } ], "settings": [ { "setting_name": "day_light", "setting_values": [ { "setting_synonym": [ "Day", "Bright" ], "lang": "en" } ] }, { "setting_name": "night_light", "setting_values": [ { "setting_synonym": [ "Night", "Dark" ], "lang": "en" } ] }, { "setting_name": "reading_light", "setting_values": [ { "setting_synonym": [ "Reading", "Ambiant" ], "lang": "en" } ] } ], "ordered": false } ], "commandOnlyModes": true, "queryOnlyModes": false }
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 |
---|---|---|
currentModeSettings |
Objet |
Obligatoire. Paire clé-valeur avec le mode |
<string> |
String |
|
Exemples
Dans quel mode est l'appareil ?
{ "currentModeSettings": { "load_mode": "small_load", "temp_mode": "cold_temp" } }
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.SetModes
Paramètres du mode de mise à jour.
Paramètres
Paramètres | Type | Description |
---|---|---|
updateModeSettings |
Objet |
Obligatoire. Paire clé-valeur avec le mode |
<string> |
String |
Nouveau |
Exemples
Définissez une charge importante.
{ "command": "action.devices.commands.SetModes", "params": { "updateModeSettings": { "load_mode": "large_load" } } }
Exemples d'énoncés
de-DE
- Stelle den Staubsauger auf Ruhemodus
en-US
- set the vacuum to energy saver mode
es-ES
- pon la lavadora en modo frío
fr-FR
- mets l'aspirateur en silencieux
hi-IN
- वैक्यूम पर कार्पेट मोड लगाएं
it-IT
- imposta l'aspirapolvere su silenzioso
ja-JP
- 掃除機 を 静音 モードに設定して
ko-KR
- 세탁기 세탁량 많음 으로 설정해
pt-BR
- acionar a função autolimpeza do aspirador
- ligar o modo de aquecimento