Schema del tratto TransportControl per la smart home

action.devices.traits.TransportControl: questo attributo viene utilizzato per i dispositivi in grado di controllare la riproduzione dei contenuti multimediali (ad esempio, riprendere la musica quando è in pausa).

ATTRIBUTI del dispositivo

I dispositivi con questa caratteristica possono 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
transportControlSupportedCommands Array

Obbligatorio.

Un elenco di stringhe che descrivono i comandi di controllo del trasporto supportati su questo dispositivo.
[item, ...] String

Comandi supportati.

Valori supportati:

CAPTION_CONTROL
NEXT
PAUSE
PREVIOUS
RESUME
SEEK_RELATIVE
SEEK_TO_POSITION
SET_REPEAT
SHUFFLE
STOP

Esempi

Dispositivo che supporta i comandi di riproduzione

{
  "transportControlSupportedCommands": [
    "NEXT",
    "PREVIOUS",
    "PAUSE",
    "STOP",
    "RESUME"
  ]
}

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

Mettere in pausa la riproduzione di contenuti multimediali.

Questo comando richiede i seguenti attributi: 
{
  "transportControlSupportedCommands": [
    "STOP"
  ]
}

Parametri

Parametri Tipo Descrizione

Nessuna proprietà

Esempi

Nessun parametro

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

action.devices.commands.mediaNext

Passa all'elemento multimediale successivo.

Questo comando richiede i seguenti attributi: 
{
  "transportControlSupportedCommands": [
    "NEXT"
  ]
}

Parametri

Parametri Tipo Descrizione

Nessuna proprietà

Esempi

Nessun parametro

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

action.devices.commands.mediaPrevious

Vai all'elemento multimediale precedente.

Questo comando richiede i seguenti attributi: 
{
  "transportControlSupportedCommands": [
    "PREVIOUS"
  ]
}

Parametri

Parametri Tipo Descrizione

Nessuna proprietà

Esempi

Nessun parametro

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

action.devices.commands.mediaPause

Mettere in pausa la riproduzione di contenuti multimediali.

Questo comando richiede i seguenti attributi: 
{
  "transportControlSupportedCommands": [
    "PAUSE"
  ]
}

Parametri

Parametri Tipo Descrizione

Nessuna proprietà

Esempi

Nessun parametro

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

action.devices.commands.mediaResume

Riprendi la riproduzione dei contenuti multimediali.

Questo comando richiede i seguenti attributi: 
{
  "transportControlSupportedCommands": [
    "RESUME"
  ]
}

Parametri

Parametri Tipo Descrizione

Nessuna proprietà

Esempi

Nessun parametro

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

action.devices.commands.mediaSeekRelative

Vai a una posizione relativa.

Questo comando richiede i seguenti attributi: 
{
  "transportControlSupportedCommands": [
    "SEEK_RELATIVE"
  ]
}

Parametri

Parametri Tipo Descrizione
relativePositionMs Intero

Obbligatorio.

Milisecondi dell'importo in avanti (int positivo) o indietro (int negativo) da cercare.

Esempi

Vai avanti di 10 secondi

{
  "command": "action.devices.commands.mediaSeekRelative",
  "params": {
    "relativePositionMs": 10000
  }
}

Torna indietro di 10 secondi

{
  "command": "action.devices.commands.mediaSeekRelative",
  "params": {
    "relativePositionMs": -10000
  }
}

action.devices.commands.mediaSeekToPosition

Vai a una posizione assoluta.

Questo comando richiede i seguenti attributi: 
{
  "transportControlSupportedCommands": [
    "SEEK_TO_POSITION"
  ]
}

Parametri

Parametri Tipo Descrizione
absPositionMs Intero

Obbligatorio.

Milisecondo della posizione assoluta a cui andare.

Esempi

Avanzare di 30 secondi

{
  "command": "action.devices.commands.mediaSeekToPosition",
  "params": {
    "absPositionMs": 30000
  }
}

action.devices.commands.mediaRepeatMode

Imposta la modalità di riproduzione ripetuta.

Questo comando richiede i seguenti attributi: 
{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

Parametri

Parametri Tipo Descrizione
isOn Valore booleano

Obbligatorio.

True per attivare la modalità di ripetizione, false per disattivarla.
isSingle Valore booleano

(valore predefinito: false)

Se specificato, true significa attivare la modalità di ripetizione di un singolo elemento, false significa attivare la modalità di ripetizione normale (ad esempio una playlist).

Esempi

Ripeti il

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": true
  }
}

Ripeti disattivata

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": false
  }
}

Riprodurre un singolo canale

{
  "command": "action.devices.commands.mediaRepeatMode",
  "params": {
    "isOn": true,
    "isSingle": true
  }
}

action.devices.commands.mediaShuffle

Riproduci la playlist corrente in ordine casuale.

Questo comando richiede i seguenti attributi: 
{
  "transportControlSupportedCommands": [
    "SHUFFLE"
  ]
}

Parametri

Parametri Tipo Descrizione

Nessuna proprietà

Esempi

Nessun parametro

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

action.devices.commands.mediaClosedCaptioningOn

Attiva i sottotitoli.

Questo comando richiede i seguenti attributi: 
{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parametri

Parametri Tipo Descrizione
closedCaptioningLanguage String

Lingua o impostazioni internazionali per i sottotitoli codificati.
userQueryLanguage String

Lingua o impostazioni internazionali per la query dell'utente.

Esempi

Attivare i sottotitoli codificati in inglese

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "en"
  }
}

Attivare i sottotitoli codificati in coreano

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "ko-KR"
  }
}

Attivare i sottotitoli codificati in coreano con una query dell'utente in inglese americano

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "ko-KR",
    "userQueryLanguage": "en-US"
  }
}

action.devices.commands.mediaClosedCaptioningOff

Disattiva i sottotitoli.

Questo comando richiede i seguenti attributi: 
{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parametri

Parametri Tipo Descrizione

Nessuna proprietà

Esempi

Disattivare i sottotitoli codificati

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

ERRORI del dispositivo

Consulta l'elenco completo di errori ed eccezioni.