Smart-Home-TransportControl-Trait-Schema
action.devices.traits.TransportControl
: Diese Eigenschaft wird für Geräte verwendet, mit denen die Medienwiedergabe gesteuert werden kann, z. B. die Wiedergabe von Musik bei angehaltener Wiedergabe fortgesetzt wird.
Geräte-ATTRIBUTE
Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des SYNC
-Vorgangs. Weitere Informationen zum Umgang mit SYNC
-Intents finden Sie unter Intent-Auftragsausführung.
Attribute | Typ | Beschreibung |
---|---|---|
transportControlSupportedCommands |
Array |
Erforderlich. Eine Liste von Strings, die die unterstützten Transportsteuerungsbefehle auf diesem Gerät beschreiben. |
[item, ...] |
String |
Unterstützte Befehle. Unterstützte Werte:
|
Beispiele
Gerät, das Wiedergabebefehle unterstützt
{ "transportControlSupportedCommands": [ "NEXT", "PREVIOUS", "PAUSE", "STOP", "RESUME" ] }
Gerät STATES
Keine.
BEFEHLUNGEN auf dem Gerät
Geräte mit dieser Eigenschaft können im Rahmen des EXECUTE
-Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE
-Intents finden Sie unter Intent-Auftragsausführung.
action.devices.commands.mediaStop
Medienwiedergabe anhalten.
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 anhalten.
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
Springen Sie zu einer relativen Position.
Für diesen Befehl sind die folgenden Attribute erforderlich:{ "transportControlSupportedCommands": [ "SEEK_RELATIVE" ] }
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
relativePositionMs |
Ganzzahl |
Erforderlich. Millisekunden des Vorwärts- (positive Ganzzahl) oder Rückwärtswerts (negative Ganzzahl) der Suche. |
Beispiele
Zehn Sekunden vorspulen
{ "command": "action.devices.commands.mediaSeekRelative", "params": { "relativePositionMs": 10000 } }
Zehn Sekunden zurückspulen
{ "command": "action.devices.commands.mediaSeekRelative", "params": { "relativePositionMs": -10000 } }
action.devices.commands.mediaSeekToPosition
Zu einer absoluten Position springen
Für diesen Befehl sind die folgenden Attribute erforderlich:{ "transportControlSupportedCommands": [ "SEEK_TO_POSITION" ] }
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
absPositionMs |
Ganzzahl |
Erforderlich. Millisekunde der absoluten Position, zu der gesucht werden soll. |
Beispiele
In 30 Sek. spulen
{ "command": "action.devices.commands.mediaSeekToPosition", "params": { "absPositionMs": 30000 } }
action.devices.commands.mediaRepeatMode
Wiederholungsmodus festlegen
Für diesen Befehl sind die folgenden Attribute erforderlich:{ "transportControlSupportedCommands": [ "SET_REPEAT" ] }
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
isOn |
Boolesch |
Erforderlich. True, um den Wiederholungsmodus zu aktivieren, falsch, um den Wiederholungsmodus zu deaktivieren. |
isSingle |
Boolesch |
(Standard: Falls angegeben, bedeutet „true“, dass der Wiederholungsmodus für einzelne Elemente aktiviert wird, „false“, dass der normale Wiederholungsmodus (z. B. eine Playlist) aktiviert wird. |
Beispiele
Wiederholen an
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": true } }
Wiederholen aus
{ "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
Gib die aktuelle Playlist als Zufallsmix wieder.
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 die Untertitelung |
userQueryLanguage |
String |
Sprache oder Gebietsschema für die Nutzeranfrage. |
Beispiele
Deutsche Untertitel aktivieren
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "en" } }
Koreanische Untertitel aktivieren
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "ko-KR" } }
Koreanische Untertitel mit Nutzeranfrage in amerikanischem Englisch aktivieren
{ "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": {} }