Schema delle caratteristiche del canale per la 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 sotto forma di elenco, per utente o dispositivo, durante la sincronizzazione tramite l'attributo availableChannels. Questo elenco deve comprendere tutti i canali principali o popolari a cui l'utente o il dispositivo è iscritto. Per garantire una bassa latenza delle query, ti consigliamo di mantenere un elenco di canali limitato (fino a 30 canali).

ATTRIBUTE dispositivo

I dispositivi con questo trattino potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per saperne di più sulla gestione degli intent SYNC, consulta la sezione fulfillment di 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 sul dispositivo.
[item, ...] Oggetto

Canale media disponibile.
key String

Obbligatorio.

Identificatore univoco per questo canale. Non esposti 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 Booleano

(Valore predefinito: false)

Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (falso). Imposta questo attributo su "true" se il dispositivo non può rispondere a un intent QUERY o a uno stato del report 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"
    }
  ]
}

STATO dispositivo

Nessuna.

COMANDI dispositivo

I dispositivi con questo trattino potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per saperne di più sulla gestione degli intent EXECUTE, consulta la sezione fulfillment di intent.

action.devices.commands.selectChannel

Imposta il canale corrente su un valore specifico.

Parametri

Il payload contiene uno dei seguenti valori:

Seleziona canale per ID

Parametri Tipo Descrizione
channelCode String

Obbligatorio.

L'identificatore univoco del canale richiesto, corrispondente a uno dei availableChannels.
channelName String

Nome semplice del canale richiesto.
channelNumber String

Identificatore numerico per il canale richiesto.

Seleziona canale per numero

Parametri Tipo Descrizione
channelNumber String

Obbligatorio.

Identificatore numerico per il canale richiesto.

Esempi

Passa 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 in base a 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 modifica del canale del dispositivo.

Valori supportati:

channelSwitchFailed

action.devices.commands.returnChannel

Torna all'ultimo canale precedente o dell'utente precedente.

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 degli errori e delle eccezioni.