Schéma des caractéristiques de la maison connectée
action.devices.traits.Toggles
: cette caractéristique appartient à tous les appareils dont les paramètres ne peuvent être présents 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 dans HTML ou tout autre type d'élément spécifiquement activé/désactivé. Si le paramètre comporte plus de deux états, ou si l'un des états n'est sélectionné dans aucune des options binaires, il est préférable de le représenter sous la forme d'une caractéristique Modes, qui correspond à des cadrans multi-états, des cases d'option (physiques 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 comprend un ou plusieurs boutons d'activation que les utilisateurs peuvent définir. En règle générale, ces boutons doivent être utilisés pour les fonctionnalités dissociées du comportement d'autres appareils. Les comportements associés, comme l'activation ou la désactivation de l'appareil, doivent utiliser des caractéristiques plus spécifiques (par exemple, thermostatMode
dans la caractéristique TempératureSetting).
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 |
---|---|---|
availableToggles |
Array |
Obligatoire. Liste des boutons d'activation disponibles. |
[item, ...] |
Objet |
Bouton d'activation disponible. |
name |
Chaîne |
Obligatoire. Nom interne du bouton d'activation, 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 bouton d'activation dans chaque langue compatible. |
[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, ...] |
Chaîne |
Nom du synonyme. |
lang |
Chaîne |
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 (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. |
queryOnlyToggles |
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 à 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 commandes disponibles uniquement
{ "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 }
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 |
---|---|---|
currentToggleSettings |
Objet |
Obligatoire. Paire clé/valeur avec le bouton d'activation |
<string> |
Booléen |
État actuel du bouton d'activation |
Exemples
La stérilisation est-elle activée ?
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
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.SetToggles
Définir un état d'activation/de désactivation 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 les économies d'énergie.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "energysaving_toggle": true } } }
Désactiver 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 aufPower Cool
en-US
-
activate
power freeze forthe freezer -
cancel
power cool forthe kitchen fridge
es-ES
-
pon el
enfriamiento rápido enla nevera -
quita el
enfriamiento rápido
fr-FR
-
mets le mode
power cool surle réfrigérateur -
Éteins le mode
power freeze duré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 opde koelkast -
zet
de koelkast opsuperkoelen
pt-BR
-
Ativa a função
power freeze nocongelador . -
Desativa o
bloqueio infantil doforno . -
desligar o
power cool dageladeira -
iniciar o modo
power freeze dofreezer
sv-SE
-
Stäng av
power cool ikylskåpet -
sätt på
power freeze påfrysen