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:

CAPTION_CONTROL
NEXT
PAUSE
PREVIOUS
RESUME
SEEK_RELATIVE
SEEK_TO_POSITION
SET_REPEAT
SHUFFLE
STOP

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

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

Gerät ERRORS

Sehen Sie sich die vollständige Liste der Fehler und Ausnahmen an.