Schema delle caratteristiche del canale per la smart home

action.devices.traits.Channel: questo attributo appartiene ai dispositivi che supportano i canali TV su un media player.

I canali disponibili devono essere condivisi come elenco, per utente o dispositivo, durante la sincronizzazione tramite l'attributo availableChannels. L'elenco deve includere tutti i canali più popolari o più apprezzati a cui l'utente o il dispositivo è iscritto. Per garantire una latenza delle query ridotta, ti consigliamo di mantenere l'elenco dei canali ridotto (fino a 30 canali).

ATTRIBUTI del dispositivo

I dispositivi con questo tratto potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Adempimento degli intent.

Attributi Tipo Descrizione
availableChannels Array

Obbligatorio.

Elenco di oggetti che descrivono i canali multimediali disponibili per questo particolare dispositivo. Ogni elemento descrive un canale che l'utente può selezionare su questo dispositivo.
[item, ...] Oggetto

Canale multimediale disponibile.
key String

Obbligatorio.

Identificatore univoco di questo canale. Non esposti agli utenti.
names Array

Obbligatorio.

Elenco di nomi visibili all'utente per questo canale.
[item, ...] String

Nome del canale.
number String

Identificatore numerico facoltativo per questo canale.
commandOnlyChannels Valore booleano

(Valore predefinito: false)

Indica se il dispositivo supporta l'utilizzo della comunicazione unidirezionale (true) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intento QUERY o a uno stato Report per questa caratteristica.

Esempi

Dispositivo che supporta due canali.

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

STATI del dispositivo

Nessuno.

COMANDI del dispositivo

I dispositivi con questa caratteristica possono rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta Adempimento degli intent.

action.devices.commands.selectChannel

Imposta il canale corrente su un valore specifico.

Parametri

Il payload contiene uno dei seguenti elementi:

Selezionare il canale tramite ID

Parametri Tipo Descrizione
channelCode String

Obbligatorio.

Identificatore univoco per il canale richiesto, corrispondente a uno dei availableChannels.
channelName String

Nome semplice del canale richiesto.
channelNumber String

Identificatore numerico del canale richiesto.

Seleziona il canale per numero

Parametri Tipo Descrizione
channelNumber String

Obbligatorio.

Identificatore numerico del canale richiesto.

Esempi

Passaggio a KTVU

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

Passa al canale tre.

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

Si è verificato un errore durante la selezione di un nuovo canale sul dispositivo.

Valori supportati:

noAvailableChannel
noChannelSubscription
channelSwitchFailed

action.devices.commands.relativeChannel

Regola il canale corrente di un valore relativo.

Parametri

Parametri Tipo Descrizione
relativeChannelChange Intero

Obbligatorio.

Il numero di canali da aumentare o diminuire.

Esempi

Passare al canale successivo

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

Passare al canale precedente

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

Si è verificato un errore durante la regolazione del canale del dispositivo.

Valori supportati:

channelSwitchFailed

action.devices.commands.returnChannel

Torna all'ultimo canale/precedente su cui si trovava l'utente.

Parametri

Parametri Tipo Descrizione

Nessuna proprietà

Esempi

Torna all'ultimo canale

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

Si è verificato un errore durante il ritorno all'ultimo canale del dispositivo.

Valori supportati:

channelSwitchFailed

ERRORI del dispositivo

Consulta l'elenco completo di errori ed eccezioni.