Schema Trait di TransportControl per smart home

action.devices.traits.TransportControl: questo tratto viene utilizzato per i dispositivi in grado di controllare la riproduzione di contenuti multimediali (ad esempio la ripresa della musica mentre è in pausa).

ATTRIBUTES dispositivo

I dispositivi con questo tratto potrebbero segnalare quanto segue nell'ambito dell'operazione SYNC. Per ulteriori informazioni scopri di più sulla gestione degli intent SYNC; consulta Completamento dell'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

Il dispositivo supporta i comandi di riproduzione

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

STATES del dispositivo

Nessuno.

COMANDI dispositivo

I dispositivi con questo tratto potrebbero rispondere ai seguenti nell'ambito dell'operazione EXECUTE. Per ulteriori informazioni scopri di più sulla gestione degli intent EXECUTE; consulta Completamento dell'intent.

action.devices.commands.mediaStop

Metti in pausa la riproduzione dei 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

Vai 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

Metti in pausa la riproduzione dei 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. Millisecondi della quantità di avanti (int positivo) o indietro (int negativo) da ricercare.

Esempi

Vai 10 secondi avanti

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

Vai 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. Millisecondo della posizione assoluta da cercare.

Esempi

Vai a 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. Vero per attivare la modalità di ripetizione, falso 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 giorno

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

Disattiva ripetizione

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

Ripeti una singola traccia

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

action.devices.commands.mediaShuffle

Riprodurre in ordine casuale la playlist corrente.

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

Questo comando richiede i seguenti attributi:

{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parametri

Parametri	Tipo	Descrizione
closedCaptioningLanguage	String	Lingua o impostazioni internazionali per i sottotitoli.
userQueryLanguage	String	Lingua o impostazioni internazionali per la query dell'utente.

Esempi

Attivare il sottotitolaggio codificato in inglese

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

Attivare il sottotitolaggio codificato in coreano

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

Attivare il sottotitolaggio codificato in coreano con la 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 codificati.

Questo comando richiede i seguenti attributi:

{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parametri

Parametri	Tipo	Descrizione
Nessuna proprietà

Esempi

Disattivare il sottotitolaggio codificato

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

ERRORI dispositivo

Consulta l'elenco completo errori ed eccezioni.