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 : false) 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 : false) 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 name de l'appareil comme clé et l'état actuel comme valeur.
<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 name de l'appareil comme clé et le nouvel état comme valeur.
<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 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

Erreurs liées à l'appareil

Consultez la liste complète des erreurs et exceptions.