Esquema de atributo do canal da casa inteligente

action.devices.traits.Channel: essa característica pertence a dispositivos que oferecem suporte a canais de TV em um dispositivo de mídia.

Os canais disponíveis precisam ser compartilhados como uma lista, por usuário ou dispositivo, durante a SYNC pelo atributo availableChannels. Essa lista deve incluir todos os canais mais acessados ou populares em que o usuário ou 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 intents.

Atributos Tipo Descrição
availableChannels Array

Obrigatório.

Lista de objetos que descrevem os canais de mídia disponíveis para esse dispositivo em particular. Cada item descreve um canal que o usuário pode selecionar no dispositivo.
[item, ...] Object

Canal de mídia disponível.
key String

Obrigatório.

Identificador exclusivo para este canal. Não exposto aos usuários.
names Array

Obrigatório.

Lista de nomes visíveis para o 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 oferece suporte a comunicação unidirecional (verdadeiro) ou bidirecional (falso). Defina esse atributo como verdadeiro se o dispositivo não puder responder a uma intent de QUERY ou ao estado de relatório dessa 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

Nenhum.

COMANDOS do dispositivo

Dispositivos com essa característica podem responder aos comandos abaixo como parte da operação EXECUTE. Para saber mais sobre o processamento de intents EXECUTE, consulte Fulfillment de intents.

action.devices.commands.selectChannel

Define o canal atual como um valor específico.

Parâmetros

O payload contém uma das seguintes opções:

Selecionar canal por ID

Parâmetros Tipo Descrição
channelCode String

Obrigatório.

Identificador exclusivo do canal solicitado, correspondente a um dos availableChannels.
channelName String

Nome simples 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"
  }
}

Mudar para o canal três.

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelNumber": "3"
  }
}

Ocorreu um erro ao selecionar um novo canal no dispositivo.

Valores aceitos:

noAvailableChannel
noChannelSubscription
channelSwitchFailed

action.devices.commands.relativeChannel

Ajusta o canal atual em uma quantidade relativa.

Parâmetros

Parâmetros Tipo Descrição
relativeChannelChange Número inteiro

Obrigatório.

O número de canais a ser aumentado ou diminuído.

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
  }
}

Ocorreu um erro ao ajustar o canal do dispositivo.

Valores aceitos:

channelSwitchFailed

action.devices.commands.returnChannel

Volta ao último canal ou ao canal anterior em que o usuário estava.

Parâmetros

Parâmetros Tipo Descrição

Não há propriedades

Exemplos

Voltar para o último canal

{
  "command": "action.devices.commands.returnChannel",
  "params": {}
}

Ocorreu um erro ao retornar ao último canal do dispositivo.

Valores aceitos:

channelSwitchFailed

ERROS no dispositivo

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