Schema delle caratteristiche TransportControl di Smart Home
action.devices.traits.TransportControl
: questa caratteristica viene utilizzata per i dispositivi in grado di controllare la riproduzione dei contenuti multimediali (ad esempio, riprendere la musica mentre è in pausa).
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 |
---|---|---|
transportControlSupportedCommands |
Array |
Obbligatorio. Un elenco di stringhe che descrivono i comandi supportati per il controllo dei trasporti su questo dispositivo. |
[item, ...] |
String |
Comandi supportati. Valori supportati:
|
Esempi
Dispositivo che supporta i comandi di riproduzione
{ "transportControlSupportedCommands": [ "NEXT", "PREVIOUS", "PAUSE", "STOP", "RESUME" ] }
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.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
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 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 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
Vai a una posizione relativa.
Questo comando richiede i seguenti attributi:{ "transportControlSupportedCommands": [ "SEEK_RELATIVE" ] }
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
relativePositionMs |
Intero |
Obbligatorio. Millisecondi dell'importo avanti (int positivo) o indietro (int negativo) da cercare. |
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
Vai a una posizione assoluta.
Questo comando richiede i seguenti attributi:{ "transportControlSupportedCommands": [ "SEEK_TO_POSITION" ] }
Parametri
Parametri | Tipo | Descrizione |
---|---|---|
absPositionMs |
Intero |
Obbligatorio. Millisecondo per la posizione assoluta in cui cercare. |
Esempi
Vai a 30s
{ "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 attivare la modalità di ripetizione normale (ad esempio, una playlist). |
Esempi
Attiva ripetizione
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": true } }
Attiva ripetizione
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": false } }
Ripeti un solo 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 |
String |
Lingua o impostazioni internazionali per i sottotitoli. |
userQueryLanguage |
String |
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" } }
Attiva i sottotitoli in coreano con la query degli utenti 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": {} }