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.

Os canais disponíveis precisam ser compartilhados como uma lista por usuário ou dispositivo durante a sincronização usando o atributo 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: false. 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 availableChannels.
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

Dispositivo ERRORS

Veja a lista completa de erros e exceções.