Schema für Smart-Home-Transportsteuerung

action.devices.traits.TransportControl: Diese Eigenschaft wird für Geräte verwendet, die die Medienwiedergabe steuern können, z. B. um die Musikwiedergabe fortzusetzen, wenn sie pausiert ist.

Gerät ATTRIBUTE

Geräte mit diesem Attribut können im Rahmen des Vorgangs SYNC die folgenden Attribute melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute	Typ	Beschreibung
transportControlSupportedCommands	Array	Erforderlich. Eine Liste von Strings, die unterstützte Befehle zur Transportsteuerung auf diesem Gerät beschreiben.
[item, ...]	String	Unterstützte Befehle. Unterstützte Werte: CAPTION_CONTROL NEXT PAUSE PREVIOUS RESUME SEEK_RELATIVE SEEK_TO_POSITION SET_REPEAT SHUFFLE STOP

Beispiele

Geräte, die Wiedergabebefehle unterstützen

{
  "transportControlSupportedCommands": [
    "NEXT",
    "PREVIOUS",
    "PAUSE",
    "STOP",
    "RESUME"
  ]
}

Gerät STATES

Keine.

Gerätebefehle

Geräte mit diesem Attribut können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Auftragsausführung.

action.devices.commands.mediaStop

Medienwiedergabe pausieren.

Für diesen Befehl sind die folgenden Attribute erforderlich:

{
  "transportControlSupportedCommands": [
    "STOP"
  ]
}

Parameter

Parameter	Typ	Beschreibung
Keine Attribute

Beispiele

Keine Parameter

{
  "command": "action.devices.commands.mediaStop",
  "params": {}
}

action.devices.commands.mediaNext

Zum nächsten Medienelement springen.

Für diesen Befehl sind die folgenden Attribute erforderlich:

{
  "transportControlSupportedCommands": [
    "NEXT"
  ]
}

Parameter

Parameter	Typ	Beschreibung
Keine Attribute

Beispiele

Keine Parameter

{
  "command": "action.devices.commands.mediaNext",
  "params": {}
}

action.devices.commands.mediaPrevious

Zum vorherigen Medienelement springen.

Für diesen Befehl sind die folgenden Attribute erforderlich:

{
  "transportControlSupportedCommands": [
    "PREVIOUS"
  ]
}

Parameter

Parameter	Typ	Beschreibung
Keine Attribute

Beispiele

Keine Parameter

{
  "command": "action.devices.commands.mediaPrevious",
  "params": {}
}

action.devices.commands.mediaPause

Medienwiedergabe pausieren.

Für diesen Befehl sind die folgenden Attribute erforderlich:

{
  "transportControlSupportedCommands": [
    "PAUSE"
  ]
}

Parameter

Parameter	Typ	Beschreibung
Keine Attribute

Beispiele

Keine Parameter

{
  "command": "action.devices.commands.mediaPause",
  "params": {}
}

action.devices.commands.mediaResume

Medienwiedergabe fortsetzen.

Für diesen Befehl sind die folgenden Attribute erforderlich:

{
  "transportControlSupportedCommands": [
    "RESUME"
  ]
}

Parameter

Parameter	Typ	Beschreibung
Keine Attribute

Beispiele

Keine Parameter

{
  "command": "action.devices.commands.mediaResume",
  "params": {}
}

action.devices.commands.mediaSeekRelative

Zu einer relativen Position springen

Für diesen Befehl sind die folgenden Attribute erforderlich:

{
  "transportControlSupportedCommands": [
    "SEEK_RELATIVE"
  ]
}

Parameter

Parameter	Typ	Beschreibung
relativePositionMs	Ganzzahl	Erforderlich. Millisekunden des vorwärts (positiven int) oder rückwärts (negativen int) Betrags für die Suche.

Beispiele

10 Sekunden vorspulen

{
  "command": "action.devices.commands.mediaSeekRelative",
  "params": {
    "relativePositionMs": 10000
  }
}

10 Sekunden zurückspulen

{
  "command": "action.devices.commands.mediaSeekRelative",
  "params": {
    "relativePositionMs": -10000
  }
}

action.devices.commands.mediaSeekToPosition

An eine absolute Position springen.

Für diesen Befehl sind die folgenden Attribute erforderlich:

{
  "transportControlSupportedCommands": [
    "SEEK_TO_POSITION"
  ]
}

Parameter

Parameter	Typ	Beschreibung
absPositionMs	Ganzzahl	Erforderlich. Millisekunden der absoluten Position, die gesucht werden soll

Beispiele

Zu 30 Sek. springen

{
  "command": "action.devices.commands.mediaSeekToPosition",
  "params": {
    "absPositionMs": 30000
  }
}

action.devices.commands.mediaRepeatMode

Modus für die wiederholte Wiedergabe festlegen.

Für diesen Befehl sind die folgenden Attribute erforderlich:

{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

Parameter

Parameter	Typ	Beschreibung
isOn	Boolesch	Erforderlich. Einstellung "True", um Wiederholungsmodus zu aktivieren, Einstellung "False", Wiederholungsmodus zu deaktivieren
isSingle	Boolesch	(Standard: false) Falls angegeben, gibt „wahr“ an, dass der Wiederholungsmodus für ein Element aktiviert ist, und „falsch“, wenn der normale Wiederholungsmodus aktiviert ist (z. B. eine Playlist).

Beispiele

Wiederholen am

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

Wiederholen

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

Einzelnen Titel wiederholen

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

action.devices.commands.mediaShuffle

Zufallsmix der aktuellen Playlist wiedergeben.

Für diesen Befehl sind die folgenden Attribute erforderlich:

{
  "transportControlSupportedCommands": [
    "SHUFFLE"
  ]
}

Parameter

Parameter	Typ	Beschreibung
Keine Attribute

Beispiele

Keine Parameter

{
  "command": "action.devices.commands.mediaShuffle",
  "params": {}
}

action.devices.commands.mediaClosedCaptioningOn

Aktiviere die Untertitel.

Für diesen Befehl sind die folgenden Attribute erforderlich:

{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parameter

Parameter	Typ	Beschreibung
closedCaptioningLanguage	String	Sprache oder Sprache für Untertitel
userQueryLanguage	String	Sprache oder Sprache für Nutzeranfrage.

Beispiele

Untertitel auf Englisch aktivieren

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "en"
  }
}

Untertitel auf Koreanisch aktivieren

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "ko-KR"
  }
}

Aktiviere Untertitel auf Koreanisch, wenn Nutzer nach amerikanischem Englisch suchen.

{
  "command": "action.devices.commands.mediaClosedCaptioningOn",
  "params": {
    "closedCaptioningLanguage": "ko-KR",
    "userQueryLanguage": "en-US"
  }
}

action.devices.commands.mediaClosedCaptioningOff

Untertitel deaktivieren

Für diesen Befehl sind die folgenden Attribute erforderlich:

{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parameter

Parameter	Typ	Beschreibung
Keine Attribute

Beispiele

Untertitel deaktivieren

{
  "command": "action.devices.commands.mediaClosedCaptioningOff",
  "params": {}
}

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen