Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones para el hogar inteligente. Nota: Continuarás compilando acciones en la Consola de Actions.
Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Esquema de la característica de humedad del hogar inteligente

action.devices.traits.HumiditySetting: Esta característica pertenece a los dispositivos que admiten parámetros de configuración de humedad, como humidificadores y deshumidificadores.

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 manejar los intents SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
humiditySetpointRange Objeto

Contiene los niveles de humedad mínima y máxima en porcentajes.

minPercent Número entero

(Predeterminado: 0)

Representa el nivel de humedad mínima como un porcentaje.

maxPercent Número entero

(Predeterminado: 100)

Representa el nivel máximo de humedad como un porcentaje.

commandOnlyHumiditySetting 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 del informe para esta característica.

queryOnlyHumiditySetting Booleano

(Predeterminado: false)

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

Ejemplos

Dispositivo que admite el rango de humedad predeterminado

{}

Dispositivo que admite un rango de humedad personalizado.

{
  "humiditySetpointRange": {
    "minPercent": 25,
    "maxPercent": 75
  }
}

Dispositivo STATEs

Los dispositivos con esta característica pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo manejar los intents QUERY, consulta Entrega de intents.

Estados Tipo Descripción
humiditySetpointPercent Número entero

Indica el porcentaje actual de humedad objetivo del dispositivo. Debe ser de humiditySetpointRange.

humidityAmbientPercent Número entero

Indica la medición actual de humedad del ambiente del dispositivo en forma de porcentaje.

Ejemplos

¿Qué humedad muestra el dispositivo?

{
  "humiditySetpointPercent": 20,
  "humidityAmbientPercent": 15
}

Dispositivo COMMAND

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 manejar los intents EXECUTE, consulta Entrega de intents.

action.devices.commands.SetHumidity

Establece el nivel de humedad en un valor absoluto.

Parámetros

Parámetros Tipo Descripción
humidity Número entero

Obligatorio.

Porcentaje de humedad del punto de ajuste. Debe ser de humiditySetpointRange.

Ejemplos

Establece la humedad en 20%.

{
  "command": "action.devices.commands.SetHumidity",
  "params": {
    "humidity": 20
  }
}

Se produjo un error mientras se establecía la humedad objetivo.

Valores admitidos:

maxSettingReached
minSettingReached
valueOutOfRange

action.devices.commands.HumidityRelative

Ajusta el nivel de humedad en relación con el valor actual.

Este comando requiere los siguientes atributos:
{
  "commandOnlyHumiditySetting": true
}

Parámetros

La carga útil contiene una de las siguientes opciones:

Establecer porcentaje de humedad.

Parámetros Tipo Descripción
humidityRelativePercent Número entero

Obligatorio.

El valor de porcentaje para ajustar el nivel de humedad.

Establecer peso de humedad.

Parámetros Tipo Descripción
humidityRelativeWeight Número entero

Obligatorio.

Indica que la cantidad de humedad ambigua va de una cantidad pequeña (“un poco”) a una grande (“mucho”).

Ejemplos

Aumenta el nivel de humedad en un 10%

{
  "command": "action.devices.commands.HumidityRelative",
  "params": {
    "humidityRelativePercent": 10
  }
}

Disminuir mucho la humedad

{
  "command": "action.devices.commands.HumidityRelative",
  "params": {
    "humidityRelativeWeight": -5
  }
}

Se produjo un error al ajustar el nivel de humedad.

Valores admitidos:

maxSettingReached
minSettingReached
valueOutOfRange

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.