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 |
volumeDefaultPercentage |
Número entero |
(Predeterminado: 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: Es el tamaño predeterminado del paso para consultas de volumen relativo, como "subir volumen en <device_name>". |
commandOnlyVolume |
Booleano |
(Predeterminado: 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 |
isMuted |
Booleano |
Es obligatorio si se configura el atributo |
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 |
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 comandoVolumeUp
cuando ya está en el volumen más alto.volumeAlreadyMin
: El dispositivo recibe el comandoVolumeDown
cuando ya está en el volumen más bajo.