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:

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

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: false)

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

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.