Schema der Smart-Home-Transport-Kontrolle

action.devices.traits.TransportControl: Diese Eigenschaft wird für Geräte verwendet, die die Medienwiedergabe steuern können (z. B. die Wiedergabe von Musik, wenn sie pausiert ist).

Geräte-ATTRIBUTE

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

Attribute Typ Beschreibung
transportControlSupportedCommands Array

Erforderlich.

Eine Liste mit Strings, die auf diesem Gerät unterstützte Befehle zur Transportsteuerung 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ätestatus

Keine.

BEISPIELE für Geräte

Geräte mit diesem Merkmal können im Rahmen des EXECUTE-Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zum Verarbeiten von 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 bestimmten Position springen

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

Parameter

Parameter Typ Beschreibung
relativePositionMs Ganzzahl

Erforderlich.

Millisekunden, nach denen vorwärts (positive int) oder rückwärts (negative int) gesucht werden soll.

Beispiele

10 Sekunden vorspulen

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

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

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

True, um den Wiederholungsmodus zu aktivieren, False, um den Wiederholungsmodus zu deaktivieren.
isSingle Boolesch

(Standard: false)

Bei Angabe von „true“ bedeutet das, dass der Wiederholungsmodus für einzelne Elemente aktiviert wird, „falsch“ bedeutet, dass der normale Wiederholungsmodus aktiviert wird (z. B. eine Playlist).

Beispiele

Wiederholen am

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

Zufallsmix der aktuellen Playlist 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

Untertitel aktivieren

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

Untertitel für Koreanisch in amerikanischer Sprache 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

Hier finden Sie die vollständige Liste der Fehler und Ausnahmen.