Schema delle caratteristiche TransportControl della smart home

action.devices.traits.TransportControl: questa caratteristica viene utilizzata per i dispositivi in grado di controllare la riproduzione dei contenuti multimediali (ad esempio la riproduzione di musica mentre è in pausa).

ATTRIBUTE del dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Soddisfazione degli intent.

Attributi	Tipo	Descrizione
transportControlSupportedCommands	Array	Obbligatorio. Elenco di stringhe che descrivono i comandi supportati per il controllo dei trasporti su questo dispositivo.
[item, ...]	Stringa	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"
  ]
}

STATEs dispositivo

Nessuna.

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 Soddisfazione degli intent.

action.devices.commands.mediaStop

Metti 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

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

Passa 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 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 di 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

Cerca una posizione relativa.

Questo comando richiede i seguenti attributi:

{
  "transportControlSupportedCommands": [
    "SEEK_RELATIVE"
  ]
}

Parametri

Parametri	Tipo	Descrizione
relativePositionMs	Intero	Obbligatorio. Millisecondi dell'importo in avanti (int positivo) o indietro (int negativo) per la ricerca.

Esempi

Vai avanti di 10 secondi

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

Cerca una posizione assoluta.

Questo comando richiede i seguenti attributi:

{
  "transportControlSupportedCommands": [
    "SEEK_TO_POSITION"
  ]
}

Parametri

Parametri	Tipo	Descrizione
absPositionMs	Intero	Obbligatorio. Millisecondo della posizione assoluta in cui cercare.

Esempi

Dai un'occhiata ai 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	Booleano	Obbligatorio. Vero per attivare la modalità di ripetizione, falso per disattivare la modalità di ripetizione.
isSingle	Booleano	(Valore predefinito: false) Se specificato, vero significa attivare la modalità di ripetizione di un singolo elemento, falso significa attivare la modalità di ripetizione normale (ad esempio una playlist).

Esempi

Attiva ripetizione

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

Ripetizione disattivata

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

Ripetire un singolo brano

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

action.devices.commands.mediaShuffle

Riprodurre in ordine casuale la playlist in riproduzione.

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	Stringa	Lingua o impostazioni internazionali per i sottotitoli.
userQueryLanguage	Stringa	Lingua o impostazioni internazionali per la query dell'utente.

Esempi

Attivare i sottotitoli in inglese

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

Attivare i sottotitoli in coreano

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

Attivare i sottotitoli 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.

Questo comando richiede i seguenti attributi:

{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parametri

Parametri	Tipo	Descrizione
Nessuna proprietà

Esempi

Disattivare i sottotitoli

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

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.