Schéma de trait de boutons d'activation/de désactivation de la maison connectée

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.

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 élément activé/désactivé spécifiquement. Si le paramètre comporte plus de deux états ou un état dans lequel aucune des options binaires n'est sélectionnée, il est préférable de le représenter sous la forme d'un attribut Modes, qui équivaut à des boutons rotatifs à plusieurs états, des boutons radio (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 couvre un ou plusieurs boutons d'activation/de désactivation que les utilisateurs peuvent définir. En règle générale, ces boutons d'activation/de désactivation doivent être utilisés pour les fonctionnalités qui ne sont pas associées au comportement d'autres appareils. Le comportement associé, comme l'activation ou la désactivation de l'appareil lui-même, doit utiliser des traits plus spécifiques (par exemple, thermostatMode dans le trait TemperatureSetting).

ATTRIBUTS de l'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.

Exemples

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

{
  "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 uniquement par commande.

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

Appareil avec des boutons d'activation/de désactivation pour les requêtes uniquement.

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

ÉTATS DE L'APPAREIL

Les entités avec 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.

Exemples

La stérilisation est-elle activée ?

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

COMMANDES DE L'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éfinissez un état d'activation/de désactivation donné.

Paramètres

Exemples

Activez l'économiseur 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

ERREURS de l'appareil