Esquema de características do canal inteligente da casa
action.devices.traits.Channel
: essa característica pertence a dispositivos compatíveis com canais de TV em dispositivos de mídia.
availableChannels
. Ela precisa incluir todos os principais canais
em que o usuário ou o dispositivo está inscrito. Para garantir uma baixa latência de consulta, recomendamos manter
a lista de canais pequena (até 30 canais).
ATRIBUTOS DO DISPOSITIVO
Dispositivos com essa característica podem informar os seguintes
atributos como parte da operação SYNC
. Para saber
mais sobre como processar intents SYNC
, consulte
fulfillment de intent.
Atributos | Tipo | Descrição |
---|---|---|
availableChannels |
Array |
Obrigatório. Lista de objetos que descrevem os canais de mídia disponíveis para este dispositivo específico. Cada item descreve um canal que o usuário pode selecionar neste dispositivo. |
[item, ...] |
Object |
Canal de mídia disponível. |
key |
String |
Obrigatório. Identificador exclusivo desse canal. Não é exibida aos usuários. |
names |
Array |
Obrigatório. Lista de nomes visíveis ao usuário para este canal. |
[item, ...] |
String |
Nome do canal. |
number |
String |
Identificador numérico opcional deste canal. |
commandOnlyChannels |
Booleano |
Padrão: Indica se o dispositivo suporta o uso de comunicação unidirecional (verdadeiro) ou bidirecional (falso). Defina esse atributo como verdadeiro se o dispositivo não puder responder a uma intent QUERY ou a um estado de relatório para essa característica. |
Exemplos
Dispositivo com suporte a dois canais.
{ "availableChannels": [ { "key": "ktvu2", "names": [ "Fox", "KTVU" ], "number": "2" }, { "key": "abc1", "names": [ "ABC", "ABC East" ], "number": "4-11" } ] }
STATES do dispositivo
Nenhuma.
Comandos do dispositivo
Dispositivos com essa característica podem responder aos seguintes
comandos como parte da operação EXECUTE
. Para saber
mais sobre como processar intents EXECUTE
, consulte
fulfillment de intent.
action.devices.commands.selectChannel
Definir o canal atual para um valor específico.
Parâmetros
O payload contém um dos seguintes itens:
Selecionar canal por ID
Parâmetros | Tipo | Descrição |
---|---|---|
channelCode |
String |
Obrigatório. Identificador exclusivo para o canal solicitado, que corresponde a um dos |
channelName |
String |
Nome amigável do canal solicitado. |
channelNumber |
String |
Identificador numérico do canal solicitado. |
Selecionar canal por número
Parâmetros | Tipo | Descrição |
---|---|---|
channelNumber |
String |
Obrigatório. Identificador numérico do canal solicitado. |
Exemplos
Mudar para KTVU
{ "command": "action.devices.commands.selectChannel", "params": { "channelCode": "ktvu2", "channelName": "KTVU" } }
Volte para o canal três.
{ "command": "action.devices.commands.selectChannel", "params": { "channelNumber": "3" } }
Erros relacionados
Ocorreu um erro ao selecionar um novo canal no dispositivo.
Os valores suportados são:
noAvailableChannel
noChannelSubscription
channelSwitchFailed
action.devices.commands.relativeChannel
Ajusta o canal atual por um valor relativo.
Parâmetros
Parâmetros | Tipo | Descrição |
---|---|---|
relativeChannelChange |
Número inteiro |
Obrigatório. O número de canais a serem aumentados ou diminuídos. |
Exemplos
Mudar para o próximo canal
{ "command": "action.devices.commands.relativeChannel", "params": { "relativeChannelChange": 1 } }
Mudar para o canal anterior
{ "command": "action.devices.commands.relativeChannel", "params": { "relativeChannelChange": -1 } }
Erros relacionados
Ocorreu um erro ao ajustar o canal do dispositivo.
Os valores suportados são:
channelSwitchFailed
action.devices.commands.returnChannel
Voltar ao canal anterior/anterior do usuário.
Parâmetros
Parâmetros | Tipo | Descrição |
---|---|---|
Não há propriedades |
Exemplos
Voltar ao último canal
{ "command": "action.devices.commands.returnChannel", "params": {} }
Erros relacionados
Ocorreu um erro ao retornar ao último canal do dispositivo.
Os valores suportados são:
channelSwitchFailed