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 Fortsetzung von Musik im pausierten Zustand).

Geräte-ATTRIBUTES

Auf Geräten mit diesem Trait kann Folgendes gemeldet werden im Rahmen des SYNC-Vorgangs verwenden. Weitere Informationen Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Absichtliche Umsetzung.

Attribute Typ Beschreibung
transportControlSupportedCommands Array

Erforderlich.

Eine Liste von Strings, die unterstützte 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äte, die Wiedergabebefehle unterstützen

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

Gerät: STATES

Keine.

Gerät "COMMANDS"

Geräte mit diesem Merkmal können auf Folgendes reagieren im Rahmen des EXECUTE-Vorgangs ausgeführt. Weitere Informationen Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Absichtliche Umsetzung.

action.devices.commands.mediaStop

Medienwiedergabe pausieren.

Für diesen Befehl sind folgende 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 folgende 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 folgende 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 folgende 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 folgende 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 folgende Attribute erforderlich: 
{
  "transportControlSupportedCommands": [
    "SEEK_RELATIVE"
  ]
}

Parameter

Parameter Typ Beschreibung
relativePositionMs Ganzzahl

Erforderlich.

Millisekunden des zu suchenden Vorwärtsbetrags (positive Ganzzahl) oder umgekehrten Werts (negative Ganzzahl).

Beispiele

10 Sekunden nach vorn springen

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

10 Sekunden zurückspringen

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

action.devices.commands.mediaSeekToPosition

Zu einer absoluten Position springen

Für diesen Befehl sind folgende Attribute erforderlich: 
{
  "transportControlSupportedCommands": [
    "SEEK_TO_POSITION"
  ]
}

Parameter

Parameter Typ Beschreibung
absPositionMs Ganzzahl

Erforderlich.

Millisekunden der absoluten Position, zu der springen soll.

Beispiele

In 30 Sekunden springen

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

action.devices.commands.mediaRepeatMode

Wiederholter Wiedergabemodus festlegen

Für diesen Befehl sind folgende Attribute erforderlich: 
{
  "transportControlSupportedCommands": [
    "SET_REPEAT"
  ]
}

Parameter

Parameter Typ Beschreibung
isOn Boolesch

Erforderlich.

Mit "True" wird der Wiederholungsmodus aktiviert, mit "false" wird der Wiederholungsmodus deaktiviert.
isSingle Boolesch

(Standardeinstellung: false)

Falls angegeben, bedeutet „true“, dass der Wiederholungsmodus für einzelne Elemente aktiviert wird, „false“ bedeutet, dass der normale Wiederholungsmodus aktiviert wird (z. B. eine Playlist).

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

Aktuelle Playlist als Zufallsmix wiedergeben

Für diesen Befehl sind folgende Attribute erforderlich: 
{
  "transportControlSupportedCommands": [
    "SHUFFLE"
  ]
}

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Keine Parameter

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

action.devices.commands.mediaClosedCaptioningOn

Untertitel aktivieren

Für diesen Befehl sind folgende Attribute erforderlich: 
{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parameter

Parameter Typ Beschreibung
closedCaptioningLanguage String

Sprache oder Gebietsschema für die Untertitel.
userQueryLanguage String

Sprache oder Gebietsschema für die 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"
  }
}

Aktivieren Sie die koreanische Untertitelung mit einer Nutzeranfrage in amerikanischem Englisch.

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

action.devices.commands.mediaClosedCaptioningOff

Deaktivieren Sie die Untertitel.

Für diesen Befehl sind folgende Attribute erforderlich: 
{
  "transportControlSupportedCommands": [
    "CAPTION_CONTROL"
  ]
}

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Untertitel deaktivieren

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

Gerätefehler

Vollständige Liste der Fehler und Ausnahmen.