Schéma de trait d'activation et de désactivation de la maison connectée
action.devices.traits.Toggles
: cette caractéristique appartient à tout appareil dont les paramètres ne peuvent exister que dans l'un des deux états.
Ces paramètres peuvent représenter un bouton physique avec un état activé/désactivé ou actif/inactif, une case à cocher en HTML ou tout autre type d'élément spécifiquement activé/désactivé. Si le paramètre comporte plus de deux états ou qu'il présente un état dans lequel aucune des options binaires n'est sélectionnée, il est mieux représenté par un trait Modes, qui équivaut à des cadrans à plusieurs états, des cases d'option (physique ou HTML) ou des états binaires qui ne sont pas explicitement activés/désactivés (par exemple, "AM/FM" ou "chaud/froid").
Cette caractéristique couvre un ou plusieurs boutons d'activation/de désactivation que les utilisateurs peuvent définir. En général, ces boutons d'activation/de désactivation 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 |
---|---|---|
availableToggles |
Array |
Obligatoire. Liste des boutons d'activation/de désactivation disponibles. |
[item, ...] |
Objet |
Bouton d'activation/de désactivation disponible. |
name |
String |
Obligatoire. Nom interne du bouton d'activation, 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 bouton d'activation dans chaque langue disponible. |
[item, ...] |
Objet |
Synonymes du bouton d'activation dans une langue donnée. |
name_synonym |
Array |
Obligatoire. Synonymes du bouton d'activation. 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. |
commandOnlyToggles |
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. |
queryOnlyToggles |
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 activation/désactivation multiple :
{ "availableToggles": [ { "name": "sterilization_toggle", "name_values": [ { "name_synonym": [ "Clean", "Bio clean" ], "lang": "en" } ] }, { "name": "energysaving_toggle", "name_values": [ { "name_synonym": [ "Energy saving", "Eco" ], "lang": "en" } ] } ] }
Appareil avec boutons d'activation/de désactivation basés uniquement sur la commande :
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "commandOnlyToggles": true }
Appareil avec activation/désactivation des requêtes uniquement :
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "queryOnlyToggles": true }
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 |
---|---|---|
currentToggleSettings |
Objet |
Obligatoire. Paire clé/valeur avec le bouton d'activation |
<string> |
Booléen |
État actuel d'activation/de désactivation. |
Exemples
La stérilisation est-elle activée ?
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
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.SetToggles
Définit un état d'activation donné.
Paramètres
Paramètres | Type | Description |
---|---|---|
updateToggleSettings |
Objet |
Obligatoire. Paire clé/valeur avec le bouton d'activation |
<string> |
Booléen |
Nouvel état d'activation/de désactivation |
Exemples
Activez le mode Économie d'énergie.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "energysaving_toggle": true } } }
Désactivez le filtre.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "filter_toggle": false } } }
Exemples d'énoncés
de-DE
- Bitte schalte Power Cool am Kühlschrank aus
- stelle den Kühlschrank auf Power Cool
en-US
- activate power freeze for the freezer
- cancel power cool for the kitchen fridge
es-ES
- pon el enfriamiento rápido en la nevera
- quita el enfriamiento rápido
fr-FR
- mets le mode power cool sur le réfrigérateur
- Éteins le mode power freeze du réfrigérateur .
hi-IN
- रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
- रेफ़्रिजरेटर में पावर कूल मोड चालू करो
it-IT
- disattiva il power freeze del freezer
- imposta la funzione power freeze del surgelatore
ja-JP
- 冷蔵庫 の 急速冷凍 つけて
- 冷蔵庫 の 急速冷凍 を切ってくれる
ko-KR
- 냉장고 급속 냉장 해제해
- 냉장고 모드 급속 냉장 으로 바꿔
nl-NL
- Zet de power cool uit op de koelkast
- zet de koelkast op superkoelen
pt-BR
- Ativa a função power freeze no congelador .
- Desativa o bloqueio infantil do forno .
- desligar o power cool da geladeira
- iniciar o modo power freeze do freezer
sv-SE
- Stäng av power cool i kylskåpet
- sätt på power freeze på frysen