Smart-Home-TransportControl-Attributschema

action.devices.traits.TransportControl: Dieses Attribut wird für Geräte verwendet, die die Medienwiedergabe steuern können, z. B. die Musikwiedergabe fortsetzen, wenn sie pausiert wurde.

Geräteattribute

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

Attribute Typ Beschreibung
transportControlSupportedCommands Array

Erforderlich.

Eine Liste von Strings, die die unterstützten 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ät, das Wiedergabebefehle unterstützt

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

GERÄTESTATUS

Keine.

Gerätebefehle

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

action.devices.commands.mediaStop

Pausieren Sie die Medienwiedergabe.

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

Pausieren Sie die Medienwiedergabe.

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, um die vor- (positive Ganzzahl) oder zurück (negative Ganzzahl) gesprungen werden soll.

Beispiele

10 Sekunden vorspringen

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

10 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.

Millisekunden der absoluten Position, zu der gesprungen werden soll.

Beispiele

Auf 30 Sekunden springen

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

action.devices.commands.mediaRepeatMode

Wiedergabemodus festlegen

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

Parameter

Parameter Typ Beschreibung
isOn Boolesch

Erforderlich.

„Wahr“, um den Wiederholungsmodus zu aktivieren, „Falsch“, um ihn zu deaktivieren.
isSingle Boolesch

(Standardeinstellung: false)

Wenn angegeben, bedeutet „true“, dass der Modus „Einzelelement wiederholen“ aktiviert wird. „false“ bedeutet, dass der normale Modus „Wiederholen“ aktiviert wird (z. B. für eine Playlist).

Beispiele

Wiederholen am

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

Wiederholen deaktiviert

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

Die aktuelle Playlist als Zufallsmix abspielen

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 Gebietsschema für Untertitel.
userQueryLanguage String

Sprache oder Gebietsschema für die Nutzerabfrage.

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

Untertitel auf Koreanisch mit Nutzerabfrage auf amerikanischem Englisch aktivieren

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

action.devices.commands.mediaClosedCaptioningOff

Deaktiviere die Untertitel.

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

Parameter

Parameter Typ Beschreibung

Keine Attribute

Beispiele

Untertitel ausschalten

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

GERÄTEFEHLER

Eine vollständige Liste der Fehler und Ausnahmen