Esquema de trait de volumen de la casa inteligente

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

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
volumeMaxLevel	Número entero	Obligatorio. El nivel de volumen máximo, suponiendo un valor de referencia de 0 (silencio). Asistente ajustará los comandos adverbiales (p.ej., "sube la TV un poco más alto") según corresponda.
volumeCanMuteAndUnmute	Booleano	Obligatorio. Indica si el dispositivo puede silenciar o activar el volumen. Silenciar es una opción diferente a "silenciar". lleva el volumen a 0 mientras se recuerda el volumen anterior, de modo que la activación del sonido lo restablece. 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 con una comunicación unidireccional (verdadero) o bidireccional (falso). Por ejemplo, si el controlador 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 ejecuta correctamente ni obtener el estado del dispositivo (por ejemplo, si el dispositivo es un control remoto infrarrojo tradicional), establece este campo en 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 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
currentVolume	Número entero	Obligatorio. El porcentaje de volumen actual. Debe estar entre >0 y volumeMaxLevel.
isMuted	Booleano	Obligatorio si el atributo volumeCanMuteAndUnmute se configura como verdadero. Es verdadero si el dispositivo está silenciado. false. Si isMuted es verdadero, el dispositivo aún muestra currentVolume para el punto recordado.

Ejemplos

Bocina que se puede silenciar y que informa el estado actual

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

Silencia o activa el sonido del dispositivo.

Parámetros

Parámetros	Tipo	Descripción
mute	Booleano	Obligatorio. Establece si se debe silenciar o activar el sonido de un dispositivo.

Ejemplos

Cómo silenciar la 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 de la bocina

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

action.devices.commands.volumeRelative

Configura el aumento o la baja del volumen n pasos, según volumeMaxLevel. En el caso de los comandos que usan una escala relativa, Asistente seleccionará n de forma adecuada para ajustar la escala a los pasos disponibles. Por ejemplo, Subir un poco el volumen de la TV establecerá una cantidad de pasos mayor que Subir un poco el volumen de la TV.

Parámetros

Parámetros	Tipo	Descripción
relativeSteps	Número entero	Obligatorio. negativo para "disminuir".

Ejemplos

Cómo establecer el volumen relativo de la bocina en el modo de solo comando

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

ERRORES DE DISPOSITIVO

Consulta la lista completa de errores y excepciones.

• volumeAlreadyMax: El dispositivo recibe el comando VolumeUp cuando es ya está en el volumen más alto.
• volumeAlreadyMin: El dispositivo recibe el comando VolumeDown cuando es ya está en el volumen más bajo.