Google Cast untuk perangkat audio hanya mendukung pemutaran audio. Panduan ini menjelaskan cara mengoptimalkan aplikasi Cast untuk perangkat khusus audio dan memanfaatkan mengurangi permintaan pada memori, CPU, dan pemakaian bandwidth jaringan.
Aplikasi yang mendukung Google Cast untuk audio harus mempertimbangkan hal berikut:
- Google Cast untuk perangkat audio tidak menampilkan video atau grafik. Namun, banyak perangkat audio memiliki tampilan untuk menampilkan metadata, seperti status pemutaran (diputar atau dijeda) dan progres. Aplikasi Anda tidak boleh menampilkan informasi pengguna yang penting seperti itu hanya pada penerima. Informasi penting dan sebagian besar antarmuka pengguna harus ditampilkan di pengirim.
- Untuk menjalankan aplikasi Penerima Web dengan benar, Google Cast untuk perangkat audio tetap harus merender grafis, meskipun tidak ditampilkan. Karena perangkat mungkin tidak mendukung operasi grafis yang dipercepat hardware, aplikasi penerima harus menghindari penggunaan operasi yang banyak menggunakan grafik seperti gradien warna, rotasi, pencampuran alfa, dan penggambaran ulang objek besar seperti status progres lebih dari sekali per detik.
- Google Cast untuk perangkat audio hanya mendukung konten yang dilindungi Widevine untuk Pengelolaan Hak Digital (DRM).
- Untuk sebagian besar Google Cast untuk perangkat audio, aplikasi pengirim mengontrol rentang volume lengkap perangkat (misalnya, speaker), bukan hanya volume input sumber audio ke TV, seperti pada perangkat Chromecast.
- Selain mengontrol pemutaran dengan perangkat pengirim (misalnya, ponsel), aplikasi mungkin harus menyediakan kontrol untuk mengontrol pemutaran dengan pengontrol perangkat sendiri, seperti remote control, tombol di perangkat, atau aplikasi jarak jauh eksternal.
- Perangkat Google Cast untuk audio dapat mendukung penampilan metadata konten dengan layar LCD kecil, output HDMI (untuk soundbar atau penerima video audio), atau aplikasi jarak jauh eksternal, bergantung pada UI perangkat tertentu.
Pengembangan
Langkah pertama dalam mengembangkan aplikasi Cast guna mendukung Google Cast untuk audio adalah mengembangkan aplikasi Cast untuk audio-video, dan memastikannya berjalan di Chromecast. Dokumen ini mengasumsikan bahwa Anda telah mengembangkan dan menguji aplikasi tersebut.
Aplikasi dapat mendukung perangkat audio dan video saja. Ia perlu mengetahui kapan melakukan transmisi ke satu sama lain dan mengambil tindakan untuk memastikan pengalaman pengguna terbaik dalam skenario yang ditentukan.
Misalnya, aplikasi video dan audio ganda (seperti aplikasi pemutaran file lokal/NAS) harus mengaktifkan transmisi ke perangkat khusus audio untuk mendukung pemutaran file audio, tetapi aplikasi tidak boleh mengizinkan pengguna mengirim file video ke perangkat khusus audio. Aplikasi dapat menggunakan API kemampuan perangkat untuk pengirim yang dijelaskan di bawah untuk menentukan konten yang sesuai untuk perangkat.
Untuk mendukung Google Cast audio, aplikasi harus melakukan hal berikut:
Mendukung audio saja: streaming musik dan file audio, radio, dll. Media yang di-streaming ke aplikasi Penerima Web tidak boleh berupa streaming video. Selain itu, hindari streaming gambar dan gambar untuk meningkatkan waktu peluncuran dan penggunaan memori aplikasi. Lihat Pedoman penggunaan memori, di bawah ini.
Jalankan seperti yang diharapkan di perangkat Cast untuk audio, serta Chromecast reguler.
Kemampuan perangkat
Aplikasi dapat mengetahui apakah aplikasi berjalan di perangkat khusus audio berdasarkan API kemampuan perangkat, yang tersedia dari perangkat itu sendiri atau melalui API pengirim atau penerima.
Header HTTP perangkat
Header HTTP CAST-DEVICE-CAPABILITIES yang disediakan oleh perangkat Cast selama
peluncuran aplikasi menjelaskan kemampuan perangkat. Perangkat mengirimkan permintaan
dengan header ini ke server yang menghosting aplikasi Penerima Web. Header untuk
perangkat khusus audio menjelaskan kemampuan perangkat dengan
CAST-DEVICE-CAPABILITIES: {"display_supported":false}.
Saat server menerima permintaan dari perangkat, Anda dapat menggunakan informasi dalam header ini untuk mengalihkan permintaan ke aplikasi Penerima Web yang dioptimalkan untuk perangkat audio.
API Penerima Web
Anda bisa mendapatkan objek kemampuan perangkat yang sama dengan memanggil CastReceiverManager.getDeviceCapabilities()
saat aplikasi Web Receiver dimuat.
Lihat Kemampuan perangkat untuk informasi selengkapnya.
Sender API
Setiap API pengirim Cast juga memiliki informasi kemampuan perangkat. Ini memungkinkan aplikasi pengirim menentukan jenis media yang akan dikirim ke penerima. Jika mendukung audio dan video, aplikasi Anda dapat menghindari pengiriman konten video ke perangkat khusus audio. Selain itu, aplikasi Anda dapat mengontrol volume menggunakan metode yang paling sesuai untuk perangkat, seperti yang dijelaskan dalam Checklist Desain. Lihat API kemampuan perangkat berikut untuk pengirim:
- Android: CastDevice.hasCapabilities
- iOS: deviceCapabilities
- Chrome: chrome.cast.Capability
Panduan penggunaan memori
Aplikasi Penerima Web yang berjalan di perangkat audio harus mengelola penggunaan memori sebagai berikut:
- Hindari mendownload atau menggunakan aset visual atau gambar apa pun, untuk mengurangi jejak memori dan mempersingkat waktu hingga pemutaran dimulai.
- Saat menggunakan Ekstensi Sumber Media (MSE), aplikasi harus membatasi buffer streaming hingga 2 MB. Jika menggunakan Library Pemutar Media (MPL), ukuran buffer streaming aplikasi sudah ditentukan oleh MPL.
- Saat menggunakan HTMLMediaElement, ukuran buffer streaming aplikasi ditentukan oleh Chrome berdasarkan kecepatan streaming. Batasi kecepatan bit audio hingga 2 megabit per detik, yang mendukung semua codec yang dijelaskan dalam Media yang Didukung (hingga 48 KHz/16 bit).
Kontrol volume
Untuk sebagian besar Google Cast untuk perangkat audio, aplikasi pengirim mengontrol rentang volume penuh perangkat, bukan hanya volume input sumber audio, seperti pada perangkat Chromecast. Ini berarti penambahan perubahan volume harus lebih kecil untuk aplikasi khusus audio. Lihat dokumen berikut untuk mendapatkan panduan cara menyediakan kontrol volume di aplikasi Anda:
- Kontrol volume pengirim di Checklist Desain
- Volume pengirim Android
- Volume pengirim iOS
- Volume pengirim web
Kontrol perangkat
Google Cast untuk perangkat audio mungkin memiliki kontrol pemutarannya sendiri (seperti
tombol, remote). Pesan ini menggunakan pesan pemutaran media yang ditentukan untuk
namespace urn:x-cast:com.google.cast.media, seperti yang dijelaskan dalam
Pesan Pemutaran Media, untuk mengontrol pemutaran
di aplikasi penerima. Aplikasi penerima Anda harus mendukung
pesan pemutaran media ini untuk mendukung kontrol pemutaran perangkat.
Selain itu, aplikasi pengirim harus mendukung Pesan dari penerima ke pengirim sehingga jika pengguna mengubah status media dengan kontrol perangkat, aplikasi pengirim Anda dapat menerima pesan status dari penerima dan memperbarui UI sesuai dengan itu.
Tampilan perangkat
Perangkat Google Cast untuk audio mungkin memiliki layar LCD di perangkat atau aplikasi kontrol khusus perangkat yang menampilkan metadata media. Aplikasi penerima harus memberikan metadata ini untuk semua trek audio, dan memastikannya sinkron dengan konten yang sedang diputar untuk memastikan metadata ditampilkan dengan tepat di layar. Jika menggunakan metadata kustom, aplikasi juga harus menyediakan metadata audio standar (nama trek, nama artis, judul album, dll.) seperti yang dijelaskan untuk setiap platform di bawah.
Penerima mendapatkan metadata dari pengirim saat memuat media. Di aplikasi pengirim, dengan perintah untuk memuat media di penerima, Anda harus menentukan kolom yang dijelaskan di bawah sehingga metadata akan ditampilkan di perangkat Google Cast untuk audio. Gunakan API berikut:
Android
MediaMetadatadenganMEDIA_TYPE_MUSIC_TRACKdan:iOS
GCKMediaMetadatadenganGCKMediaMetadataTypeGCKMediaMetadataTypeMusicTrackdan:Chrome
MediaInfodenganMusicTrackMediaMetadatadan:
Jika aplikasi Cast mengelola antrean media di penerima atau di cloud, Penerima Web harus menyiarkan pembaruan status media apa pun menggunakan
namespace urn:x-cast:com.google.cast.media sehingga semua pengirim akan
disinkronkan.
Pendaftaran
Anda harus mendaftarkan Google Cast untuk perangkat audio agar dapat menguji dan mendaftarkan aplikasi untuk mendukung Google Cast bagi perangkat audio, dengan menggunakan Konsol Developer SDK Google Cast.
- Lihat Perangkat untuk mengetahui informasi selengkapnya tentang mendaftarkan perangkat.
- Anda harus mencentang kotak Mendukung transmisi ke perangkat khusus audio saat mendaftarkan aplikasi agar aplikasi Anda dapat menemukan Google Cast untuk perangkat audio. Lihat Mendaftarkan permohonan.
Untuk aplikasi yang tidak dipublikasikan, seperti yang digunakan untuk pengujian, Anda juga harus memilih opsi untuk mendukung perangkat khusus audio agar aplikasi dapat menemukan perangkat audio saja.
Google Cast untuk Audio 2.0
Google Cast untuk Audio (GC4A) 2.0 adalah platform audio Cast generasi berikutnya yang dirancang untuk menargetkan perangkat dengan memori rendah, guna memperluas ekosistem perangkat yang dapat mengalirkan konten Anda.
Penting bagi developer aplikasi audio untuk menguji aplikasi mereka di GC4A 2.0. Anda dapat menguji aplikasi Cast untuk GC4A 2.0 di speaker Bose produksi (misalnya, Bose Smart Speaker 500).
Hubungi gc4a-support-external@google.com jika Anda memerlukan bantuan untuk menyiapkan pengujian, atau tidak dapat menggunakan speaker Bose. Jika Anda ingin men-debug aplikasi, Google merekomendasikan untuk menggunakan Logger Debug Cast.