Esquema de botones de activación de la opción Inicio inteligente

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

Esta configuración puede representar un botón físico con un estado de activación, desactivación o activación, una casilla de verificación en HTML o cualquier otro tipo de elemento habilitado o inhabilitado específicamente. Si la configuración tiene más de dos estados, o un estado en el que ninguna de las opciones binarias está seleccionada, se representa mejor como una característica de Modes, que equivale a diales de varios estados, botones de selección (físicos o HTML) o estados binarios que no están activados/desactivados de forma explícita (por ejemplo, "AM/FM" o "hot/cold").

Esta característica 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 funciones que están desvinculadas del comportamiento de otros dispositivos. El comportamiento vinculado, como encender o apagar el dispositivo, debe usar rasgos más específicos (por ejemplo, el thermostatMode en la configuración de temperatura de la característica).

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 el manejo de intents SYNC, consulta Entrega de intents.

Atributos	Tipo	Descripción
availableToggles	Matriz	Obligatorio. Lista de botones de activación disponibles.
[item, ...]	Objeto	Botón de activación disponible.
name	String	Obligatorio. Nombre interno del botón de activación, que se usará en comandos y estados. Esto puede ser poco fácil de usar y se compartirá en todos los idiomas.
name_values	Matriz	Obligatorio. Son sinónimos del botón de activación en cada idioma compatible.
[item, ...]	Objeto	Son sinónimos del botón de activación en un idioma determinado.
name_synonym	Matriz	Obligatorio. Sinónimos del botón de activación. La primera string de esta lista se usa como el nombre canónico del nivel en ese idioma.
[item, ...]	String	Nombre del sinónimo.
lang	String	Obligatorio. Código de idioma (ISO 639-1). Consulta los idiomas compatibles.
commandOnlyToggles	Booleano	(Predeterminado: false) Indica si el dispositivo admite el uso de comunicación unidireccional (verdadero) o bidireccional (falso). Establece este atributo como verdadero si el dispositivo no puede responder a un intent QUERY o al estado de informe para esta característica.
queryOnlyToggles	Booleano	(Predeterminado: false) Obligatorio si el dispositivo admite la ejecución de solo consulta. Este atributo indica si el dispositivo solo se puede consultar para obtener información de estado y no se puede controlar.

Ejemplos

Dispositivo con botón de activación múltiple.

{
  "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 de solo comando.

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

Dispositivo con botones de activación de solo consulta.

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

Dispositivo STATEs

Las entidades con esta característica pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre el manejo de intents QUERY, consulta Entrega de intents.

Estados	Tipo	Descripción
currentToggleSettings	Objeto	Obligatorio. Es el par clave-valor con el botón de activación name del dispositivo como clave y el estado actual como valor.
<string>	Booleano	Estado del botón de activación actual.

Ejemplos

¿La esterilización está activada?

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

Dispositivo COMMANDS

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 el manejo de intents EXECUTE, consulta Entrega de intents.

action.devices.commands.SetToggles

Establece un estado de activación determinado.

Parámetros

Parámetros	Tipo	Descripción
updateToggleSettings	Objeto	Obligatorio. Es el par clave-valor con el botón de activación name del dispositivo como clave y el estado nuevo como valor.
<string>	Booleano	Nuevo estado de activación

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

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

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.