Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Smart-Home-Aktionen. Hinweis:Sie erstellen weiterhin Aktionen in der Actions Console.
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Schema für Smart-Home-Transportsteuerung

action.devices.traits.TransportControl: Diese Eigenschaft wird für Geräte verwendet, die die Medienwiedergabe steuern können, z. B. um die Musikwiedergabe fortzusetzen, wenn sie pausiert ist.

Gerät ATTRIBUTE

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

Attribute Typ Beschreibung
transportControlSupportedCommands Array

Erforderlich.

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

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

Gerät STATES

Keine.

Gerätebefehle

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

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

Parameter

Parameter Typ Beschreibung
relativePositionMs Ganzzahl

Erforderlich.

Millisekunden des vorwärts (positiven int) oder rückwärts (negativen int) Betrags für die Suche.

Beispiele

10 Sekunden vorspulen

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

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.

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

Einstellung "True", um Wiederholungsmodus zu aktivieren, Einstellung "False", Wiederholungsmodus zu deaktivieren

isSingle Boolesch

(Standard: false)

Falls angegeben, gibt „wahr“ an, dass der Wiederholungsmodus für ein Element aktiviert ist, und „falsch“, wenn der normale Wiederholungsmodus aktiviert ist (z. B. eine Playlist).

Beispiele

Wiederholen am

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

Wiederholen

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

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

Aktiviere Untertitel auf Koreanisch, wenn Nutzer nach amerikanischem Englisch suchen.

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

Vollständige Liste der Fehler und Ausnahmen