Esquema de rasgo del volumen de las casas inteligentes

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

Dispositivo ATTRIBUTES

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 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., "Subir el volumen de la TV") según corresponda.

volumeCanMuteAndUnmute Booleano

Obligatorio.

Indica si el dispositivo puede silenciar y activar el sonido. Esta función también es independiente, ya que el comportamiento de "silencio" lleva el volumen a 0 y recuerda el volumen anterior, de modo que activar el sonido lo restablece. Esto se refleja en el estado del volumen: si el volumen es 5 y el usuario silencia, el volumen permanece en 5 y isMuted se mantiene verdadero.

volumeDefaultPercentage Número entero

(Predeterminado: 40)

Es 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)

Es 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 utilizando 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á falso. Si no es posible confirmar si la solicitud se ejecutó correctamente ni obtener el estado del dispositivo (por ejemplo, si el dispositivo es un control remoto infrarrojo tradicional), establece este campo en true.

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 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

Es obligatorio si se configura el atributo volumeCanMuteAndUnmute como verdadero. Es verdadero si el dispositivo está silenciado. De lo contrario, es falso. 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 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 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.

Si deseas silenciar un dispositivo o activar su sonido.

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

Cómo configurar el volumen absoluto de la bocina

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

action.devices.commands.volumeRelative

Establecer el volumen para subir o bajar 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 ajustar la escala a los pasos disponibles. Por ejemplo, Subir el volumen de la TV establecerá una cantidad de pasos mayor que Subir el volumen un poco más alto.

Parámetros

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

Obligatorio.

negativo por “disminución”.

Ejemplos

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

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

ERRORS de dispositivos

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.