نقل بيانات مشغِّل HLS في Shaka

نظرة عامة

تدعم حزمة تطوير البرامج لجهاز استقبال الويب Cast تشغيل المحتوى باستخدام العديد من وبروتوكولات البث. استنادًا إلى المستخدم، تحمّل حزمة تطوير البرامج (SDK) مشغلاً لمعالجة تشغيل المحتوى. في جلسة المعمل، في حالة محتوى HLS، يتم تحميل مكتبة مشغّل الوسائط (MPL). في حالة محتوى DASH، وهو Shaka Player التحميل.

من الآن فصاعدًا، يعمل الفريقان الهندسيان لـ Cast SDK وShaka Player توحيد الجهود لإتاحة تشغيل محتوى بروتوكول HLS على Shaka لاعب. لن تتلقّى MPL بعد الآن التحديثات المهمة. ننصحك بتفعيل لاستخدام Shaka Player لتشغيل محتوى HLS في تطبيقك.

مزايا Shaka Player

عند تغيير اللاعبين، تستفيد التطبيقات من المزايا التالية:

• جلسات بث أكثر فعالية للمستخدمين، مع تحسينات في مدّة التحميل حالات الإخفاق ووقت الاستجابة.
• الاستمرار في استخدام أحدث ميزات بروتوكول HLS:
• زيادة الوضوح في تحليل السبب الأساسي لمحتوى المشغّل مشكلات التوافق بسبب طبيعة البرامج مفتوحة المصدر Shaka Player.
• تسمح قاعدة رموز المشغّلات المفتوحة المصدر للشركاء المساهمة في مشروع Shaka Player
• انخفاض كبير في وقت إصلاح الميزات وإصلاح الأخطاء في مرحلة الإنتاج إصدار شاكا Player معدّل الخطوات متكرر ومستقلة عن إصدارات "حزمة تطوير البرامج (SDK) الخاصة بـ WebRecipients".
• مزيد من التحكم في بيئة التشغيل من خلال shakaVersion API.
• دعم التشغيل بشكل أكبر من Google باستخدام الموارد الهندسية على تشغيل HLS في Shaka Player كما هو موضّح في خارطة الطريق.

المخطط الزمني

سيتم نقل حزمة "SDK لاستقبال الويب" إلى استخدام Shaka Player كمشغّل تلقائي لتشغيل محتوى HLS. وسيتم تنفيذ ذلك ضمن نهج تدريجي لتوجيه الشركاء من خلال عملية الترحيل.

المرحلة	Start Date	نظرة عامة
1	تشرين الأول (أكتوبر) 2022	تقدّم حزمة تطوير البرامج (SDK) لأداة استقبال الويب Cast واجهات برمجة تطبيقات للموافقة على تشغيل محتوى HLS على Shaka Player.
2	النصف الثاني من عام 2024	تعمل حزمة تطوير البرامج (SDK) لاستقبال الويب Cast على تغيير المشغّل التلقائي إلى Shaka Player لتشغيل محتوى HLS.

فِرق هندسة "حزمة تطوير البرامج (SDK) لـ WebRecipients" تعتمد نهجًا قائمًا على الأداء وستنتقل إلى المرحلة التالية فقط عند تفعيل أداء Shaka Player مستوى الأداء المتوقع لـ MPL. سيتم الإعلان عن هذه التغييرات في cast-sdk-announcements google group وتم تعديلها في هذا الدليل.

التفعيل

بدءًا من الإصدار 3.0.0105 من CAF، يتوفّر مستوى للتطبيق. الموافقة على استخدام Shaka Player لتشغيل HLS. هذا الإصدار توفّر أيضًا واجهة برمجة تطبيقات للاختيار من بين مجموعة من إصدارات Shaka Player المتوافقة للتحميل. تتوفر هذه العلامات في CastReceiverOptions من خلال useShakaForHls و سمات shakaVersion ويتم تقييمها عند تم بدء CastReceiverContext. أي تطبيق يوافق على Shaka لبروتوكول 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);

التحقّق من صحة المحتوى

يجب أن يتحقق الشركاء من صحة تشغيل المحتوى على Shaka Player قبل اختيار لاستخدام Shaka Player في تطبيق الإنتاج. وننصحك باختبار كل الاختلافات في المحتوى الواردة أدناه:

• أنواع البث: "بث مباشر" أو "فيديو عند الطلب"
• تنسيقات الحاويات: TS أو MP4 أو مجموعات البث الأولية
• محتوى يشتمل على انقطاعات أو إعلانات مُضمّنة
• التشغيل على أنواع الأجهزة التالية: الشاشات الذكية وأجهزة Chromecast الإلكترونية أجهزة Android TV، وأجهزة التلفزيون المزوّدة بتقنية Chromecast Built-in، ومكبّرات الصوت الذكية

في حال العثور على أي أخطاء أو سلوك غير متوقَّع، يمكنك الإبلاغ عن خطأ. بعد التحقق من عدم وجود إخفاقات خطيرة في التشغيل في المحتوى، ودفع التغييرات إلى بيئة الإنتاج.

إيقاف

سيتم نقل حزمة تطوير البرامج (SDK) لاستقبال الويب إلى نموذج إيقاف لبروتوكول Shaka Player HLS تشغيل المحتوى وفقًا للمخطط الزمني. الموقع سيتم تغيير قيمتها التلقائية بواسطة useShakaForHls من false إلى true في ذلك الوقت، يمكن للتطبيقات اختيار استخدام MPL لبروتوكول HLS التشغيل من خلال ضبط هذه السمة يدويًا على false. عندما تم بدء تشغيل "CastReceiverContext"، وستتم إعادة تحميل حزمة تطوير البرامج (SDK) الخاصة باستقبال الويب. MPL بدلاً من Shaka Player. يُرجى الاطّلاع على النموذج أدناه لمعرفة كيفية تنفيذ الإيقاف:

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

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

context.start(castReceiverOptions);

الإبلاغ عن المشاكل

نشجّع شركائنا على الإبلاغ عن أي مشاكل يعثرون عليها عند تشغيل HLS. المحتوى. كما ذكرنا، لن تتلقّى MPL أي تعديلات مهمة بعد الآن. إن توفّرت التي واجهتها في MPL، اتّبِع الخطوات الواردة في قسم الاشتراك للتأكد مما إذا كان التبديل إلى Shaka Player سيؤدي إلى إلغاء حظر المشكلة. اتّبِع الخطوات أدناه إذا كانت المشكلة لا تزال قائمة أو إذا واجهت مشكلة أخرى عند تبديل اللاعبين.

1. جرِّب ضبط shakaVersion على وإصدار فرعي مختلف لحل المشكلة. على سبيل المثال، إذا كانت المشكلة المستخدم في فرع 4.3، جرِّب ضبطه على أحدث إصدار في الإصدار 4.2.x أو 3.3.x. التحقّق من إصدار Shaka Player الملاحظات للعثور على الإصدارات التي تتضمن التحديثات الأكثر صلة. لاحظ أن تتضمن واجهة برمجة التطبيقات shakaVersion حدًّا أدنى وحدًا أقصى. معتمد كما هو مفصل في الوثائق المرجعية. إذا لاحظت أن هناك انحدارًا، فأبلغ عن المشكلة في Shaka Player أداة تتبّع المشاكل

2. حاوِل تغيير مَعلمات إعدادات المشغّل. Shaka Player هو قابلة للتهيئة من خلال PlayerConfiguration. الويب تُحدِّد حزمة تطوير البرامج (SDK) المستلِمة مجموعة من القيم التلقائية وتتيح للتطبيقات تعديل هذه التهيئة من خلال السمة shakaConfig في PlaybackConfig الخاص بك. ويتم تقييم ذلك أثناء وقت التحميل عندما يتم تشغيل مثيل المشغّل إنشاء. الاطّلاع على المزيد في

   تصميم التطبيق الخيارات. الإعداد التلقائي القيم التي تحددها حزمة SDK استلام الويب هي القيم الموصى بها.

3. معرفة ما إذا كان قد تم الإبلاغ عن المشكلة في أداة تتبُّع مشاكل Shaka Player أو البثّ أداة تتبُّع المشاكل التعليق على الخطأ وإضافة أي معلومات ذات صلة إذا كانت تصف مشكلتك أيضًا.

4. اختبِر المحتوى على موقع Shaka Player الإلكتروني التجريبي. إذا كنت أن تجد أن المشكلة تظهر في الموقع الإلكتروني التجريبي للمحتوى الخاص بك، يُرجى تقديم خطأ في مشروع Shaka Player.

5. يمكنك الإبلاغ عن الخطأ في "أداة تتبُّع مشاكل البثّ" إذا لديك مشكلة فريدة لـ Shaka Player على نقاط نهاية البث.

الأسئلة الشائعة

يمكن أن يؤدي تغيير اللاعبين إلى إثارة الكثير من الأسئلة. ستجد أدناه المزيد من الأسئلة الشائعة التي تمت الإجابة عنها للمساعدة في إرشادك خلال عملية النقل.

هل يجب نقل البيانات إلى Shaka Player؟

ننصح شركائنا الذين يستخدمون محتوى HLS ببدء عملية نقل البيانات. في أقرب وقت ممكن. نتيجةً لذلك، سيوفّر تطبيقك إمكانية بث أكثر فعالية تجربة المستخدم. تم توضيح المزيد من المزايا في Shaka Player المزايا في هذا الدليل. على الشركاء إثبات ملكيتهم بأن تطبيقاتهم تعمل بشكل صحيح باستخدام Shaka Player لضمان انتقالي. قد تكون بعض التطبيقات معرّضة للخطر عندما يتعلّق الأمر بحزمة تطوير البرامج (SDK) الخاصة باستقبال الويب. عمليات النقل إلى نموذج إيقاف مشاركة البيانات إذا لم يثبت الشركاء ملكيتهم للحساب تشغيل المحتوى بشكل صحيح على Shaka Player مسبقًا.

ما مستوى الجهد المتوقع عند تغيير اللاعبين؟

سيحتاج الشركاء إلى اختبار التطبيق والمحتوى في بيئة اختبار. للتأكّد من أنّ تجربة المستخدم مشابهة أو محسّنة عند مقارنتها بنظام HLS. لإجراء ذلك، يجب أن يفعّل الشركاء هذه الميزة من خلال بيئات داخلية واختبرت جيدًا إمكانية تشغيل المحتوى التابع لهم باستخدام Shaka Player. راجع التحقق من صحة المحتوى للحصول على تفاصيل حول الجوانب التي يجب التركيز عليها في المحتوى. بعد التحقّق من الصحة، على الشركاء تضيف العلامة للموافقة في بيئة تطبيقات الإنتاج لبدء الاستفادة من المزايا المقدمة من Shaka Player. على مستوى عالٍ هناك هي الحد الأدنى من التغييرات في تطوير البرامج ومتطلبات تأكيد الجودة الشركاء لنقل بياناتها بنجاح.

سيستخدم تطبيقي قريبًا بروتوكول HLS لبث المحتوى، ماذا يجب أن أفعل؟

يجب أن توافق عمليات الدمج الجديدة على استخدام Shaka Player للتشغيل. على نطاق أوسع على المدى الطويل، وسيستغرق الاستفادة من ميزات بروتوكول HLS الجديدة وتحسينات في الأداء. إذا لم يكن حدوث مشكلات، فعليك الإبلاغ عن الخطأ في أقرب وقت ممكن الفريق الهندسي وقتًا كافيًا لحل المشكلة. إذا كان تطبيقك يحتوي على موعد نهائي ضيق، فقم بتضمين هذه المعلومات في تقرير الخطأ بالإضافة إلى لتحديد الأولويات وفقًا لذلك. سيعمل فريقنا الهندسي على توفير حل لتقديم الدعم الكافي للمستخدمين

لا يعمل المحتوى أو التطبيق الخاص بي مع Shaka Player، فماذا يحدث الآن؟

يجب الإبلاغ عن الخطأ في مشروع Shaka Player أو مشروع Cast. (راجِع الإبلاغ عن المشاكل). ينشط الفريق الهندسي لحزمة تطوير البرامج (SDK) لتكنولوجيا Cast مراقبة أجهزة التتبع هذه وسوف نتعاون معك لحل أي مشاكل قائمة. كلما تم اكتشاف هذه المشكلات مبكرًا، استغرق الأمر وقتًا أطول وإصلاح المشكلة.

لم تعُد شركة MPL تستقبل تحديثات مهمة، ماذا يعني ذلك بالضبط؟

سابقًا، اعتمدت MPL ميزات جديدة لبروتوكول HLS وصححت الأخطاء الرئيسية من خلال والتحديثات المهمة. بعد أن ستتوقف MPL عن تلقّيها، ستتوفر بروتوكول HLS جديد لن تتم إضافة الميزات إلى المشغّل. وبالمثل، إذا تم الإبلاغ عن أي مشاكل في بروتوكول HLS، لن يتم تثبيت التشغيل على MPL في MPL. يجب حل هذه المشكلات بحلول التبديل إلى Shaka Player للتشغيل. في حالة استمرار المشكلات، يجب تقديم خطأ بالمشاكل ذات الصلة التي تواجه في Shaka لاعب. يجب على الشركاء التوقف عن استخدام MPL.

يستخدم المحتوى الخاص بي بروتوكول البث السلس، كيف يؤثر ذلك في تطبيقي؟

ستظلّ برامج MPL الثنائية مستضافة ويمكن لجهاز الاستقبال الوصول إليها. التطبيق. ومع ذلك، لن يتم عرض أي طلبات وميزات مرتبطة بميزة "البث السلس" إصلاحات الأخطاء لن يتم دعمها نظرًا لأن لم يتم تعديل مواصفات البث السلس في على مدار أربع سنوات. ننصحك بنقل المحتوى الخاص بك لاستخدام DASH أو HLS. البث لمواصلة تلقي تحديثات الأداء والدعم للمحتوى الخاص بك.

لا يستخدم المحتوى الخاص بي بروتوكولات HLS أو Smooth Stream، كيف يؤثر ذلك في تطبيقي؟

إذا لم تكن مكتبة المحتوى لديك تستخدم أيًّا من بروتوكولات البث هذه، فلن تتأثر بعملية نقل البيانات. لا يلزم إجراء أي تغييرات في التطبيق.