Esquema de característica del canal de la casa 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 se deben compartir 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 la consulta, te recomendamos que mantengas una lista pequeña de canales (hasta 30 canales o menos).

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 el manejo de intents SYNC, consulta Entrega de intents.

Atributos Tipo Descripción
availableChannels Matriz

Obligatorio.

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

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 de informe para esta característica.

Ejemplos

Dispositivo compatible con dos canales.

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

Dispositivo STATEs

Ninguno

Dispositivo COMMANDS

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 el manejo de intents EXECUTE, consulta Entrega de intents.

action.devices.commands.selectChannel

Establecer 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 availableChannels.

channelName String

Es el 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

Cambiar a KTVU

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

Ve 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 según una cantidad relativa.

Parámetros

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

Obligatorio.

Es la cantidad de canales para aumentar o disminuir.

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 canal anterior en el 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.