Esquema de rasgo para activar o desactivar la característica de casa inteligente

action.devices.traits.Toggles: Esta característica pertenece a todos los dispositivos 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 botón activado/desactivado o activo/inactivo. estado, una casilla de verificación en HTML o cualquier otro tipo de habilitado/inhabilitado específicamente . Si la configuración tiene más de dos estados o uno en el que no se selecciona ninguna de las opciones binarias, se representa mejor como rasgo Modes, que equivale a diales de varios estados botones de selección (físicos o HTML), o estados binarios que no estén explícitamente activada/desactivada (por ejemplo, "AM/FM" o "caliente/frío").

Esta característica abarca uno o más botones de activación individuales que los usuarios pueden configurar. En En general, estos botones de activación deben usarse para la funcionalidad que no está vinculada. de otro comportamiento del dispositivo. Comportamiento vinculado, como girar el dispositivo activada o desactivada, debes usar características más específicas (por ejemplo, thermostatMode en el trait TemperatureSetting).

ATRIBUTOS DISPOSITIVOS

Los dispositivos con este trait pueden informar lo siguiente atributos como parte de la operación SYNC. Para aprender Para obtener más información sobre cómo controlar los 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. Esta opción no es fácil de usar y se compartirá en todos los idiomas.
name_values Matriz

Obligatorio.

Sinónimos del botón de activación en cada idioma compatible.
[item, ...] Objeto

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 cadena de esta lista se usa como 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 de CONSULTA o a un informe de estado de esta característica.
queryOnlyToggles Booleano

(Predeterminado: false)

Obligatorio si el dispositivo admite la ejecución de solo consulta. Este atributo indica si solo se puede consultar al dispositivo para obtener información de estado y no se puede controlar.

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 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 lo siguiente estados como parte de la operación QUERY. Para aprender Para obtener más información sobre cómo controlar los intents QUERY, consulta Entrega de intents.

Estados Tipo Descripción
currentToggleSettings Objeto

Obligatorio.

Par clave-valor con el botón de activación name del dispositivo como clave y el estado actual como valor.
<string> Booleano

Estado actual del botón de activación.

Ejemplos

¿Está activada la esterilización?

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

COMANDOS del dispositivo

Los dispositivos con este rasgo pueden responder a lo siguiente comandos como parte de la operación EXECUTE. Para aprender Para obtener más información sobre cómo controlar los 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.

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

ERRORES DE DISPOSITIVO

Consulta la lista completa de errores y excepciones.