Schema der Smart-Home-MediaState-Straße

action.devices.traits.MediaState: Diese Eigenschaft wird für Geräte verwendet, die Medienstatus melden können.

Die Eigenschaft MediaState wird von Assistant für folgende Zwecke verwendet:

  • Um zu wissen, was auf jedem Gerät abgespielt wird, ob die Wiedergabe von Assistant gestartet wurde oder nicht. Anhand dieser Informationen kann Assistant die Nutzerabsichten besser nachvollziehen. Nutzer hören beispielsweise „Pausiere die Tonight Show“, wenn ihre Absicht „Das Gerät, das gerade die Tonight Show abspielt“ pausiert wird.
  • Für die Portabilität zwischen Mediaplayern – wenn Assistant weiß, was gespielt wird und welche Position die aktuelle Wiedergabe hat, kann Assistant diese Wiedergabe auf ein anderes Gerät übertragen, wenn ein Nutzer zwischen Räumen wechselt, oder die Wiedergabe für ein späteres Gerät speichern.

Sie können angeben, welche Ebene und welcher Aspekt der Medienstatus Ihre Lösung bietet, indem Sie die Attribute in dieser Eigenschaft konfigurieren. Diese Eigenschaft wird normalerweise zusammen mit den Merkmalen TransportControl verwendet

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
supportActivityState Boolesch

(Standard: false)

Gib an, ob das Gerät den Aktivitätsstatus melden kann.

supportPlaybackState Boolesch

(Standard: false)

Gib an, ob das Gerät den aktuellen Wiedergabestatus melden kann.

Beispiele

Mediengerät, das sowohl Aktivitäts- als auch Wiedergabestatus für die SYNC-Antwort meldet

{
  "supportActivityState": true,
  "supportPlaybackState": true
}

Gerätestatus

Entitäten mit diesem Merkmal können im Rahmen des QUERY-Vorgangs die folgenden Status melden: Weitere Informationen zum Verarbeiten von QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten Typ Beschreibung
activityState String

Gib an, ob das Gerät aktiv ist und der Nutzer damit interagiert.

Unterstützte Werte:

INACTIVE
STANDBY
ACTIVE
playbackState String

Gibt den aktuellen Status beim Abspielen von Medien an.

Unterstützte Werte:

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

Beispiele

Mediengerät, das sowohl Aktivität als auch Wiedergabestatus anzeigt

{
  "activityState": "ACTIVE",
  "playbackState": "PAUSED"
}

BEISPIELE für Geräte

Keine.

Gerät ERRORS

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