Schemat atrybutu MediaState w inteligentnym domu

action.devices.traits.MediaState – ta cecha jest używana w przypadku urządzeń, które mogą zgłaszać stany multimediów.

Właściwość MediaState jest używana przez Asystenta do tych celów:

  • Aby wiedzieć, co odtwarza się na każdym urządzeniu, niezależnie od tego, czy odtwarzanie zostało zainicjowane przez Asystenta. Te informacje pomagają Asystentowi lepiej zrozumieć intencje użytkownika. Użytkownicy mogą na przykład powiedzieć "Wstrzymaj program Tonight Show", gdy ich rzeczywista intencja to "Wstrzymaj odtwarzanie programu Tonight Show na urządzeniu".
  • Przenoszenie między odtwarzaczami multimediów – jeśli Asystent wie, co jest odtwarzane i gdzie jest aktualnie odtwarzany materiał, może przenieść odtwarzanie na inne urządzenie, gdy użytkownik przejdzie do innego pomieszczenia, lub zapisać odtwarzanie na później na dowolnym urządzeniu.

Możesz określić, na jakim poziomie i w jakich aspektach Twoje rozwiązanie obsługuje stany multimediów, konfigurując atrybuty w tym atrybucie. Ta cecha jest zwykle używana razem z cechami TransportControl

ATRYBUTY URZĄDZENIA

Urządzenia z tą cechą mogą zgłaszać te atrybuty w ramach operacji SYNC. Więcej informacji o obsługiwaniu intencji SYNC znajdziesz w artykule Realizacja intencji.

Atrybuty Typ Opis
supportActivityState Wartość logiczna

(wartość domyślna: false)

Wskaż, czy urządzenie może raportować stan aktywności.

supportPlaybackState Wartość logiczna

(wartość domyślna: false)

Wskaż, czy urządzenie może raportować bieżący stan odtwarzania.

Przykłady

Urządzenie multimedialne, które wysyła informacje o aktywności i stanie odtwarzania w odpowiedzi na żądanie SYNC

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

STANOWISKO URZĄDZENIA

Elementy z tą cechą mogą raportować te stany w ramach operacji QUERY. Więcej informacji o obsługiwaniu intencji QUERY znajdziesz w artykule Realizacja intencji.

Stany Typ Opis
activityState String

Wskazanie, czy urządzenie jest aktywne i czy użytkownik aktywnie z nim współpracuje.

Obsługiwane wartości:

INACTIVE
STANDBY
ACTIVE
playbackState String

Wskazuje bieżący stan podczas odtwarzania multimediów.

Obsługiwane wartości:

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

Przykłady

Urządzenie multimedialne, które raportuje zarówno aktywność, jak i stan odtwarzania

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

Polecenia urządzenia

Brak.

BŁĘDY urządzenia

Zobacz pełną listę błędów i wyjątków.