Schéma de trait des boutons bascule pour 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 type d'élément spécifiquement activé/désactivé. 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 trait Modes, qui correspond à des sélecteurs à 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").

Ce trait couvre un ou plusieurs boutons individuels que les utilisateurs peuvent définir. En général, ces boutons doivent être utilisés pour les fonctionnalités qui ne sont pas liées au comportement d'autres appareils. Les comportements associés, comme l'activation ou la désactivation de l'appareil lui-même, doivent utiliser des traits plus spécifiques (par exemple, thermostatMode dans le trait TemperatureSetting).

ATTRIBUTS de l'appareil

Les appareils dotés de ce trait peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Fulfillment d'intent.

Exemples

Appareil avec plusieurs boutons bascule.

{
  "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 bascule en mode commande uniquement.

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

Appareil avec des boutons bascule en mode requête uniquement.

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

ÉTATS des appareils

Les entités dotées de ce trait peuvent signaler les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez Fulfillment d'intent.

Exemples

La stérilisation est-elle activée ?

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

COMMANDES de l'appareil

Les appareils dotés de ce trait 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 Fulfillment d'intent.

action.devices.commands.SetToggles

Définissez un état de bouton bascule 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 liées à l'appareil