Skema Trait MediaState Smart Home
action.devices.traits.MediaState
- Trait ini digunakan untuk perangkat yang dapat melaporkan status media.
Trait MediaState
digunakan oleh Asisten untuk tujuan berikut:
- Untuk mengetahui konten yang sedang diputar di setiap perangkat, apakah pemutaran dimulai oleh Asisten atau tidak. Informasi ini membantu Asisten memahami intent pengguna dengan lebih baik. Misalnya, pengguna akan mengucapkan "Jeda Pertunjukan Malam Ini" saat intent mereka yang sebenarnya adalah "Jeda perangkat yang sedang memutar Acara Malam Ini'.
- Untuk portabilitas antara pemutar media—jika Asisten mengetahui konten yang sedang diputar dan posisi pemutaran saat ini, Asisten dapat mentransfer pemutaran tersebut ke perangkat lain saat pengguna berpindah antar-ruangan, atau menyimpan pemutaran untuk nanti di perangkat arbitrer.
Anda dapat menentukan tingkat dan aspek status media yang disediakan oleh solusi Anda dengan mengonfigurasi atribut dalam karakteristik ini. Trait ini biasanya digunakan bersama dengan trait TransportControl
ATTRIBUTE Perangkat
Perangkat dengan ciri ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC
. Untuk mempelajari
penanganan intent SYNC
lebih lanjut, lihat
Fulfillment intent.
Atribut | Type | Deskripsi |
---|---|---|
supportActivityState |
Boolean |
(Default: Menunjukkan apakah perangkat dapat melaporkan status aktivitas. |
supportPlaybackState |
Boolean |
(Default: Menunjukkan apakah perangkat dapat melaporkan status pemutaran saat ini. |
Contoh
Perangkat media yang melaporkan aktivitas dan status pemutaran untuk respons SYNC
{ "supportActivityState": true, "supportPlaybackState": true }
STATUS Perangkat
Entitas dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY
. Untuk mempelajari
penanganan intent QUERY
lebih lanjut, lihat
Fulfillment intent.
Status | Type | Deskripsi |
---|---|---|
activityState |
String |
Menunjukkan apakah perangkat aktif dan pengguna secara aktif berinteraksi dengannya. Nilai yang didukung:
|
playbackState |
String |
Menunjukkan status saat ini saat memutar media. Nilai yang didukung:
|
Contoh
Perangkat media yang melaporkan aktivitas dan status pemutaran
{ "activityState": "ACTIVE", "playbackState": "PAUSED" }
Perangkat COMMAND
Tidak ada.