Skema Atribut MediaState Smart Home
action.devices.traits.MediaState
- Sifat ini digunakan untuk perangkat yang dapat melaporkan status media.
Fitur MediaState
digunakan oleh Asisten untuk tujuan berikut:
- Untuk mengetahui apa yang sedang diputar di setiap perangkat, apakah pemutaran dimulai oleh Asisten atau tidak. Informasi ini membantu Asisten lebih memahami intent pengguna. Misalnya, pengguna akan mengucapkan "Jeda Acara Malam Ini" saat intent yang sebenarnya adalah "Jeda perangkat yang sedang memutar Acara Malam Ini'.
- Untuk portabilitas antar-pemutar media—jika Asisten mengetahui apa yang sedang diputar dan posisi pemutaran saat ini, Asisten dapat mentransfer pemutaran tersebut ke perangkat lain saat pengguna berpindah antar-ruang, atau menyimpan pemutaran untuk digunakan nanti di perangkat arbitrer.
Anda dapat menentukan tingkat dan aspek status media yang disediakan oleh solusi Anda dengan
mengonfigurasi atribut dalam karakteristik ini. Sifat ini biasanya digunakan bersamaan dengan
karakteristik TransportControl
ATRIBUT Perangkat
Perangkat dengan karakteristik 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: Tunjukkan apakah perangkat bisa 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 }
STATE Perangkat
Entitas dengan karakteristik ini dapat melaporkan status
berikut sebagai bagian dari operasi QUERY
. Untuk mempelajari
penanganan intent QUERY
lebih lanjut, lihat
fulfillment intent.
Negara bagian | Type | Deskripsi |
---|---|---|
activityState |
String |
Menunjukkan apakah perangkat aktif dan pengguna secara aktif berinteraksi dengan perangkat. Nilai yang didukung:
|
playbackState |
String |
Mengindikasikan status saat ini saat memutar media. Nilai yang didukung:
|
Contoh
Perangkat media yang melaporkan aktivitas dan status pemutaran
{ "activityState": "ACTIVE", "playbackState": "PAUSED" }
PERMINTAAN Perangkat
Tidak ada.