Esquema de la característica de canal del hogar inteligente
action.devices.traits.Channel
: Esta característica pertenece a los dispositivos que admiten canales de TV en un dispositivo de medios.
availableChannels
. Esta lista debe incluir todos los canales principales o populares a los que se suscribió el usuario o dispositivo. Para garantizar una latencia baja de consulta, te recomendamos que mantengas una lista pequeña con un máximo de 30 canales.
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 |
---|---|---|
availableChannels |
Matriz |
Obligatorio. Lista de objetos que describen los canales de contenido 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. Identificador único de este canal. No está expuesto a los usuarios. |
names |
Matriz |
Obligatorio. Lista de nombres visibles para el usuario de este canal. |
[item, ...] |
String |
El nombre del canal |
number |
String |
Identificador numérico opcional para este canal. |
commandOnlyChannels |
Booleano |
(Predeterminado: Indica si el dispositivo admite el uso de comunicación unidireccional (verdadero) o bidireccional (falso). Establece este atributo como verdadero si el dispositivo no puede responder a un intent QUERY o al estado del informe para esta característica. |
Ejemplos
Dispositivo que admite dos canales.
{ "availableChannels": [ { "key": "ktvu2", "names": [ "Fox", "KTVU" ], "number": "2" }, { "key": "abc1", "names": [ "ABC", "ABC East" ], "number": "4-11" } ] }
Dispositivo STATEs
Ninguna
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.selectChannel
Establece el canal actual en un valor específico.
Parámetros
La carga útil contiene una de las siguientes opciones:
Seleccionar 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 |
Nombre fácil de usar del canal solicitado. |
channelNumber |
String |
Es el identificador numérico del canal solicitado. |
Seleccionar 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" } }
Vuelve al canal tres.
{ "command": "action.devices.commands.selectChannel", "params": { "channelNumber": "3" } }
Errores relacionados
Se produjo un error al seleccionar un canal nuevo 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. Número de canales que se aumentarán o disminuirán. |
Ejemplos
Cambiar al siguiente canal
{ "command": "action.devices.commands.relativeChannel", "params": { "relativeChannelChange": 1 } }
Cambiar al canal anterior
{ "command": "action.devices.commands.relativeChannel", "params": { "relativeChannelChange": -1 } }
Errores relacionados
Se produjo un error al ajustar el canal del dispositivo.
Valores admitidos:
channelSwitchFailed
action.devices.commands.returnChannel
Regresar al último canal o al anterior al que estaba el usuario
Parámetros
Parámetros | Tipo | Descripción |
---|---|---|
Sin propiedades |
Ejemplos
Volver 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