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

نظرة عامة

تتيح حزمة Cast Web Receiver SDK تشغيل المحتوى باستخدام عدة بروتوكولات بث على الويب. استنادًا إلى البروتوكول المستخدَم، تحمّل حزمة SDK مشغّلاً للتعامل مع تشغيل المحتوى. في حالة محتوى البث المباشر وفق بروتوكول HTTP ‏(HLS)، يتم تحميل مكتبة Media Player Library (MPL). في حالة محتوى DASH، يتم تحميل Shaka Player.

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

مزايا Shaka Player

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

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

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

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

تتّبع فِرق هندسة حزمة Web Receiver SDK نهجًا يستند إلى الأداء، ولن تنتقل إلى المرحلة التالية إلا عندما يكون أداء Shaka Player على قدم المساواة مع الأداء الأساسي لمكتبة MPL. سيتم الإعلان عن هذه التغييرات في مجموعة cast-sdk-announcements على Google وسيتم تعديلها في هذا الدليل.

الموافقة

بدءًا من إصدار CAF 3.0.0105، هناك إعداد على مستوى التطبيق للموافقة على استخدام Shaka Player لتشغيل HLS. يقدّم هذا الإصدار أيضًا واجهة برمجة تطبيقات للاختيار من بين مجموعة متوافقة من إصدارات Shaka Player لتحميلها. يتم توفير هذه العلامات في فئة CastReceiverOptions من خلال السمتَين useShakaForHls و shakaVersion ويتم تقييمهما عند بدء CastReceiverContext. يجب على أي تطبيق يوافق على استخدام Shaka لتشغيل HLS ضبط إصدار Shaka Player على 4.15.35 على الأقل للاستفادة من أحدث تحسينات HLS. للموافقة، اتّبِع مقتطف الرمز البرمجي أدناه:

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

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

context.start(castReceiverOptions);

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

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

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

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

إيقاف

ستنتقل حزمة Web Receiver SDK إلى نموذج إيقاف عرض Shaka Player لتشغيل محتوى HLS وفقًا للمخطط الزمني. سيتم تغيير القيمة التلقائية للسمة useShakaForHls من false إلى true. في ذلك الوقت، يمكن للتطبيقات اختيار استخدام مكتبة MPL لتشغيل HLS من خلال ضبط هذه السمة يدويًا على false. عند بدء CastReceiverContext، ستعود حزمة Web Receiver 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.15، حاوِل ضبطه على أحدث إصدار في فرع آخر. اطّلِع على ملاحظات إصدار Shaka Player للعثور على الإصدارات التي تتضمّن أحدث التحديثات الأكثر صلة. يُرجى العِلم أنّ واجهة برمجة التطبيقات shakaVersion تتضمّن حدًا أدنى وأقصى للإصدار المتوافق كما هو موضّح بالتفصيل في المستندات المرجعية. إذا لاحظت حدوث تراجع، يُرجى الإبلاغ عن المشكلة في أداة تتبُّع المشاكل في Shaka Player issuetracker.
2. حاوِل تغيير مَعلمات إعداد المشغّل. يمكن إعداد Shaka Player من خلال عنصر PlayerConfiguration. تحدّد حزمة Web Receiver SDK مجموعة من القيم التلقائية وتتيح للتطبيقات تعديل هذا الإعداد من خلال shakaConfig السمة في PlaybackConfig العنصر. يتم تقييم ذلك أثناء مدّة التحميل عند إنشاء مثيل المشغّل. يمكنك الاطّلاع على مزيد من المعلومات في إعداد التطبيق و خياراته. القيم التلقائية التي تضبطها حزمة Web Receiver SDK هي القيم المقترَحة.
3. تحقَّق مما إذا تم الإبلاغ عن المشكلة في أداة تتبُّع المشاكل في Shaka Player أو أداة تتبُّع المشاكل في Cast. علِّق على الخطأ وأضِف أي معلومات ذات صلة إذا كانت تصف مشكلتك أيضًا.
4. اختبِر المحتوى على موقع Shaka Player التجريبي. إذا تبيّن لك أنّ المشكلة تتكرّر في الموقع التجريبي لمحتواك، يُرجى الإبلاغ عن خطأ في مشروع Shaka Player.
5. أبلِغ عن خطأ في أداة تتبُّع المشاكل في Cast إذا كانت لديك مشكلة فريدة في Shaka Player على نقاط نهاية البث.

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

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

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

ننصح شركاءنا الذين يستخدمون محتوى HLS ببدء عملية نقل البيانات في أقرب وقت ممكن. نتيجةً لذلك، سيقدّم تطبيقك تجربة بث أكثر فعالية للمستخدمين. تمت الإشارة إلى مزيد من المزايا في قسم مزايا Shaka Player في هذا الدليل. على الشركاء التحقّق من أنّ تطبيقاتهم تعمل بشكلٍ صحيح باستخدام Shaka Player لضمان الانتقال بسلاسة. قد تكون بعض التطبيقات معرّضة للخطر عندما تنتقل حزمة Web Receiver 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 Player. على الشركاء التوقف عن استخدام مكتبة MPL.

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

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

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

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