Esquema de atributos de interruptores de casa inteligente

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

Esta configuración puede representar un botón físico con un estado activado o desactivado, una casilla de verificación en HTML o cualquier otro tipo de elemento habilitado o inhabilitado de forma específica. 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 atributo Modes, que equivale a diales de varios estados, botones de selección (físicos o HTML) o estados binarios que no están activados o desactivados de forma explícita (por ejemplo, “AM/FM” o “caliente/frío”).

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

ATRIBUTOS del dispositivo

Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre cómo controlar intents SYNC, consulta Cómo entregar 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 botones de activación solo de comandos.

{
  "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 atributo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar intents QUERY, consulta Cómo entregar intents.

Ejemplos

¿Está activada la esterilización?

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

COMANDOS del dispositivo

Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre cómo controlar intents EXECUTE, consulta Cómo entregar 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