Esta é a Central do desenvolvedor do Google Home, a nova plataforma para aprender a desenvolver ações de casa inteligente. Observação: você continua criando ações no Console do Actions.
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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

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

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": {}
}

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.