Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones para el hogar inteligente. Nota: Continuarás compilando acciones en la Consola de Actions.
Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Esquema de la característica de canal del hogar inteligente

action.devices.traits.Channel: Esta característica pertenece a los dispositivos que admiten canales de TV en un dispositivo de medios.

Los canales disponibles deben compartirse como una lista, por usuario o dispositivo, durante la SINCRONIZACIÓN mediante el atributo availableChannels. Esta lista debe incluir todos los canales principales o populares a los que se suscribió el usuario o dispositivo. Para garantizar una latencia baja de consulta, te recomendamos que mantengas una lista pequeña con un máximo de 30 canales.

ATRIBUTOS DEL Dispositivo

Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre cómo manejar los intents SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
availableChannels Matriz

Obligatorio.

Lista de objetos que describen los canales de contenido multimedia disponibles para este dispositivo en particular. Cada elemento describe un canal que el usuario puede seleccionar en este dispositivo.

[item, ...] Objeto

Canal de medios disponible.

key String

Obligatorio.

Identificador único de este canal. No está expuesto a los usuarios.

names Matriz

Obligatorio.

Lista de nombres visibles para el usuario de este canal.

[item, ...] String

El nombre del canal

number String

Identificador numérico opcional para este canal.

commandOnlyChannels Booleano

(Predeterminado: false)

Indica si el dispositivo admite el uso de comunicación unidireccional (verdadero) o bidireccional (falso). Establece este atributo como verdadero si el dispositivo no puede responder a un intent QUERY o al estado del informe para esta característica.

Ejemplos

Dispositivo que admite dos canales.

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

Dispositivo STATEs

Ninguno

Dispositivo COMMAND

Los dispositivos con esta característica pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre cómo manejar los intents EXECUTE, consulta Entrega de intents.

action.devices.commands.selectChannel

Establece el canal actual en un valor específico.

Parámetros

La carga útil contiene una de las siguientes opciones:

Seleccionar canal por ID

Parámetros Tipo Descripción
channelCode String

Obligatorio.

Es el identificador único del canal solicitado, que coincide con uno de los availableChannels.

channelName String

Nombre fácil de usar del canal solicitado.

channelNumber String

Es el identificador numérico del canal solicitado.

Seleccionar canal por número

Parámetros Tipo Descripción
channelNumber String

Obligatorio.

Es el identificador numérico del canal solicitado.

Ejemplos

Cambio a KTVU

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

Vuelve al canal tres.

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

Se produjo un error al seleccionar un canal nuevo en el dispositivo.

Valores admitidos:

noAvailableChannel
noChannelSubscription
channelSwitchFailed

action.devices.commands.relativeChannel

Ajusta el canal actual en una cantidad relativa.

Parámetros

Parámetros Tipo Descripción
relativeChannelChange Número entero

Obligatorio.

Número de canales que se aumentarán o disminuirán.

Ejemplos

Cambiar al siguiente canal

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": 1
  }
}

Cambiar al canal anterior

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": -1
  }
}

Se produjo un error al ajustar el canal del dispositivo.

Valores admitidos:

channelSwitchFailed

action.devices.commands.returnChannel

Regresar al último canal o al anterior al que estaba el usuario

Parámetros

Parámetros Tipo Descripción

Sin propiedades

Ejemplos

Volver al último canal

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

Se produjo un error al volver al último canal del dispositivo.

Valores admitidos:

channelSwitchFailed

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.