Esquema del rasgo del canal de casa inteligente

action.devices.traits.Channel: Este rasgo pertenece a los dispositivos que admiten canales de TV en un dispositivo multimedia.

Los canales disponibles se deben compartir como una lista, por usuario o dispositivo, durante la SINCRONIZACIÓN a través del atributo availableChannels. Esta lista debe incluir todos los canales populares o principales a los que se suscribió el usuario o el dispositivo. Para garantizar una latencia de consulta baja, te recomendamos que mantengas la lista de canales pequeña (hasta 30 canales).

Atributos del dispositivo

Los dispositivos con este rasgo pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre cómo controlar intents de SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
availableChannels Matriz

Obligatorio.

Es una lista de objetos que describen los canales de medios disponibles para este dispositivo en particular. Cada elemento describe un canal que el usuario puede seleccionar en este dispositivo.
[item, ...] Objeto

Es el canal de medios disponible.
key String

Obligatorio.

Es el identificador único de este canal. No se expone a los usuarios.
names Matriz

Obligatorio.

Es la lista de nombres visibles para el usuario de este canal.
[item, ...] String

El nombre del canal
number String

Es un identificador numérico opcional para este canal.
commandOnlyChannels Booleano

(predeterminado: false)

Indica si el dispositivo admite la comunicación unidireccional (verdadero) o bidireccional (falso). Establece este atributo como verdadero si el dispositivo no puede responder a una intención de QUERY o Report State para este rasgo.

Ejemplos

Dispositivo que admite dos canales.

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

ESTADOS del dispositivo

Ninguno

COMANDOS del dispositivo

Los dispositivos con este rasgo pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre cómo controlar intents de EXECUTE, consulta Entrega de intents.

action.devices.commands.selectChannel

Establece el canal actual en un valor específico.

Parámetros

La carga útil contiene uno de los siguientes elementos:

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.

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

Cambia 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.

Es la cantidad 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

Regresa al canal anterior o al último en el que estuvo 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

ERRORES del dispositivo

Consulta la lista completa de errores y excepciones.