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

Ninguna

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

Errores relacionados

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

Errores relacionados

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

Errores relacionados

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

Valores admitidos:

channelSwitchFailed

Dispositivo ERRORS

Consulta la lista completa de errores y excepciones.