Schema del tratto del canale Smart Home

action.devices.traits.Channel: questa caratteristica appartiene ai dispositivi che supportano i canali TV su un dispositivo multimediale.

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

ATTRIBUTI dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per saperne di più sulla gestione degli intent SYNC, consulta Completamento 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 media disponibile.
key String

Obbligatorio.

Identificatore univoco per questo canale. Non esposto agli utenti.
names Array

Obbligatorio.

Elenco dei 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 la comunicazione unidirezionale (true) o bidirezionale (false). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a Report State per questo tratto.

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 potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per saperne di più sulla gestione degli intent EXECUTE, consulta Completamento degli intent.

action.devices.commands.selectChannel

Imposta il canale corrente su un valore specifico.

Parametri

Il payload contiene uno dei seguenti elementi:

Seleziona canale per ID

Parametri Tipo Descrizione
channelCode String

Obbligatorio.

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

Nome semplice del canale richiesto.
channelNumber String

Identificatore numerico del canale richiesto.

Selezionare il canale in base al 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"
  }
}

Vai al canale 3.

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

Modifica il canale corrente di un importo relativo.

Parametri

Parametri Tipo Descrizione
relativeChannelChange Intero

Obbligatorio.

Il numero di canali da aumentare o diminuire.

Esempi

Passa 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

Tornare all'ultimo canale visitato dall'utente.

Parametri

Parametri Tipo Descrizione

Nessuna proprietà

Esempi

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