Schéma des caractéristiques 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éristique appartient à tous les appareils disposant d'un nombre arbitraire de modes "nway" (voies nues), dans lequel les modes et les paramètres de chaque mode sont arbitraires et uniques à chaque appareil ou type d'appareil. Chaque mode peut être associé à plusieurs paramètres, mais il n'est possible d'en sélectionner qu'un à la fois. Le sèche-linge ne peut pas être en mode "Delicate", "Normal" ni "Fort duty". Un paramètre qui peut être simplement activé ou désactivé appartient au caractère Activer/Désactiver.
Par exemple, il est possible de configurer la taille et la température de la machine à laver. Ces deux modes sont indépendants, mais 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 à l'aide d'une commande telle que Régler la température du lave-linge sur le mode froid.
Certains modes sont "classés" et peuvent également être ajustés à l'aide de commandes de haut en bas et d'augmentation/diminution. Par exemple, la taille de charge (petite, moyenne, grande) et la température sont classées dans un ordre précis (notez que la température n'est pas un thermostat réel avec une valeur numérique cible, comme sur d'autres appareils), mais ce n'est peut-être pas le cas du type de charge (secteur, normal, 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 des fonctionnalités dissociées du comportement d'autres appareils. Les comportements associés, comme l'allumage ou l'arrêt de l'appareil, doivent utiliser des caractéristiques plus spécifiques (par exemple, thermostatMode
dans la caractéristique SettingSetting).
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 |
---|---|---|
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. Cette option n'est pas facile à utiliser et sera partagée 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. Cette option n'est pas facile à utiliser et sera partagée dans toutes les langues. |
setting_values |
Array |
Obligatoire. Synonymes du paramètre dans chaque langue compatible. |
[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 ou de diminution 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 (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. |
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 des informations d'é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 sur lequel seules les commandes vocales sont activées.
{ "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 appareils associés à 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 |
---|---|---|
currentModeSettings |
Objet |
Obligatoire. Paire clé/valeur avec le mode |
<string> |
Chaîne |
|
Exemples
Dans quel mode l'appareil est-il disponible ?
{ "currentModeSettings": { "load_mode": "small_load", "temp_mode": "cold_temp" } }
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.SetModes
Paramètres du mode de mise à jour.
Paramètres
Paramètres | Type | Description |
---|---|---|
updateModeSettings |
Objet |
Obligatoire. Paire clé/valeur avec le mode |
<string> |
Chaîne |
Nouveau |
Exemples
Charge importante
{ "command": "action.devices.commands.SetModes", "params": { "updateModeSettings": { "load_mode": "large_load" } } }
Exemples d'énoncés
de-DE
-
Stelle
den Staubsauger aufRuhemodus
en-US
-
set
the vacuum toenergy saver mode
es-ES
-
pon
la lavadora en modofrío
fr-FR
-
mets
l'aspirateur ensilencieux
hi-IN
-
वैक्यूम परकार्पेट मोड लगाएं
it-IT
-
imposta
l'aspirapolvere susilenzioso
ja-JP
-
掃除機 を静音 モードに設定して
ko-KR
-
세탁기 세탁량 많음 으로 설정해
pt-BR
-
acionar a função
autolimpeza doaspirador -
ligar o modo de
aquecimento