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