Google Cast untuk perangkat audio hanya mendukung pemutaran audio. Panduan ini menjelaskan cara mengoptimalkan aplikasi Cast untuk perangkat khusus audio dan memanfaatkan pengurangan permintaan pada penggunaan memori, CPU, dan 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 layar untuk menampilkan metadata, seperti status pemutaran (diputar atau dijeda) dan progres. Aplikasi Anda tidak boleh menampilkan informasi pengguna yang sangat penting tersebut hanya di penerima; informasi penting, dan sebagian besar antarmuka pengguna, harus ditampilkan pada pengirim.
- Untuk menjalankan aplikasi Penerima Web dengan benar, Google Cast untuk perangkat audio tetap harus merender grafik, meskipun tidak ditampilkan. Karena perangkat mungkin tidak mendukung operasi grafis dengan akselerasi hardware, aplikasi penerima harus menghindari penggunaan operasi grafis yang intensif seperti gradien warna, rotasi, pencampuran alfa, dan menggambar ulang objek besar seperti status progres lebih dari sekali per detik.
- Google Cast untuk perangkat audio hanya mendukung Widevine untuk konten yang dilindungi Pengelolaan Hak Digital (DRM).
- Untuk sebagian besar Google Cast untuk perangkat audio, aplikasi pengirim mengontrol rentang volume penuh 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 untuk mengontrol pemutaran dengan pengontrol perangkat itu sendiri seperti remote control, tombol di perangkat, atau aplikasi jarak jauh eksternal.
- Google Cast untuk perangkat audio dapat mendukung penampilan metadata konten dengan layar LCD kecil, output HDMI (untuk soundbar atau penerima audio-video), 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 memastikan aplikasi tersebut berjalan di Chromecast. Dokumen ini mengasumsikan bahwa Anda telah mengembangkan dan menguji aplikasi tersebut.
Aplikasi dapat mendukung perangkat audio-video dan audio saja. Layanan tersebut perlu mengetahui kapan harus melakukan transmisi ke salah satunya dan mengambil tindakan untuk memastikan pengalaman pengguna terbaik dalam skenario tertentu.
Misalnya, aplikasi audio dan video ganda (seperti aplikasi pemutaran file lokal/NAS) harus memungkinkan transmisi ke perangkat khusus audio untuk mendukung pemutaran file audio, tetapi aplikasi tersebut tidak boleh mengizinkan pengguna untuk 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 untuk audio, aplikasi Anda harus melakukan hal berikut:
Hanya mendukung audio: streaming file musik dan audio, radio, dll. Media yang di-streaming ke aplikasi Penerima Web tidak boleh berupa streaming video. Selain itu, hindari grafik dan gambar streaming untuk mempercepat waktu peluncuran aplikasi dan penggunaan memori. Lihat Panduan penggunaan memori di bawah.
Jalankan seperti yang diharapkan di perangkat Transmisi untuk audio dan Chromecast biasa.
Kemampuan perangkat
Aplikasi Anda 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 mengirim 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 tersebut ke aplikasi Web Receiver 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 mengetahui informasi selengkapnya.
Sender API
Setiap API pengirim Cast juga memiliki informasi kemampuan perangkat. Fungsi 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 gambar atau grafis apa pun, untuk mengurangi jejak memori dan mempersingkat waktu hingga pemutaran dimulai.
- Saat menggunakan Ekstensi Sumber Media (MSE), aplikasi harus membatasi streaming buffer hingga 2 MB. Jika menggunakan Media Player Library (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 menjadi 2 megabit per detik, yang mendukung semua codec yang dijelaskan di 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 perangkat Chromecast. Ini berarti penambahan perubahan volume harus lebih kecil untuk aplikasi khusus audio. Lihat dokumen berikut untuk mendapatkan panduan tentang cara menyediakan kontrol volume di aplikasi Anda:
- Kontrol volume pengirim dalam Checklist Desain
- Volume pengirim Android
- Volume pengirim iOS
- Volume pengirim web
Kontrol perangkat
Google Cast untuk perangkat audio dapat memiliki kontrol pemutarannya sendiri (seperti
tombol, remote). Cara 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
pada aplikasi penerima. Aplikasi penerima 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 mengupdate UI sebagaimana mestinya.
Tampilan perangkat
Google Cast untuk perangkat audio mungkin memiliki layar LCD pada perangkat, atau aplikasi kontrol khusus perangkat yang menampilkan metadata media. Aplikasi penerima harus menyediakan metadata ini untuk semua trek audio dan memastikannya sinkron dengan konten yang sedang diputar untuk memastikan metadata ditampilkan secara tepat di layar. Jika menggunakan metadata kustom, aplikasi juga harus memberikan metadata audio standar (nama lagu, nama artis, judul album, dll.) seperti yang dijelaskan untuk setiap platform di bawah ini.
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 Google Cast untuk perangkat audio. Gunakan API berikut:
Android
MediaMetadatadenganMEDIA_TYPE_MUSIC_TRACKdan:iOS
GCKMediaMetadatadenganGCKMediaMetadataTypeGCKMediaMetadataTypeMusicTrackdan:Chrome
MediaInfodenganMusicTrackMediaMetadatadan:
Jika aplikasi Cast mengelola antrean media pada 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 guna menguji dan mendaftarkan aplikasi Anda guna mendukung Google Cast untuk 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 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 khusus audio.
Google Cast untuk Audio 2.0
Google Cast for Audio (GC4A) 2.0 adalah platform audio Cast generasi berikutnya yang dirancang untuk menargetkan perangkat dengan memori rendah, guna memperluas ekosistem perangkat yang dapat melakukan streaming konten.
Penting bahwa developer aplikasi audio 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 dalam menyiapkan pengujian, atau tidak dapat menggunakan speaker Bose. Jika Anda ingin men-debug aplikasi, Google merekomendasikan penggunaan Cast Debug Logger.