Migrasi HLS Di Shaka Player

Ringkasan

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

Ke depannya, tim teknik 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 ikut serta untuk menggunakan Shaka Player untuk pemutaran konten HLS aplikasi Anda.

Manfaat Shaka Player

Dengan mengubah pemutar, aplikasi akan mendapatkan manfaat berikut:

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

Linimasa

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

Tim teknik Web Receiver SDK mengambil 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 ikut serta menggunakan Shaka untuk HLS harus menetapkan versi Shaka Player minimal 4.15.55 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);

Validasi konten

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

• Jenis streaming: LIVE atau VOD
• Format container: TS, MP4, atau aliran data dasar
• Konten dengan diskontinuitas atau iklan tersemat
• 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, laporkan bug. Setelah Anda dapat memverifikasi bahwa tidak ada kegagalan pemutaran penting dalam konten Anda, kirim perubahan ke lingkungan produksi Anda.

Nonaktifkan

Web Receiver SDK akan beralih ke model nonaktifkan untuk pemutaran konten HLS Shaka Player sesuai dengan linimasa. 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 secara manual ke false. 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);

Melaporkan masalah

Sebaiknya partner kami melaporkan masalah apa pun yang mereka temukan saat memutar konten HLS. Seperti yang disebutkan, MPL tidak akan lagi menerima update penting. Jika Anda mengalami masalah dengan MPL, ikuti langkah-langkah di bagian Ikut serta dalam panduan ini 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 beralih pemutar.

1. Coba tetapkan shakaVersion ke versi cabang lain untuk mengatasi 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 the shakaVersion API memiliki versi minimum dan maksimum yang didukung seperti yang dijelaskan dalam dokumentasi referensi. Jika Anda melihat adanya regresi, laporkan masalah tersebut di issuetracker Shaka Player.
2. Coba ubah parameter konfigurasi pemutar. Shaka Player dapat dikonfigurasi melalui PlayerConfiguration objek. Web Receiver SDK menentukan serangkaian nilai default dan memungkinkan aplikasi untuk mengubah konfigurasi ini melalui properti shakaConfig dalam objek PlaybackConfig. Hal ini dievaluasi selama waktu pemuatan saat instance pemutar dibuat. Lihat konfigurasi dan opsi aplikasi untuk mengetahui informasi selengkapnya. Nilai default yang ditetapkan oleh Web Receiver SDK adalah nilai yang direkomendasikan.
3. Lihat apakah masalah telah dilaporkan di issuetracker Shaka Player atau issuetracker 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 direproduksi di situs demo untuk konten Anda, laporkan bug ke project Shaka Player.
5. Laporkan bug di Issue Tracker Cast jika Anda mengalami masalah yang khusus untuk Shaka Player di endpoint Cast.

FAQ

Mengubah pemutar dapat menimbulkan banyak pertanyaan. Di bawah, Anda akan menemukan jawaban atas pertanyaan yang paling umum untuk membantu memandu Anda melalui proses migrasi.

Haruskah saya bermigrasi ke Shaka Player?

Sebaiknya partner kami yang menggunakan konten HLS memulai proses migrasi sesegera mungkin. Dengan demikian, 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 Web Receiver SDK beralih ke model nonaktifkan jika partner tidak memverifikasi bahwa konten mereka diputar dengan benar di Shaka Player sebelumnya.

Berapa tingkat upaya yang diharapkan saat mengubah pemutar?

Partner harus menguji aplikasi dan konten mereka di lingkungan pengujian untuk memastikan pengalaman pengguna serupa atau ditingkatkan jika dibandingkan dengan HLS. Untuk melakukannya, partner harus ikut serta menggunakan 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 flag untuk ikut serta di lingkungan aplikasi produksi mereka agar mulai memanfaatkan manfaat yang disediakan oleh Shaka Player. Secara umum, ada perubahan pengembangan software minimal dan sebagian besar persyaratan QA agar partner kami berhasil bermigrasi.

Aplikasi saya akan segera menggunakan HLS untuk melakukan streaming konten, apa yang harus saya lakukan?

Integrasi baru harus ikut serta 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, laporkan bug sesegera mungkin agar tim teknik memiliki cukup waktu untuk mengatasi masalah tersebut. Jika aplikasi Anda memiliki batas waktu yang ketat, sertakan informasi tersebut dalam laporan bug serta dampaknya untuk memprioritaskan sesuai kebutuhan. Tim teknik kami akan berupaya memberikan solusi untuk mendukung pengguna Anda secara memadai.

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

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

MPL tidak lagi menerima update penting, apa artinya?

Secara historis, MPL telah mengadopsi fitur HLS baru dan menambal 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, a bug harus dilaporkan dengan masalah relevan yang dihadapi di Shaka Player. Partner harus berhenti 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, 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 update performa dan dukungan untuk konten Anda.

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

Jika library konten Anda tidak menggunakan salah satu protokol streaming tersebut, Anda tidak akan terpengaruh oleh migrasi. Tidak ada perubahan yang diperlukan di aplikasi Anda.