Esquema de características do canal de casa inteligente

action.devices.traits.Channel: esta característica pertence a dispositivos compatíveis com 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 abranger todos os canais principais ou mais 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

Os dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre como lidar com 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 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 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 compatível com dois canais.

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

STATES do dispositivo

Nenhuma.

Dispositivo COMMANDS

Os dispositivos com essa característica podem responder aos comandos a seguir como parte da operação EXECUTE. Para saber mais sobre como lidar com intents EXECUTE, consulte fulfillment de intent.

action.devices.commands.selectChannel

Define 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 do 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 a KTVU

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelCode": "ktvu2",
    "channelName": "KTVU"
  }
}

Volte ao terceiro canal.

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

Ocorreu um erro ao selecionar um novo canal no dispositivo.

Os valores suportados são:

noAvailableChannel
noChannelSubscription
channelSwitchFailed

action.devices.commands.relativeChannel

Ajuste o canal atual com um valor relativo.

Parâmetros

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

Obrigatório.

O número de canais para aumentar ou diminuir.

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.

Os valores suportados são:

channelSwitchFailed

action.devices.commands.returnChannel

Retorne ao último canal/canal anterior em que o usuário estava.

Parâmetros

Parâmetros Tipo Descrição

Não há propriedades

Exemplos

Voltar ao último canal

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

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.