MediaState Trait-Schema für Smart Home

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

Das Trait „MediaState“ wird von Assistant für folgende Zwecke verwendet:

  • Sie können nachsehen, was auf den einzelnen Geräten wiedergegeben wird und ob die Wiedergabe von Assistant gestartet wurde. Anhand dieser Informationen kann Assistant die Absichten der Nutzer besser verstehen. Nutzer sagen beispielsweise „The Tonight Show pausieren“, wenn sie eigentlich „Das Gerät pausieren, auf dem gerade The Tonight Show läuft“ meinen.
  • Für die Mobilität zwischen Medienplayern: Wenn Assistant weiß, was gerade abgespielt wird und wo die aktuelle Wiedergabeposition ist, kann er die Wiedergabe auf ein anderes Gerät übertragen, wenn sich ein Nutzer zwischen Räumen bewegt, oder die Wiedergabe für später auf einem beliebigen Gerät speichern.

Sie können angeben, welche Ebene und welchen Aspekt von Medienstatus Ihre Lösung bietet, indem Sie die Attribute in diesem Merkmal konfigurieren. Diese Eigenschaft wird in der Regel zusammen mit den Eigenschaften TransportControl verwendet.

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

(Standardeinstellung: false)

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

supportPlaybackState Boolesch

(Standardeinstellung: false)

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

Beispiele

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

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

GERÄTESTATUS

Entitäten mit diesem Merkmal können im Rahmen der QUERY-Operation die folgenden Bundesstaaten melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Ausfü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 bei der Medienwiedergabe an.

Unterstützte Werte:

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

Beispiele

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

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

BEFEHLE für Geräte

Keine.

GERÄTEFEHLER

Eine vollständige Liste der Fehler und Ausnahmen