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, establecer el volumen en un determinado nivel, 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 cómo manejar los intents SYNC, consulta Entrega de intents.

Atributos	Tipo	Descripción
volumeMaxLevel	Número entero	Obligatorio. El nivel de volumen máximo, si suponemos que el valor de referencia es 0 (silenciar). Asistente ajustará los comandos adverbiales (p.ej., "Aumentar el volumen de la TV") en función de eso.
volumeCanMuteAndUnmute	Booleano	Obligatorio. Indica si el dispositivo puede silenciar o activar el volumen. Silenciar es una opción independiente, ya que el comportamiento de "silenciar" lleva el volumen a 0 y, a su vez, recuerda el volumen anterior para que se active el sonido. 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 (en porcentaje) del 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 del paso predeterminado para consultas de volumen relativo, como “subir volumen en <device_name>”.
commandOnlyVolume	Booleano	(Predeterminado: false) Indica si el dispositivo funciona mediante 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ó de forma correcta o para obtener el estado del dispositivo (por ejemplo, si el dispositivo es un control remoto infrarrojo tradicional), establece 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 cómo manejar los intents QUERY, consulta Entrega de intents.

Estados	Tipo	Descripción
currentVolume	Número entero	Obligatorio. El porcentaje de volumen actual. Debe estar entre >0 y volumeMaxLevel.
isMuted	Booleano	Obligatorio si se establece el atributo volumeCanMuteAndUnmute como verdadero. Verdadero si el dispositivo está silenciado; false; de lo contrario, 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 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.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

Configura el volumen en el nivel solicitado, en función de volumeMaxLevel.

Parámetros

Parámetros	Tipo	Descripción
volumeLevel	Número entero	Obligatorio. Volumen nuevo, de 0 a volumeMaxLevel.

Ejemplos

Establecer el volumen absoluto del altavoz

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

action.devices.commands.volumeRelative

Sube o baja el volumen n pasos, según volumeMaxLevel. En el caso de los comandos que usan una escala relativa, el Asistente seleccionará n de forma correcta para escalar a los pasos disponibles. Por ejemplo, Aumentar el volumen de la TV para un volumen más alto de pasos 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 "disminuir"

Ejemplos

Establece el volumen relativo de la bocina en el 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.