Migrasi HLS Di Shaka Player

Ringkasan

Cast Web Receiver SDK mendukung pemutaran konten menggunakan beberapa protokol streaming web. Berdasarkan protokol yang digunakan, SDK memuat pemutar untuk menangani pemutaran konten. Dalam kasus konten HLS, Media Player Library (MPL) dimuat. Dalam kasus konten DASH, Shaka Player dimuat.

Ke depannya, tim engineering Cast SDK dan Shaka Player akan menggabungkan upaya untuk meningkatkan dukungan pemutaran konten HLS di Shaka Player. MPL tidak akan lagi menerima update penting. Sebaiknya Anda memilih untuk menggunakan Shaka Player untuk pemutaran konten HLS aplikasi Anda.

Manfaat Shaka Player

Dalam mengubah pemain, aplikasi akan mendapatkan manfaat berikut:

• Sesi streaming yang lebih andal untuk pengguna, dengan peningkatan pada kegagalan waktu pemuatan dan latensi.
• Terus menggunakan fitur HLS terbaru.
• Peningkatan kejelasan dalam analisis penyebab utama untuk masalah kompatibilitas konten-pemutar karena sifat open source Shaka Player.
• Kode dasar pemutar open source memungkinkan partner berkontribusi pada Project Shaka Player.
• Pengurangan waktu yang signifikan untuk fitur dan perbaikan bug ke produksi karena irama rilis Shaka Player sering dan tidak bergantung pada rilis Web Receiver SDK.
• Kontrol yang lebih besar atas lingkungan pemutaran yang disediakan oleh shakaVersion API.
• Peningkatan dukungan pemutaran dari Google dengan sumber daya engineering yang berfokus pada pemutaran HLS di Shaka Player seperti yang terlihat di roadmap.

Linimasa

Web Receiver SDK akan bertransisi menggunakan Shaka Player sebagai pemutar default untuk pemutaran konten HLS. Hal ini akan dilakukan secara bertahap untuk memandu partner melalui proses migrasi.

Fase	Tanggal Mulai	Ringkasan
1	Okt 2022	Cast Web Receiver SDK memperkenalkan API untuk memilih ikut serta memutar konten HLS di Shaka Player.
2	Nov '25	Cast Web Receiver SDK mengubah pemutar default menjadi Shaka Player untuk pemutaran konten HLS.

Tim engineering Web Receiver SDK menerapkan pendekatan berbasis performa dan hanya akan melanjutkan ke fase berikutnya jika performa Shaka Player setara dengan performa dasar MPL. Perubahan ini akan diumumkan di grup google cast-sdk-announcements dan diperbarui dalam panduan ini.

Ikut serta

Mulai dari CAF versi 3.0.0105, ada konfigurasi tingkat aplikasi untuk ikut serta menggunakan Shaka Player untuk pemutaran HLS. Versi ini juga memperkenalkan API untuk memilih dari rentang versi Shaka Player yang didukung untuk dimuat. Flag ini disediakan di class CastReceiverOptions melalui properti useShakaForHls dan shakaVersion serta dievaluasi saat CastReceiverContext dimulai. Setiap aplikasi yang memilih untuk menggunakan Shaka for HLS harus menetapkan versi Shaka Player minimal 4.15.12 untuk memanfaatkan peningkatan HLS terbaru. Untuk ikut serta, ikuti cuplikan kode di bawah:

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = true;

context.start(castReceiverOptions);

Catatan: Jika disetel, properti shakaVersion akan menyematkan versi Shaka Player. Tindakan ini menggantikan nilai default yang ditentukan oleh Web Receiver SDK. Sebaiknya hapus properti shakaVersion setelah versi Shaka Player default lebih besar daripada versi yang Anda tetapkan. Dengan begitu, aplikasi Anda akan selalu diupdate dengan perubahan Web Receiver SDK terbaru. Perubahan pada versi Shaka Player default diposting di catatan rilis dan dikomunikasikan melalui grup Google cast-sdk-announcements.

Memvalidasi konten

Partner harus memvalidasi pemutaran konten mereka di Shaka Player sebelum memilih untuk menggunakan Shaka Player di aplikasi produksi mereka. Sebaiknya uji setiap variasi konten Anda yang tercantum di bawah:

• Jenis streaming: LIVE atau VOD
• Format container: TS, MP4, atau aliran elementer
• Konten dengan diskontinuitas atau iklan sematan
• Pemutaran di jenis perangkat berikut: layar smart, dongle Google Cast, perangkat Android TV, TV dengan Google Cast, speaker smart

Jika Anda menemukan error atau perilaku yang tidak terduga, ajukan bug. Setelah Anda dapat memverifikasi bahwa tidak ada kegagalan pemutaran yang kritis dalam konten Anda, terapkan perubahan ke lingkungan produksi Anda.

Nonaktifkan

Web Receiver SDK akan bertransisi ke model keikutsertaan untuk pemutaran konten HLS Shaka Player sesuai dengan jadwal. Properti useShakaForHls akan mengubah nilai defaultnya dari false menjadi true. Pada saat itu, aplikasi dapat memilih untuk menggunakan MPL untuk pemutaran HLS dengan menetapkan properti ini ke false secara manual. Saat CastReceiverContext dimulai, Web Receiver SDK akan kembali memuat MPL, bukan Shaka Player. Lihat contoh di bawah untuk mengetahui cara menonaktifkan:

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = false;

context.start(castReceiverOptions);

Laporkan masalah

Kami mendorong partner kami untuk melaporkan masalah apa pun yang mereka temukan saat memutar konten HLS. Seperti yang disebutkan, MPL tidak akan lagi menerima update penting. Jika ada masalah dengan MPL, ikuti langkah-langkah di bagian Ikut serta dalam panduan untuk memverifikasi apakah beralih ke Shaka Player akan mengatasi masalah Anda. Ikuti langkah-langkah di bawah jika masalah masih ada atau jika Anda mengalami masalah lain saat mengganti pemain.

1. Coba setel shakaVersion ke versi cabang lain untuk menyelesaikan masalah. Misalnya, jika masalah terjadi di cabang 4.15, coba tetapkan ke rilis terbaru di cabang lain. Periksa catatan rilis Shaka Player untuk menemukan rilis dengan update yang paling relevan. Perhatikan bahwa API shakaVersion memiliki versi minimum dan maksimum yang didukung seperti yang dijelaskan dalam dokumentasi referensi. Jika Anda melihat adanya regresi, laporkan masalah tersebut di pelacak masalah Shaka Player.
2. Coba ubah parameter konfigurasi pemutar. Shaka Player dapat dikonfigurasi melalui objek PlayerConfiguration. Web Receiver SDK menentukan serangkaian nilai default dan memungkinkan aplikasi mengubah konfigurasi ini melalui properti shakaConfig di objek PlaybackConfig. Nilai ini dievaluasi selama waktu pemuatan saat instance pemutar dibuat. Lihat selengkapnya di konfigurasi dan opsi aplikasi. Nilai default yang ditetapkan oleh Web Receiver SDK adalah nilai yang direkomendasikan.
3. Lihat apakah masalah telah dilaporkan di pelacak masalah Shaka Player atau pelacak masalah Cast. Beri komentar pada bug dan tambahkan informasi yang relevan jika bug tersebut juga menjelaskan masalah Anda.
4. Uji konten Anda di situs demo Shaka Player. Jika Anda menemukan bahwa masalah tersebut muncul kembali di situs demo untuk konten Anda, laporkan bug ke project Shaka Player.
5. Laporkan bug di Pelacak Masalah Cast jika Anda mengalami masalah unik pada Shaka Player di endpoint cast.

FAQ

Perubahan pemain dapat menimbulkan banyak pertanyaan. Di bawah ini Anda akan menemukan jawaban atas pertanyaan paling umum untuk membantu memandu Anda melalui proses migrasi.

Haruskah saya bermigrasi ke Shaka Player?

Sebaiknya partner yang menggunakan konten HLS memulai proses migrasi sesegera mungkin. Hasilnya, aplikasi Anda akan memberikan pengalaman streaming yang lebih andal bagi pengguna Anda. Manfaat lainnya diuraikan di bagian Manfaat Shaka Player dalam panduan ini. Partner harus memverifikasi bahwa aplikasi mereka berfungsi dengan baik menggunakan Shaka Player untuk memastikan transisi yang lancar. Beberapa aplikasi mungkin berisiko saat transisi Web Receiver SDK ke model keikutsertaan jika partner tidak memverifikasi bahwa konten mereka diputar dengan benar di Shaka Player sebelumnya.

Berapa tingkat upaya yang diperlukan saat mengganti pemain?

Partner harus menguji aplikasi dan konten mereka di lingkungan pengujian untuk memastikan pengalaman pengguna serupa atau lebih baik jika dibandingkan dengan HLS. Untuk melakukannya, partner harus mengaktifkan fitur ini di lingkungan internal dan menguji secara menyeluruh bahwa konten mereka dapat diputar menggunakan Shaka Player. Lihat memvalidasi konten untuk mengetahui detail tentang aspek konten yang harus Anda fokuskan. Setelah divalidasi, partner harus menambahkan tanda untuk memilih ikut serta di lingkungan aplikasi produksi mereka untuk mulai memanfaatkan manfaat yang diberikan oleh Shaka Player. Secara umum, ada perubahan pengembangan software minimal dan sebagian besar persyaratan QA bagi partner kami agar berhasil melakukan migrasi.

Aplikasi saya akan segera menggunakan HLS untuk melakukan streaming konten. Apa yang harus saya lakukan?

Integrasi baru harus memilih untuk menggunakan Shaka Player untuk pemutaran. Aplikasi Anda akan didukung dengan lebih baik dalam jangka panjang dan juga akan memanfaatkan fitur HLS baru serta peningkatan performa. Jika integrasi baru Anda mengalami masalah, ajukan bug sesegera mungkin agar tim engineering memiliki cukup waktu untuk menyelesaikan masalah tersebut. Jika aplikasi Anda memiliki batas waktu yang ketat, sertakan informasi tersebut dalam laporan bug serta dampaknya untuk memprioritaskan perbaikan yang sesuai. Tim engineering kami akan berupaya memberikan solusi untuk mendukung pengguna Anda secara memadai.

Konten atau aplikasi saya tidak berfungsi dengan Shaka Player, lalu apa yang harus dilakukan?

Anda harus mengajukan bug ke Project Shaka Player atau project Cast (lihat Melaporkan masalah). Tim engineering Cast SDK secara aktif memantau pelacak ini dan akan bekerja sama dengan Anda untuk menyelesaikan masalah yang ada. Semakin awal masalah ini terdeteksi, semakin banyak waktu yang akan mereka miliki untuk memberikan perbaikan.

MPL tidak lagi menerima update penting, apa artinya?

Sebelumnya, MPL telah mengadopsi fitur HLS baru dan memperbaiki bug utama melalui update penting. Karena MPL tidak akan lagi menerimanya, fitur HLS baru tidak akan ditambahkan ke pemutar. Demikian pula, masalah yang dilaporkan untuk pemutaran HLS di MPL tidak akan diperbaiki di MPL. Masalah ini harus diselesaikan dengan beralih ke Shaka Player untuk pemutaran. Jika masalah berlanjut, bug harus dilaporkan dengan masalah relevan yang dihadapi di Shaka Player. Partner sebaiknya tidak lagi menggunakan MPL.

Konten saya menggunakan protokol Smooth Streaming, bagaimana pengaruhnya terhadap aplikasi saya?

Biner MPL akan tetap dihosting dan dapat diakses oleh aplikasi penerima Anda. Namun, setiap permintaan fitur dan perbaikan bug terkait Smooth Streaming tidak akan didukung karena spesifikasi Smooth Streaming belum diperbarui selama lebih dari empat tahun. Sebaiknya migrasikan konten Anda untuk menggunakan protokol streaming DASH atau HLS agar terus menerima pembaruan performa dan dukungan untuk konten Anda.

Konten saya tidak menggunakan protokol HLS atau Smooth Stream, bagaimana pengaruhnya terhadap aplikasi saya?

Jika pustaka konten Anda tidak menggunakan salah satu protokol streaming tersebut, Anda tidak akan terpengaruh oleh migrasi. Anda tidak perlu melakukan perubahan apa pun pada aplikasi.