Esquema de trait de canal de la casa inteligente
action.devices.traits.Channel
: Esta característica pertenece a dispositivos que admiten canales de TV en un dispositivo multimedia.
availableChannels
. Esta lista debe incluir todos los canales principales o populares a los que están suscritos el usuario o el dispositivo. Para garantizar una latencia de consulta baja, te recomendamos que mantengas una lista de canales pequeña (hasta 30 canales o menos).
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 controlar intents SYNC
, consulta Cómo entregar intents.
Atributos | Tipo | Descripción |
---|---|---|
availableChannels |
Matriz |
Obligatorio. Es una lista de objetos que describen los canales multimedia disponibles para este dispositivo en particular. Cada elemento describe un canal que el usuario puede seleccionar en este dispositivo. |
[item, ...] |
Objeto |
Canal de medios disponible. |
key |
String |
Obligatorio. Es el identificador único de este canal. No se expone a los usuarios. |
names |
Matriz |
Obligatorio. Es la lista de nombres visibles para el usuario de este canal. |
[item, ...] |
String |
El nombre del canal |
number |
String |
Es un identificador numérico opcional para este canal. |
commandOnlyChannels |
Booleano |
(Predeterminado: Indica si el dispositivo admite la comunicación unidireccional (verdadero) o bidireccional (falso). Establece este atributo como verdadero si el dispositivo no puede responder a un intent de CONSULTA o a un estado de informe de esta característica. |
Ejemplos
Dispositivo compatible con dos canales.
{ "availableChannels": [ { "key": "ktvu2", "names": [ "Fox", "KTVU" ], "number": "2" }, { "key": "abc1", "names": [ "ABC", "ABC East" ], "number": "4-11" } ] }
ESTADOS DEL DISPOSITIVO
Ninguno
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 intents EXECUTE
, consulta Cómo entregar intents.
action.devices.commands.selectChannel
Establece el canal actual en un valor específico.
Parámetros
La carga útil contiene una de las siguientes opciones:
Cómo seleccionar un canal por ID
Parámetros | Tipo | Descripción |
---|---|---|
channelCode |
String |
Obligatorio. Es el identificador único del canal solicitado que coincide con uno de los |
channelName |
String |
Es el nombre fácil de usar del canal solicitado. |
channelNumber |
String |
Es el identificador numérico del canal solicitado. |
Selecciona un canal por número
Parámetros | Tipo | Descripción |
---|---|---|
channelNumber |
String |
Obligatorio. Es el identificador numérico del canal solicitado. |
Ejemplos
Cambio a KTVU
{ "command": "action.devices.commands.selectChannel", "params": { "channelCode": "ktvu2", "channelName": "KTVU" } }
Pon el canal tres.
{ "command": "action.devices.commands.selectChannel", "params": { "channelNumber": "3" } }
Errores relacionados
Se produjo un error al seleccionar un nuevo canal en el dispositivo.
Valores admitidos:
noAvailableChannel
noChannelSubscription
channelSwitchFailed
action.devices.commands.relativeChannel
Ajusta el canal actual en una cantidad relativa.
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
relativeChannelChange |
Número entero |
Obligatorio. Es la cantidad de canales que se aumentará o disminuirá. |
Ejemplos
Cómo cambiar al canal siguiente
{ "command": "action.devices.commands.relativeChannel", "params": { "relativeChannelChange": 1 } }
Cómo cambiar al canal anterior
{ "command": "action.devices.commands.relativeChannel", "params": { "relativeChannelChange": -1 } }
Errores relacionados
Se produjo un error cuando se ajustaba el canal del dispositivo.
Valores admitidos:
channelSwitchFailed
action.devices.commands.returnChannel
Regresa al último canal o al anterior en el que estaba el usuario.
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
Sin propiedades |
Ejemplos
Regresar al último canal
{ "command": "action.devices.commands.returnChannel", "params": {} }
Errores relacionados
Se produjo un error al volver al último canal del dispositivo.
Valores admitidos:
channelSwitchFailed