Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones de casa inteligente. Nota: Seguirás compilando acciones en la Consola de Actions.

Esquema de la función de volumen de la casa inteligente

action.devices.traits.Volume: Esta característica pertenece a los dispositivos que pueden cambiar el volumen (por ejemplo, configurar el volumen en un nivel determinado, silenciar o activar el sonido).

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
volumeMaxLevel Número entero

Obligatorio.

El nivel de volumen máximo, si se supone un valor de referencia igual a 0 (silenciado). En consecuencia, Asistente ajustará los comandos adverbiales (p.ej., "Haz que la TV suene más fuerte").

volumeCanMuteAndUnmute Booleano

Obligatorio.

Indica si el dispositivo puede silenciar y activar el volumen. Silenciar es una opción independiente, ya que el comportamiento de "silenciar" lleva el volumen a 0 mientras se recuerda el volumen anterior, de modo que el sonido se restablezca. Esto se refleja en el estado del volumen: si el volumen es 5 y el usuario se silencia, el volumen permanece en 5 y isMuted es verdadero.

volumeDefaultPercentage Número entero

(Predeterminado: 40)

El volumen (porcentaje) correspondiente al volumen predeterminado definido por el usuario o el fabricante. La escala debe ser de 0 a 100.

levelStepSize Número entero

(Predeterminado: 1)

El tamaño predeterminado del paso para consultas de volumen relativo, como “subir volumen en <device_name>”.

commandOnlyVolume Booleano

(Predeterminado: false)

Indica si el dispositivo funciona mediante una comunicación unidireccional (verdadero) o bidireccional (falso). Por ejemplo, si el control puede confirmar el nuevo estado del dispositivo después de enviar la solicitud, este campo sería falso. Si no es posible confirmar si la solicitud se ejecutó correctamente, o bien para obtener el estado del dispositivo (por ejemplo, si el dispositivo es un control remoto infrarrojo tradicional), configura este campo como verdadero.

Ejemplos

Bocina que se puede silenciar y que informa el estado actual

{
  "volumeMaxLevel": 11,
  "volumeCanMuteAndUnmute": true,
  "levelStepSize": 2,
  "commandOnlyVolume": false,
  "volumeDefaultPercentage": 6
}

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
currentVolume Número entero

Obligatorio.

El porcentaje de volumen actual Debe ser un valor entre >0 y volumeMaxLevel.

isMuted Booleano

Es obligatorio si el atributo volumeCanMuteAndUnmute se establece como verdadero. Verdadero si el dispositivo está silenciado; de lo contrario, es falso. Si isMuted es verdadero, el dispositivo seguirá mostrando currentVolume para el punto recordado.

Ejemplos

Bocina que se puede silenciar y que informa el estado actual

{
  "currentVolume": 5,
  "isMuted": 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.mute

Silencia o activa el sonido del dispositivo.

Parámetros

Parámetros Tipo Descripción
mute Booleano

Obligatorio.

Indica si se debe silenciar un dispositivo o activar el sonido del dispositivo.

Ejemplos

Silenciar bocina

{
  "command": "action.devices.commands.mute",
  "params": {
    "mute": true
  }
}

action.devices.commands.setVolume

Establece el volumen en el nivel solicitado, según volumeMaxLevel.

Parámetros

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

Obligatorio.

Nuevo volumen, de 0 a volumeMaxLevel.

Ejemplos

Establece el volumen absoluto del altavoz

{
  "command": "action.devices.commands.setVolume",
  "params": {
    "volumeLevel": 6
  }
}

action.devices.commands.volumeRelative

Sube o baja n pasos, según volumeMaxLevel. En el caso de los comandos que usan una escala relativa, Asistente seleccionará n de forma adecuada para escalar a los pasos disponibles. Por ejemplo, Aumentar el volumen de la TV un número de pasos mayor que Aumentar el volumen de la TV un poco más alto.

Parámetros

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

Obligatorio.

negativa para "reducir".

Ejemplos

Establece el volumen relativo de la bocina en modo de solo comando

{
  "command": "action.devices.commands.volumeRelative",
  "params": {
    "relativeSteps": -1
  }
}

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.
  • volumeAlreadyMax: El dispositivo recibe el comando VolumeUp cuando ya está en el volumen más alto.
  • volumeAlreadyMin: El dispositivo recibe el comando VolumeDown cuando ya está en el volumen más bajo.