Skema Trait MediaState Smart Home

action.devices.traits.MediaState - Sifat ini digunakan untuk perangkat yang dapat melaporkan status media.

Sifat MediaState digunakan oleh Asisten untuk tujuan berikut:

  • Untuk mengetahui apa yang diputar di setiap perangkat, apakah pemutaran dimulai oleh Asisten atau tidak. Informasi ini membantu Asisten lebih memahami intent pengguna. Misalnya, pengguna akan mengucapkan "Jeda Tonight Show" saat niat sebenarnya adalah "Jeda perangkat yang sedang memutar Tonight Show".
  • Untuk portabilitas antar-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 solusi Anda dengan mengonfigurasi atribut dalam sifat ini. Atribut ini biasanya digunakan bersama dengan atribut TransportControl

ATTRIBUTES Perangkat

Perangkat dengan karakteristik ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari lebih lanjut cara menangani intent SYNC, lihat Fulfillment intent.

Atribut Jenis Deskripsi
supportActivityState Boolean

(Default: false)

Menunjukkan apakah perangkat dapat melaporkan status aktivitas.

supportPlaybackState Boolean

(Default: false)

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 lebih lanjut cara menangani intent QUERY, lihat Fulfillment intent.

Negara bagian Jenis Deskripsi
activityState String

Menunjukkan apakah perangkat aktif dan pengguna berinteraksi secara aktif dengan perangkat tersebut.

Nilai yang didukung:

INACTIVE
STANDBY
ACTIVE
playbackState String

Menunjukkan status saat ini saat memutar media.

Nilai yang didukung:

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

Contoh

Perangkat media yang melaporkan status aktivitas dan pemutaran

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

Perangkat COMMANDS

Tidak ada.

ERROR Perangkat

Lihat daftar lengkap error dan pengecualian.