Schema delle caratteristiche TransportControl per la smart home

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

ATTRIBUTES del dispositivo

I dispositivi con questo trait potrebbero segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta fulfillment dell'intent.

Attributi Tipo Descrizione
transportControlSupportedCommands Matrice

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"
  ]
}

Dispositivo STATES

Nessuna.

COMMANDS dispositivo

I dispositivi con questa caratteristica potrebbero rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta fulfillment dell'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

Consente di passare 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

Vai a 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) 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

Va 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 in cui cercare.

Esempi

Vai 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à ripetizione, falso per disattivare la modalità.
isSingle Booleano

(Valore predefinito: false)

Se specificato, true significa attivare la modalità di ripetizione per 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
  }
}

Disattiva ripetizione

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

Ripetizione di una singola traccia

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

action.devices.commands.mediaShuffle

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

ERRORS dispositivo

Consulta l'elenco completo di errori ed eccezioni.