Ti diamo il benvenuto nel Centro sviluppatori Google Home, la nuova destinazione per imparare a sviluppare azioni per la smart home. Nota:continuerai a creare azioni nella Console Actions.
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

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.