La maison connectée active/désactive le schéma de trame

action.devices.traits.Toggles : cette caractéristique appartient à tous les appareils dont les paramètres ne peuvent exister que dans l'un des deux états suivants.

Ces paramètres peuvent représenter un bouton physique avec un bouton marche/arrêt ou actif/inactif une case à cocher en HTML ou toute autre forme d'activation ou de désactivation spécifique . Si le paramètre est associé à plus de deux états ou à un état aucune des options binaires n'est sélectionnée, il est préférable de le représenter La caractéristique Modes, qui équivaut à des cadrans multi-états, cases d'option (physique ou HTML), ou états binaires qui ne sont pas explicitement (par exemple, "AM/FM" ou "chaud/froid").

Cette caractéristique couvre un ou plusieurs boutons d'activation/de désactivation individuels que les utilisateurs peuvent définir. Dans général, ces boutons d'activation/de désactivation doivent être utilisés pour les fonctionnalités dissociées des autres comportements de l'appareil. Comportement associé, comme tourner l'appareil lui-même doivent utiliser des caractéristiques plus spécifiques (par exemple, le thermostatMode dans le caractère TemperatureSetting).

ATTRIBUTS D'appareils

Les appareils présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération SYNC. Pour apprendre Pour en savoir plus sur la gestion des intents SYNC, consultez Traitement des intents.

Attributs Type Description
availableToggles Array

Obligatoire.

Liste des boutons d'activation/de désactivation disponibles.
[item, ...] Objet

Bouton d'activation disponible.
name String

Obligatoire.

Nom interne de l'option d'activation/de désactivation, qui sera utilisé dans les commandes et les états. Cette approche peut ne pas être conviviale et sera utilisé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, ...] String

Synonyme du nom.
lang String

Obligatoire.

Code de langue (ISO 639-1). Consultez la liste des langues acceptées.
commandOnlyToggles Valeur booléenne

(Par défaut : false)

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 ou à l'état du rapport pour cette caractéristique.
queryOnlyToggles Valeur booléenne

(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 s'il ne peut pas être contrôlé.

Exemples

Appareil avec boutons d'activation/de désactivation multiples.

{
  "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 des boutons d'activation/de désactivation de type commande uniquement.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "commandOnlyToggles": true
}

Appareil avec boutons d'activation pour les requêtes uniquement.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "queryOnlyToggles": true
}

STATES de l'appareil

Les entités présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération QUERY. Pour apprendre Pour en savoir plus sur la gestion des intents QUERY, consultez Traitement des intents.

États Type Description
currentToggleSettings Objet

Obligatoire.

Paire clé/valeur avec le bouton d'activation name de l'appareil en tant que clé et l'état actuel comme valeur.
<string> Valeur booléenne

État d'activation/de désactivation actuel.

Exemples

La stérilisation est-elle activée ?

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

COMMANDS d'appareils

Les appareils présentant cette caractéristique peuvent répondre aux éléments suivants : dans le cadre de l'opération EXECUTE. Pour apprendre Pour en savoir plus sur la gestion des intents EXECUTE, consultez 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 en tant que clé et le nouvel état comme valeur.
<string> Valeur booléenne

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

<ph type="x-smartling-placeholder">

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 d'appareil

Voir la liste complète les erreurs et les exceptions.