Schéma Trait de la maison connectée
action.devices.traits.Modes : cette caractéristique couvre tous les modes disponibles et les paramètres spécifiques au mode d'un appareil.
Cette caractéristiques appartient à tous les appareils dotés d'un nombre arbitraire de modes "directionnels", dans lesquels les modes et paramètres de chaque mode sont arbitraires et uniques à chaque appareil ou type d'appareil. Chaque mode a plusieurs paramètres possibles, mais il n'est possible de sélectionner qu'un seul à la fois. Le sèche-linge ne peut pas être en même temps en mode "détail", "normal" et "lourd". Un paramètre qui peut simplement être activé ou désactivé appartient à la caractéristique Toggles.
Par exemple, un lave-linge peut configurer différents paramètres de taille et de température de chargement. Ces deux modes sont indépendants, car ils sont indépendants, mais ne peuvent être que dans un seul état à la fois. L'utilisateur peut définir explicitement un mode tel que la température avec une commande telle que Régler la température du lave-linge sur froid.
Certains modes sont "classés" et peuvent également être réglés avec le haut ou le bas, ou augmenter ou diminuer le verbiage. Par exemple, la taille de la charge (petite, moyenne, grande) et la température sont classées dans le bon ordre (notez que la température n'est pas un thermostat réel avec une cible numérique, comme sur les autres appareils), mais pas le type de charge (produits délicats, laine, etc.).
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 les fonctionnalités dissociées du comportement d'autres appareils. Les comportements associés, par exemple l'allumage ou l'arrêt de l'appareil, doivent utiliser des caractéristiques plus spécifiques (par exemple, thermostatMode dans le attribut TemperatureSetting).
ATTRIBUTS de l'appareil
Les appareils disposant de cette caractéristique peuvent signaler les attributs suivants lors de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Traitement des intents.
| Attributs | Type | Description |
|---|---|---|
availableModes |
Array |
Obligatoire. Liste des modes disponibles. |
[item, ...] |
Objet |
Mode disponible. |
name |
Chaîne |
Obligatoire. Nom interne du mode, qui sera utilisé dans les commandes et les états. Il n'est pas facile à utiliser et sera partagé dans toutes les langues. |
name_values |
Array |
Obligatoire. Synonymes du mode dans chaque langue acceptée. |
[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, ...] |
Chaîne |
Nom du synonyme. |
lang |
Chaîne |
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 articles. |
setting_name |
Chaîne |
Obligatoire. Nom interne du paramètre de mode, qui sera utilisé dans les commandes et les états. Il n'est pas facile à utiliser et sera partagé dans toutes les langues. |
setting_values |
Array |
Obligatoire. Synonymes du paramètre dans chaque langue acceptée. |
[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, ...] |
Chaîne |
Nom du synonyme. |
lang |
Chaîne |
Obligatoire. Code de langue (ISO 639-1). Consultez la liste des langues acceptées. |
ordered |
Booléen |
(Par défaut : Si cette règle est définie sur "True", la grammaire supplémentaire pour la logique d'augmentation/de réduction s'applique, dans l'ordre (augmentation) du tableau de paramètres. |
commandOnlyModes |
Booléen |
(Par défaut : Indique si l'appareil est compatible avec la communication unidirectionnelle (true) ou bidirectionnelle (false). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ou Report Report pour cette caractéristique. |
queryOnlyModes |
Booléen |
(Par défaut : Obligatoire si l'appareil est compatible avec l'exécution de requêtes uniquement. Cet attribut indique si l'appareil ne peut être interrogé que pour obtenir des informations sur l'état et ne peut pas être contrôlé. |
Exemples
Appareil avec plusieurs modes et paramètres
{
"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 commandes 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
}
Appareil 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 Traitement des intents.
| États | Type | Description |
|---|---|---|
currentModeSettings |
Objet |
Obligatoire. Paire clé/valeur avec le mode |
<string> |
Chaîne |
|
Exemples
Dans quel mode se trouve l'appareil ?
{
"currentModeSettings": {
"load_mode": "small_load",
"temp_mode": "cold_temp"
}
}
Appareil COMMANDS
Les appareils disposant 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 Traitement des intents.
action.devices.commands.SetModes
Mettez à jour les paramètres du mode.
Paramètres
| Paramètres | Type | Description |
|---|---|---|
updateModeSettings |
Objet |
Obligatoire. Paire clé/valeur avec le mode |
<string> |
Chaîne |
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