Migrasi HLS Di Shaka Player

Ringkasan

SDK Penerima Web Cast mendukung pemutaran konten menggunakan beberapa aplikasi web protokol streaming. Berdasarkan yang digunakan, SDK memuat pemutar untuk menangani pemutaran konten. Di kolom kasus konten HLS, Library Pemutar Media (MPL) akan dimuat. Dalam kasus Konten DASH, Shaka Player adalah dimuat.

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

Manfaat Shaka Player

Dalam perubahan pemain, aplikasi memanfaatkan manfaat berikut:

  • Sesi streaming yang lebih andal untuk pengguna, dengan peningkatan waktu pemuatan kegagalan dan latensi.
  • Terus mengadopsi fitur HLS terbaru.
  • Peningkatan kejelasan dalam analisis akar masalah untuk konten pemain masalah kompatibilitas karena sifat {i>open source<i} Shaka Player.
  • Dengan codebase pemutar open source, partner dapat berkontribusi pada Shaka Player Project.
  • Penurunan yang signifikan dalam waktu perbaikan fitur dan bug untuk produksi Rilis Shaka Player ritme sering dan tidak bergantung pada rilis Web Receiver SDK.
  • Kontrol yang lebih baik atas lingkungan pemutaran yang disediakan oleh API shakaVersion.
  • Meningkatkan dukungan pemutaran dari Google dengan sumber daya teknis yang berfokus pada pemutaran HLS di Shaka Player seperti yang terlihat peta jalan.

Linimasa

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

Fase Tanggal Mulai Ringkasan
1 Okt '22 Cast Web Receiver SDK memperkenalkan API untuk memilih ikut serta memutar konten HLS di Shaka Player.
2 S2 '24 Cast Web Receiver SDK mengubah pemutar default ke Shaka Player untuk pemutaran konten HLS.

Tim teknis Web Receiver SDK mengambil pendekatan berdasarkan performa dan baru melanjutkan ke fase berikutnya saat performa Shaka Player aktif setara dengan performa dasar MPL. Perubahan ini akan diumumkan di cast-sdk-announcements grup google dan diperbarui di panduan ini.

Ikut serta

Dimulai dengan versi CAF 3.0.0105, ada sebuah tingkat aplikasi konfigurasi untuk memilih ikut serta dalam menggunakan Shaka Player untuk pemutaran HLS. Versi ini juga memperkenalkan API untuk memilih dari serangkaian versi Shaka Player yang didukung yang akan dimuat. Tanda ini disediakan di bagian CastReceiverOptions melalui useShakaForHls dan shakaVersion dan dievaluasi saat CastReceiverContext akan dimulai. Aplikasi apa pun yang memilih Shaka untuk HLS harus menyetel versi Shaka Player minimal 4.3.4 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 kontennya di Shaka Player sebelum memilih untuk menggunakan Shaka Player dalam aplikasi produksinya. Sebaiknya lakukan pengujian untuk setiap variasi dalam konten Anda yang tercantum di bawah ini:

  • Jenis streaming: LIVE atau VOD
  • Format penampung: TS, MP4, atau streaming dasar
  • Konten dengan diskon atau iklan tersemat
  • Pemutaran di jenis perangkat berikut: layar smart, dongle Chromecast, Perangkat Android TV, TV yang dilengkapi Chromecast, smart speaker

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

Nonaktifkan

Web Receiver SDK akan bertransisi ke model pilihan tidak ikut untuk HLS Player Shaka pemutaran konten sesuai dengan linimasa. Properti useShakaForHls akan mengubah nilai defaultnya dari false hingga true. Pada saat itu, aplikasi dapat memilih untuk menggunakan MPL untuk HLS pemutaran dengan menyetel properti ini secara manual ke false. Jika CastReceiverContext dimulai, Web Receiver SDK akan dikembalikan ke pemuatan MPL, bukan Shaka Player. Lihat contoh di bawah untuk cara memilih tidak ikut menggunakan:

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

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

context.start(castReceiverOptions);

Laporkan masalah

Sebaiknya partner kami melaporkan masalah apa pun yang mereka temukan saat memutar HLS saat ini. Seperti yang telah disebutkan, MPL tidak akan lagi menerima update penting. Jika ada ditemukan masalah terkait MPL, ikuti langkah-langkah di bagian Ikut serta dalam panduan untuk memverifikasi apakah peralihan ke Shaka Player akan membuka blokir masalah performa. Ikuti langkah-langkah di bawah ini jika masalah masih ada atau jika Anda mengalami masalah yang berbeda saat beralih pemain.

  1. Coba tetapkan shakaVersion ke versi cabang yang berbeda untuk menyelesaikan masalah. Misalnya, jika masalah pengalaman di cabang 4.3, coba setel ke rilis terbaru di versi 4.2.x atau 3.3.x. Lihat rilis Shaka Player catatan untuk menemukan rilis dengan pembaruan yang paling relevan. Perhatikan bahwa shakaVersion API memiliki nilai minimum dan maksimum versi yang didukung sebagaimana dijelaskan dalam dokumentasi referensi. Jika Anda mengamati adanya regresi, laporkan masalah tersebut di Shaka Player issuetracker.

  2. Coba ubah parameter konfigurasi pemutar. Shaka Player adalah dapat dikonfigurasi melalui Objek PlayerConfiguration. Web Penerima SDK menentukan kumpulan nilai default dan memungkinkan aplikasi untuk ubah konfigurasi ini melalui Properti shakaConfig di PlaybackConfig . Ini dievaluasi selama waktu pemuatan ketika instance pemutar dibuat. Lihat lainnya di

    konfigurasi aplikasi dan lainnya. Default yang ditetapkan oleh Web Receiver SDK adalah nilai yang direkomendasikan.

  3. Lihat apakah masalah telah dilaporkan dalam issuetracker Shaka Player atau Transmisi issuetracker. Beri komentar pada bug dan tambahkan komentar yang relevan jika mendeskripsikan masalah Anda juga.

  4. Uji konten Anda di situs demo Sha Player. Jika Anda menemukan bahwa masalah itu muncul kembali di situs demo untuk konten Anda, kirimkan bug pada project Shaka Player.

  5. Laporkan bug di Pelacak Masalah Cast jika Anda memiliki masalah unik pada Shaka Player di endpoint cast.

FAQ

Mengubah pemain bisa menimbulkan banyak pertanyaan. Di bawah ini Anda akan menemukan menjawab pertanyaan umum untuk membantu memandu Anda melalui proses migrasi.

Haruskah saya bermigrasi ke Shaka Player?

Sebaiknya partner kami yang menggunakan konten HLS untuk memulai proses migrasi sebagai sesegera mungkin. Hasilnya, aplikasi Anda akan memberikan streaming yang lebih stabil pengalaman yang lebih baik bagi pengguna Anda. Manfaat lainnya diuraikan dalam Shaka Player manfaat dalam panduan ini. Mitra harus memverifikasi aplikasi mereka berfungsi dengan baik dengan Shaka Player untuk memastikan transisi. Beberapa aplikasi mungkin berisiko saat Web Receiver SDK transisi ke model penolakan jika partner tidak memverifikasi konten mereka dapat diputar dengan baik di Shaka Player sebelumnya.

Apa tingkat upaya yang diharapkan saat mengganti pemain?

Partner perlu menguji aplikasi dan konten mereka di lingkungan pengujian untuk memastikan pengalaman pengguna serupa atau lebih baik jika dibandingkan dengan HLS. Untuk melakukannya, partner harus ikut serta dalam fitur ini di internal dan menguji secara menyeluruh apakah konten mereka menggunakan Shaka Player. Lihat memvalidasi konten untuk mengetahui detail tentang aspek apa saja yang menjadi fokus konten Anda. Setelah divalidasi, partner harus tambahkan tanda untuk ikut serta dalam lingkungan aplikasi produksi mereka untuk memulai memanfaatkan keunggulan yang diberikan oleh Shaka Player. Secara umum, di sana adalah perubahan minimal pengembangan software dan sebagian besar persyaratan QA untuk partner Anda agar berhasil dimigrasikan.

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

Integrasi baru harus mengaktifkan Shaka Player untuk pemutaran. Nama aplikasi akan didukung dengan lebih baik dalam jangka panjang dan juga akan memerlukan manfaat dari fitur HLS baru dan peningkatan kinerja. Jika integrasi Anda mengalami masalah, laporkan bug sesegera mungkin untuk memberikan tim teknik untuk menyelesaikan masalah. Jika aplikasi Anda memiliki tenggat waktu yang ketat, sertakan informasi tersebut dalam laporan {i>bug<i} serta dampaknya untuk memberi prioritas sesuai. Tim teknik kami akan bekerja untuk memberikan solusi untuk mendukung pengguna Anda secara memadai.

Konten atau aplikasi saya tidak berfungsi dengan Shaka Player, bagaimana selanjutnya?

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

MPL tidak lagi menerima update penting, apa itu artinya?

Secara historis, MPL telah mengadopsi fitur HLS baru dan memperbaiki {i>bug<i} utama melalui pembaruan penting. Karena MPL tidak lagi menerimanya, HLS baru fitur tidak akan ditambahkan ke pemutar. Demikian juga, masalah apa pun yang dilaporkan untuk HLS pemutaran pada MPL tidak akan diperbaiki dalam MPL. Masalah ini harus diselesaikan paling lambat beralih ke Shaka Player untuk pemutaran. Jika masalah terus berlanjut, maka bug harus dilaporkan terkait masalah yang relevan yang dihadapi di Shaka Pemutar. Partner sebaiknya berhenti menggunakan MPL.

Konten saya menggunakan protokol Smooth Streaming. Bagaimana pengaruhnya terhadap aplikasi saya?

Biner MPL akan tetap dihosting dan dapat diakses oleh penerima Anda aplikasi. Namun, bug dan permintaan fitur terkait Smooth Streaming tidak akan didukung karena Spesifikasi Smooth Streaming belum diperbarui di selama empat tahun. Sebaiknya migrasikan konten Anda untuk menggunakan DASH atau HLS protokol streaming untuk terus menerima pembaruan kinerja 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 {i>streaming<i} tersebut, Anda tidak akan terpengaruh oleh migrasi. Tidak ada yang perlu diubah di aplikasi.

Sebelumnya
Fitur inti
Berikutnya
Menata Gaya Pemain