Esquema de trait de canal de la casa inteligente

action.devices.traits.Channel: Esta característica pertenece a 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 principales o populares a los que están suscritos el usuario o el dispositivo. Para garantizar una latencia de consulta baja, te recomendamos que mantengas una lista de canales pequeña (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 cómo controlar intents SYNC, consulta Cómo entregar intents.

Atributos Tipo Descripción
availableChannels Matriz

Obligatorio.

Es una lista de objetos que describen los canales 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.

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 un intent de CONSULTA o a un estado de informe de 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"
    }
  ]
}

ESTADOS DEL DISPOSITIVO

Ninguno

COMANDOS del dispositivo

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 controlar intents EXECUTE, consulta Cómo entregar 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:

Cómo seleccionar un 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

Es el nombre fácil de usar del canal solicitado.

channelNumber String

Es el identificador numérico del canal solicitado.

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

Pon el canal tres.

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

Se produjo un error al seleccionar un nuevo canal 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á o disminuirá.

Ejemplos

Cómo cambiar al canal siguiente

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

Cómo cambiar al canal anterior

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

Se produjo un error cuando se ajustaba el canal del dispositivo.

Valores admitidos:

channelSwitchFailed

action.devices.commands.returnChannel

Regresa al último canal o al anterior en el que estaba el usuario.

Parámetros

Parámetros Tipo Descripción

Sin propiedades

Ejemplos

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