Selamat datang di Pusat Developer Google Home, tujuan baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Skema Fitur MediaState Smart Home

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

Fitur MediaState digunakan oleh Asisten untuk tujuan ini:

  • 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 Acara Malam Ini" jika intent mereka sebenarnya "Jeda perangkat yang sedang memutar Acara Malam Ini'.
  • Untuk portabilitas di antara 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 bersama dengan ciri-ciri 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 Jenis Deskripsi
supportActivityState Boolean

(Default: false)

Tunjukkan apakah perangkat dapat melaporkan status aktivitas.

supportPlaybackState Boolean

(Default: false)

Tunjukkan 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.

Negara bagian Jenis Deskripsi
activityState String

Tunjukkan apakah perangkat aktif dan pengguna sedang aktif berinteraksi dengan perangkat.

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 aktivitas dan status pemutaran

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

COMMAND Perangkat

Tidak ada.

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.