HLS در مورد مهاجرت بازیکنان Shaka

نمای کلی

Cast Web Receiver SDK از پخش محتوا با استفاده از چندین پروتکل پخش وب پشتیبانی می کند. بر اساس پروتکل استفاده شده، SDK یک پخش کننده را برای مدیریت بازپخش محتوا بارگیری می کند. در مورد محتوای HLS، کتابخانه Media Player ( MPL ) بارگیری می شود. در مورد محتوای DASH، Shaka Player بارگذاری می شود.

در حرکت رو به جلو، تیم‌های مهندسی Cast SDK و Shaka Player تلاش‌ها را برای افزایش پشتیبانی از پخش محتوای HLS در Shaka Player تجمیع می‌کنند. MPL دیگر به‌روزرسانی‌های مهم را دریافت نخواهد کرد . ما به شما توصیه می کنیم برای پخش محتوای HLS برنامه خود از Shaka Player استفاده کنید.

مزایای Shaka Player

در تغییر بازیکنان، برنامه ها از مزایای زیر بهره می برند:

• جلسات استریم قوی تر برای کاربران، با بهبود در خرابی زمان بارگذاری و تأخیر.
• ادامه پذیرش آخرین ویژگی های HLS.
• به دلیل ماهیت منبع باز Shaka Player ، وضوح افزایش یافته در تجزیه و تحلیل علت اصلی برای مشکلات سازگاری با محتوای پخش کننده.
• پایگاه کد پخش کننده منبع باز به شرکا اجازه می دهد تا در پروژه Shaka Player مشارکت کنند .
• کاهش قابل توجه ویژگی و زمان رفع اشکال تا تولید به عنوان آهنگ انتشار Shaka Player مکرر و مستقل از انتشار Web Receiver SDK است.
• کنترل بیشتر بر محیط پخش ارائه شده توسط shakaVersion API.
• افزایش پشتیبانی از پخش توسط Google با منابع مهندسی متمرکز بر پخش HLS در Shaka Player همانطور که در نقشه راه مشاهده می شود.

جدول زمانی

Web Receiver SDK به استفاده از Shaka Player به عنوان پخش کننده پیش فرض برای پخش محتوای HLS تغییر خواهد کرد. این کار در یک رویکرد مرحله‌ای برای هدایت شرکا در فرآیند مهاجرت انجام خواهد شد.

فاز	تاریخ شروع	نمای کلی
1	اکتبر 22	Cast Web Receiver SDK APIهایی را برای شرکت در پخش محتوای HLS در Shaka Player معرفی می کند .
2	H2 '24	Cast Web Receiver SDK پخش کننده پیش فرض را به Shaka Player برای پخش محتوای HLS تغییر می دهد .

تیم‌های مهندسی Web Receiver SDK رویکرد مبتنی بر عملکرد را در پیش گرفته‌اند و تنها زمانی به مرحله بعدی می‌روند که عملکرد Shaka Player با عملکرد پایه MPL برابری کند. این تغییرات در گروه گوگل cast-sdk-announcements اعلام می شود و در این راهنما به روز می شود.

انتخاب کنید

با شروع نسخه CAF 3.0.0105 ، یک پیکربندی سطح برنامه وجود دارد که می‌توانید از Shaka Player برای پخش HLS استفاده کنید. این نسخه همچنین یک API را برای انتخاب از میان طیف پشتیبانی شده از نسخه های Shaka Player برای بارگیری معرفی می کند. این پرچم‌ها در کلاس CastReceiverOptions از طریق ویژگی‌های useShakaForHls و shakaVersion ارائه می‌شوند و هنگام شروع CastReceiverContext ارزیابی می‌شوند. هر برنامه‌ای که Shaka for HLS را انتخاب می‌کند، باید نسخه Shaka Player را حداقل 4.3.4 تنظیم کند تا از آخرین پیشرفت‌های HLS استفاده کند. برای شرکت کردن، قطعه کد زیر را دنبال کنید:

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

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

context.start(castReceiverOptions);

توجه: پس از تنظیم، ویژگی shakaVersion نسخه Shaka Player را پین می‌کند. این مقدار پیش فرض تعریف شده توسط Web Receiver SDK را لغو می کند. توصیه می‌کنیم زمانی که نسخه پیش‌فرض Shaka Player بزرگ‌تر از نسخه‌ای است که تنظیم کرده‌اید، ویژگی shakaVersion حذف کنید. به این ترتیب برنامه شما با آخرین تغییرات Web Receiver SDK به روز می ماند. تغییرات نسخه پیش‌فرض Shaka Player در یادداشت‌های انتشار پست شده و از طریق گروه Google cast-sdk-announcements ارسال می‌شود.

اعتبارسنجی محتوا

شرکا باید قبل از انتخاب استفاده از Shaka Player در برنامه تولید خود، پخش محتوای خود را در Shaka Player تأیید کنند. توصیه می کنیم برای هر یک از تغییرات در محتوای خود که در زیر فهرست شده است آزمایش کنید:

• انواع جریان: LIVE یا VOD
• فرمت های کانتینر: TS، MP4 یا جریان های ابتدایی
• محتوای دارای ناپیوستگی یا تبلیغات جاسازی شده
• پخش در انواع دستگاه‌های زیر: نمایشگرهای هوشمند، دانگل‌های Chromecast، دستگاه‌های Android TV، تلویزیون‌های دارای Chromecast داخلی، بلندگوهای هوشمند

اگر خطا یا رفتار غیرمنتظره‌ای پیدا کردید، یک اشکال را ثبت کنید . هنگامی که بتوانید تأیید کنید که هیچ مشکلی در پخش محتوای شما وجود ندارد، تغییرات را به محیط تولید خود فشار دهید.

انصراف دهید

Web Receiver SDK به یک مدل انصراف برای پخش محتوای Shaka Player HLS مطابق جدول زمانی تغییر خواهد کرد. ویژگی useShakaForHls مقدار پیش فرض خود را از false به true تغییر می دهد. در آن زمان، برنامه ها می توانند با تنظیم دستی این ویژگی روی false ، استفاده از MPL را برای پخش HLS انتخاب کنند. هنگامی که CastReceiverContext شروع می شود، Web Receiver SDK به جای Shaka Player به بارگیری MPL باز می گردد. برای نحوه انصراف، نمونه زیر را ببینید:

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

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

context.start(castReceiverOptions);

مشکلات را گزارش کنید

ما شرکای خود را تشویق می کنیم تا مشکلاتی را که هنگام پخش محتوای HLS پیدا می کنند، ثبت کنند. همانطور که گفته شد، MPL دیگر به روز رسانی های حیاتی را دریافت نخواهد کرد. اگر با MPL با مشکلی مواجه شدید، مراحل موجود در بخش Opt in راهنما را دنبال کنید تا بررسی کنید که آیا تغییر به Shaka Player مشکل شما را رفع می‌کند یا خیر. اگر مشکل همچنان وجود دارد یا در هنگام تعویض بازیکن با مشکل دیگری مواجه شدید، مراحل زیر را دنبال کنید.

1. برای حل مشکل، shakaVersion روی یک نسخه شاخه دیگر تنظیم کنید. به عنوان مثال، اگر مشکل در شاخه 4.3 وجود دارد، سعی کنید آن را روی آخرین نسخه در نسخه های 4.2.x یا 3.3.x تنظیم کنید. یادداشت‌های انتشار Shaka Player را بررسی کنید تا نسخه‌هایی را با مرتبط‌ترین به‌روزرسانی‌ها پیدا کنید. توجه داشته باشید که shakaVersion API دارای حداقل و حداکثر نسخه پشتیبانی شده است که در مستندات مرجع توضیح داده شده است. اگر مشاهده کردید که یک رگرسیون وجود دارد، مشکل را در ردیاب مسئله Shaka Player گزارش دهید.

2. سعی کنید پارامترهای پیکربندی پخش کننده را تغییر دهید. Shaka Player از طریق شی PlayerConfiguration قابل تنظیم است. Web Receiver SDK مجموعه‌ای از مقادیر پیش‌فرض را تعریف می‌کند و برنامه‌ها را قادر می‌سازد تا این پیکربندی را از طریق ویژگی shakaConfig در شی PlaybackConfig تغییر دهند. این در زمان بارگذاری زمانی که نمونه پخش کننده ایجاد می شود ارزیابی می شود. مشاهده بیشتر در

   تنظیمات و گزینه های برنامه مقادیر پیش فرض تنظیم شده توسط Web Receiver SDK مقادیر توصیه شده هستند.

3. ببینید آیا مشکل در ردیاب صادرکننده Shaka Player یا ردیاب صادرکننده Cast گزارش شده است. در مورد اشکال نظر دهید و هر گونه اطلاعات مرتبط را در صورتی که مشکل شما را توضیح می دهد اضافه کنید.

4. محتوای خود را در سایت نمایشی Shaka Player تست کنید. اگر متوجه شدید که این مشکل در سایت نمایشی برای محتوای شما تکرار می شود، با پروژه Shaka Player یک اشکال ارسال کنید .

5. اگر مشکلی دارید که منحصر به فرد Shaka Player در نقاط پایانی Cast است ، یک اشکال در Cast Issue Tracker ثبت کنید .

سوالات متداول

تغییر بازیکنان می تواند سوالات زیادی را برانگیزد. در زیر متداول ترین سوالاتی را که پاسخ داده شده است را می بینید تا به شما در روند مهاجرت کمک کند.

آیا باید به Shaka Player مهاجرت کنم؟

ما شرکای خود را تشویق می کنیم که از محتوای HLS استفاده کنند تا در اسرع وقت فرآیند مهاجرت را آغاز کنند. در نتیجه، برنامه شما تجربه پخش جریانی قوی تری را برای کاربران شما فراهم می کند. مزایای بیشتر در بخش مزایای Shaka Player در این راهنما بیان شده است. شرکا باید تأیید کنند که برنامه‌هایشان با استفاده از Shaka Player به درستی کار می‌کنند تا از انتقال روان مطمئن شوند. در صورتی که شرکا قبل از موعد تأیید نکنند که محتوای آنها به درستی در Shaka Player پخش می شود، ممکن است برخی از برنامه ها در معرض خطر قرار گیرند SDK گیرنده وب به مدل انصراف.

میزان تلاش در هنگام تعویض بازیکن چقدر است؟

شرکا باید برنامه و محتوای خود را در یک محیط آزمایشی آزمایش کنند تا اطمینان حاصل کنند که تجربه کاربر در مقایسه با HLS مشابه یا بهبود یافته است. برای انجام این کار، شرکا باید این ویژگی را در یک محیط داخلی انتخاب کنند و به طور کامل آزمایش کنند که محتوای آنها می‌تواند با استفاده از Shaka Player پخش شود. برای جزئیات بیشتر در مورد جنبه هایی از محتوای خود که باید روی آن تمرکز کنید، به تأیید محتوا مراجعه کنید. پس از تأیید اعتبار، شرکا باید پرچم را برای شرکت در محیط برنامه تولید خود اضافه کنند تا از مزایای ارائه شده توسط Shaka Player استفاده کنند. در سطح بالا حداقل تغییرات توسعه نرم افزار و عمدتاً الزامات QA برای شرکای ما برای مهاجرت موفقیت آمیز وجود دارد.

برنامه من به زودی از HLS برای پخش محتوا استفاده می کند، چه کاری باید انجام دهم؟

ادغام های جدید باید از Shaka Player برای پخش استفاده کنند. برنامه شما در دراز مدت بهتر پشتیبانی می شود و همچنین از ویژگی های جدید HLS و بهبود عملکرد بهره خواهد برد. اگر ادغام جدید شما با مشکلاتی مواجه است، در اسرع وقت یک اشکال را ثبت کنید تا به تیم مهندسی زمان کافی برای حل مشکل داده شود. اگر برنامه شما دارای مهلت محدودی است، آن اطلاعات را در گزارش اشکال و همچنین تأثیر آن را برای اولویت بندی بر اساس آن لحاظ کنید. تیم مهندسی ما برای ارائه راه حلی برای حمایت کافی از کاربران شما کار خواهد کرد.

محتوا یا برنامه من با Shaka Player کار نمی کند، حالا چی؟

شما باید یک اشکال را با پروژه Shaka Player یا پروژه Cast ارسال کنید (به گزارش مشکلات مراجعه کنید). تیم مهندسی Cast SDK به طور فعال این ردیاب ها را زیر نظر دارد و برای حل و فصل مشکلات موجود با شما همکاری خواهد کرد. هر چه زودتر این مشکلات شناسایی شوند، زمان بیشتری برای رفع مشکل خواهند داشت.

MPL دیگر به‌روزرسانی‌های حیاتی را دریافت نمی‌کند، دقیقاً به چه معناست؟

از لحاظ تاریخی، MPL ویژگی‌های جدید HLS را پذیرفته و باگ‌های اصلی را از طریق به‌روزرسانی‌های حیاتی برطرف کرده است. اکنون که MPL دیگر آنها را دریافت نمی کند، ویژگی های جدید HLS به پخش کننده اضافه نخواهد شد. به همین ترتیب، هر گونه مشکل گزارش شده برای پخش HLS در MPL در MPL برطرف نخواهد شد. این مشکلات باید با جابجایی به Shaka Player برای پخش حل شود. اگر مشکلات همچنان ادامه داشت، باید باگ مربوط به مشکل(های) مربوطه در Shaka Player ثبت شود. شرکا باید از MPL استفاده نکنند.

محتوای من از پروتکل Smooth Streaming استفاده می کند، این چگونه بر برنامه من تأثیر می گذارد؟

باینری های MPL همچنان میزبان و قابل دسترسی برای برنامه گیرنده شما خواهند بود. با این حال، هرگونه درخواست ویژگی و رفع اشکال مربوط به Smooth Streaming پشتیبانی نخواهد شد زیرا مشخصات Smooth Streaming در بیش از چهار سال به‌روزرسانی نشده است. توصیه می‌کنیم محتوای خود را برای استفاده از پروتکل پخش جریانی DASH یا HLS برای ادامه دریافت به‌روزرسانی‌های عملکرد و پشتیبانی از محتوای خود منتقل کنید.

محتوای من از پروتکل های HLS یا Smooth Stream استفاده نمی کند، این چه تاثیری بر برنامه من دارد؟

اگر کتابخانه محتوای شما از هیچ یک از پروتکل‌های پخش جریانی استفاده نمی‌کند، تحت تأثیر این انتقال قرار نخواهید گرفت. هیچ تغییری در برنامه شما لازم نیست.