MediaState-Trait-Schema für Smart Home

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

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

  • Um zu erfahren, was auf jedem Gerät läuft, unabhängig davon, ob die Wiedergabe von Assistant initiiert wurde. Diese Informationen helfen Assistant, die Absichten der Nutzer besser zu verstehen. Nutzer sagen beispielsweise „Pause the Tonight Show“, wenn ihre eigentliche Absicht „Pausiere das Gerät, auf dem die Tonight Show läuft“ lautet.
  • Zur Verwendung zwischen Mediaplayern: Wenn Assistant weiß, was gerade läuft und wo die aktuelle Wiedergabe steht, kann Assistant diese Wiedergabe auf ein anderes Gerät übertragen, wenn ein Nutzer zwischen Räumen wechselt, oder die Wiedergabe auf einem beliebigen Gerät für später speichern.

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

Geräte-ATTRIBUTE

Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des SYNC-Vorgangs. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute Typ Beschreibung
supportActivityState Boolesch

(Standard: false)

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

supportPlaybackState Boolesch

(Standard: false)

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

Beispiele

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

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

Gerät STATES

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

Bundesstaaten Typ Beschreibung
activityState String

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

Unterstützte Werte:

INACTIVE
STANDBY
ACTIVE
playbackState String

Zeigt den aktuellen Status beim Abspielen von Medien an.

Unterstützte Werte:

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

Beispiele

Mediengerät, das sowohl die Aktivität als auch den Wiedergabestatus meldet

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

BEFEHLUNGEN auf dem Gerät

Keine.

Gerät ERRORS

Sehen Sie sich die vollständige Liste der Fehler und Ausnahmen an.