Esquema del rasgo de activación de casa inteligente

action.devices.traits.Toggles: Este rasgo pertenece a cualquier dispositivo con parámetros de configuración que solo pueden existir en uno de dos estados.

Estos parámetros de configuración pueden representar un botón físico con un estado de encendido/apagado o activo/inactivo, una casilla de verificación en HTML o cualquier otro tipo de elemento específicamente habilitado o inhabilitado. Si el parámetro de configuración tiene más de dos estados o tiene un estado en el que no se selecciona ninguna de las opciones binarias, se representa mejor como un rasgo Modes, que equivale a diales de varios estados, botones de radio (físicos o HTML) o estados binarios que no son explícitamente de encendido/apagado (por ejemplo, "AM/FM" o "caliente/frío").

Este rasgo abarca uno o más botones de activación individuales que los usuarios pueden configurar. En general, estos botones de activación se deben usar para la funcionalidad que no está vinculada a otro comportamiento del dispositivo. El comportamiento vinculado, como encender o apagar el dispositivo, debe usar rasgos más específicos (por ejemplo, thermostatMode en el rasgo TemperatureSetting).

Atributos del dispositivo

Los dispositivos con este rasgo pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre cómo controlar intents de SYNC, consulta Entrega de intents.

Ejemplos

Dispositivo con varios botones de activación.

{
  "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"
        }
      ]
    }
  ]
}

Dispositivo con interruptores solo de comando.

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

Dispositivo con botones de activación solo para consultas.

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

ESTADOS del dispositivo

Las entidades con este rasgo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar intents de QUERY, consulta Entrega de intents.

Ejemplos

¿Está activada la esterilización?

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

COMANDOS del dispositivo

Los dispositivos con este rasgo pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre cómo controlar intents de EXECUTE, consulta Entrega de intents.

action.devices.commands.SetToggles

Establece un estado de activación determinado.

Parámetros

Ejemplos

Activa el ahorro de energía.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

Desactiva el filtro.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

Expresiones de muestra

ERRORES del dispositivo