Esquema de traço do canal de casa inteligente

action.devices.traits.Channel: esse traço 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 SINCRONIZAÇÃO pelo atributo availableChannels. Essa lista deve incluir todos os canais principais ou populares em que o usuário ou dispositivo está inscrito. Para garantir uma baixa latência de consulta, recomendamos que você mantenha 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 esse dispositivo específico. 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 do canal. Não exposto aos usuários.
names Array

Obrigatório.

Lista de nomes visíveis para o usuário deste canal.
[item, ...] String

Nome do canal.
number String

Identificador numérico opcional para este canal.
commandOnlyChannels Booleano

Padrão: false.

Indica se o dispositivo é compatível com comunicação unidirecional (true) ou bidirecional (false). Defina esse atributo como "true" se o dispositivo não puder responder a uma intent QUERY ou Report State para essa característica.

Exemplos

Dispositivo com suporte para dois canais.

{
  "availableChannels": [
    {
      "key": "ktvu2",
      "names": [
        "Fox",
        "KTVU"
      ],
      "number": "2"
    },
    {
      "key": "abc1",
      "names": [
        "ABC",
        "ABC East"
      ],
      "number": "4-11"
    }
  ]
}

ESTADOS DO DISPOSITIVO

Nenhum.

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

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 fácil de usar 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"
  }
}

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

Ocorreu um erro ao ajustar o canal do dispositivo.

Valores aceitos:

channelSwitchFailed

action.devices.commands.returnChannel

Volta ao último/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 voltar para o último canal do dispositivo.

Valores aceitos:

channelSwitchFailed

ERROS do dispositivo

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