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