الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

لاعب شاكا

Shaka Player هي مكتبة جافا سكريبت مفتوحة المصدر للوسائط التكيفية. يقوم بتشغيل تنسيقات الوسائط التكيفية (مثل DASH وHLS وMSS) في المتصفح، دون استخدام المكونات الإضافية أو Flash. بدلاً من ذلك، يستخدم Shaka Player معايير الويب المفتوحة MediaSource Extensions وEncrypted Media Extensions.

يدعم Shaka Player أيضًا التخزين دون الاتصال بالإنترنت وتشغيل الوسائط باستخدام IndexedDB. يمكن تخزين المحتوى على أي متصفح. يعتمد تخزين التراخيص على دعم المتصفح.

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

للحصول على تفاصيل حول ما سيأتي بعد ذلك، راجع خريطة طريق التطوير الخاصة بنا.

فروع محفوظة

راجع "maintened-branches.md" للحصول على القائمة المحدثة للفروع التي تمت صيانتها لـ Shaka Player.

مصفوفة دعم النظام الأساسي والمتصفح

المتصفح ويندوز ماك لينكس أندرويد دائرة الرقابة الداخلية>= 9 دائرة الرقابة الداخلية>= 17.1 نظام تشغيل iPad >= 13 نظام التشغيل Chrome آخر
كروم¹ ي ي ي ي محلي محلي محلي ي -
فايرفوكس¹ ي ي ي غير مجرب⁵ محلي محلي محلي - -
الحافة¹ ي - - - - - - - -
حافة الكروم ي ي ي غير مجرب⁵ محلي محلي محلي - -
أي ن - - - - - - - -
سفاري¹ - ي - - محلي ي ي - -
الأوبرا¹ ي ي ي غير مجرب⁵ محلي - - - -
كروم كاست². - - - - - - - - ي
تلفزيون تايزن³ - - - - - - - - ي
ويب أو إس⁶ - - - - - - - - ي
هيسنس⁷ - - - - - - - - ي
اكس بوكس ​​​​واحد - - - - - - - - ي
بلاي ستيشن 4⁷ - - - - - - - - ي
بلاي ستيشن 5⁷ - - - - - - - - ي

ملحوظات:

  • ¹: على نظام التشغيل macOS، يتم دعم الإصدار Safari 9+ فقط. على نظام iOS، يتم دعم نظام التشغيل iOS 9+ فقط. سيتم رفض الإصدارات الأقدم.
  • ²: تم اختبار أحدث البرامج الثابتة لجهاز Chromecast. يمكن تنفيذ كل من المرسل والمستقبل باستخدام Shaka Player.
  • ³: تم اختبار نموذج Tizen 2017 ودعمه بشكل نشط من قبل فريق Shaka Player. نموذج Tizen 2016 مدعوم من المجتمع ولم يتم اختباره من قبلنا.
  • ⁵: من المتوقع أن تعمل هذه البرامج، ولكن لم يتم اختبارها بشكل فعال من قبل فريق Shaka Player.
  • ⁶: ​​من المتوقع أن تنجح هذه البرامج، ولكنها مدعومة من المجتمع ولم يتم اختبارها من قبلنا.
    • الدعم الرسمي لتلفزيون LG WebOS: #1330
  • ⁷: من المتوقع أن تنجح هذه البرامج، ولكنها مدعومة من المجتمع ولم يتم اختبارها من قبلنا.

ملاحظات لنظامي التشغيل iOS وiPadOS:

  • نحن ندعم نظام التشغيل iOS 9+ من خلال مشغل HLS الأصلي من Apple. نحن نقدم نفس واجهة برمجة التطبيقات ذات المستوى الأعلى، ولكننا قمنا فقط بتعيين عنصر src الخاص بالفيديو على البيان/الوسائط. لذلك نحن نعتمد على المتصفح الذي يدعم البيانات.
  • نظرًا لدعم iPadOS 13 MediaSource Extensions
  • نظرًا لدعم iPadOS 17 وiOS 17.1 ManagedMediaSource Extensions

مصفوفة دعم تنسيق البيان

شكل فيديو حسب الطلب يعيش حدث التسجيل قيد التقدم
داش ي ي - ي
HLS ي ي ي -
إم إس إس ي - - -

يمكنك أيضًا إنشاء مكون إضافي لمحلل البيان لدعم تنسيقات البيان المخصصة.

ميزات داش

ميزات DASH المدعومة:

  • تسجيلات VOD، والمباشرة، وقيد التنفيذ (محتوى VOD الديناميكي)
  • MPD@timeShiftBufferDepth للبحث عن الخلف في البث المباشر
  • محتوى متعدد الفترات (ثابت وديناميكي)
  • عناصر Xlink (التشغيل=onLoad فقط، الحل إلى الصفر، المحتوى الاحتياطي)
  • جميع أشكال معلومات فهرس الشريحة: SegmentBase@indexRange، SegmentTimeline، SegmentTemplate@duration، SegmentTemplate@index، SegmentList
  • بيانات الترميز المتعدد/الحاويات المتعددة (سنتفاوض بشأن الدعم مع المتصفح ونختار الأفضل منها)
  • المحتوى المشفر (بما في ذلك مخططات ContentProtection المخصصة، وPSSH في البيان)
  • دوران المفتاح
  • مسارات وضع الخدعة
  • WebVTT وTTML
  • CEA-608/708 التسميات التوضيحية
  • متغيرات برامج الترميز المتعددة (على الأنظمة الأساسية التي تدعم ChangeType)
  • تسلسل MPD
  • تحديثات تصحيح MPD لـ SegmentTemplate مع $الرقم$ ، الجزء الزمني مع $الرقم$ والخط الزمني للقطاع مع $الوقت$

ميزات DASH غير مدعومة:

  • Xlink with actuate=onRequest
  • بيانات بدون أي معلومات مقطعية: #1088
  • يتتبع وضع الخدعة المتعددة نفس الدقة بمعدلات إطارات أو معدلات بت مختلفة
  • المقاييس الزمنية كبيرة جدًا بحيث لا يمكن تمثيل الطوابع الزمنية كأعداد صحيحة في JavaScript (2^53): #1667
  • تعديل العناصر باستخدام سمة @schemeIdUri عبر MPD Patch
  • إلغاء مرجعية Xlink مع تصحيح MPD

مميزات اتش ال اس

ميزات HLS المدعومة:

  • أنواع VOD، Live، والأحداث
  • البث بزمن وصول منخفض مع مقاطع جزئية وتلميحات التحميل المسبق وتحديثات دلتا وحظر إعادة تحميل قائمة التشغيل
  • انقطاع
  • دعم ISO-BMFF/MP4/CMAF
  • دعم MPEG-2 TS
  • WebVTT وTTML
  • CEA-608/708 التسميات التوضيحية
  • المحتوى المشفر باستخدام PlayReady وWidevine
  • المحتوى المشفر باستخدام FairPlay (Safari على macOS وiOS 9+ فقط)
  • دعم AES-128 وAES-256 وAES-256-CTR على المتصفحات التي تدعم Web Crypto API
  • دعم SAMPLE-AES وSAMPLE-AES-CTR (الهوية) على المتصفحات التي تدعم ClearKey
  • دوران المفتاح
  • Raw AAC وMP3 وAC-3 وEC-3 (بدون حاوية MP4)
  • قوائم تشغيل I-frame فقط (للعب الخدع والصور المصغرة)
  • #EXT-X-IMAGE-STREAM-INF للصور المصغرة
  • الإعلانات البينية
  • تغيير الحاوية أثناء التشغيل (على سبيل المثال: MP4 إلى TS، أو AAC إلى TS)

ميزات HLS غير مدعومة:

  • سمة X-SNAP في الإعلانات البينية

علامات HLS المدعومة

للحصول على تفاصيل حول تنسيق HLS ومعاني هذه العلامات، راجع https://datatracker.ietf.org/doc/html/draft-pantos-hls-rfc8216bis

علامات قائمة التشغيل متعددة المتغيرات

  • #EXT-X-STREAM-INF:<attribute-list> <URI>
  • #EXT-X-MEDIA:<attribute-list>
  • #EXT-X-IMAGE-STREAM-INF:<attribute-list>
  • #EXT-XI-FRAME-STREAM-INF:<attribute-list>
  • #EXT-X-SESSION-DATA:<attribute-list>
  • #EXT-X-SESSION-KEY:<attribute-list> تحديد نظام مفاتيح EME والتحميل المسبق
  • #EXT-X-START:TIME-OFFSET=<n>
  • #EXT-X-CONTENT-STEERING:<attribute-list> توجيه المحتوى
  • #EXT-X-DEFINE:<attribute-list> استبدال المتغير (سمات NAME,VALUE,QUERYPARAM )

علامات قائمة تشغيل الوسائط

  • #EXTM3U
  • #EXTINF:<duration>,[<title>]
  • #EXT-X-PLAYLIST-TYPE:<type
  • #EXT-X-ENDLIST
  • #EXT-X-MEDIA-SEQUENCE=<n>
  • #EXT-X-TARGETDURATION=<n>
  • #EXT-X-DISCONTINUITY
  • #EXT-X-DISCONTINUITY-SEQUENCE=<n>
  • #EXT-X-BYTERANGE=<n>[@<o>]
  • #EXT-X-MAP:<attribute-list>
  • #EXT-X-KEY:<attribute-list> ( KEYFORMAT="identity",METHOD=SAMPLE-AES مدعوم فقط مع مقاطع MP4)
  • #EXT-X-PROGRAM-DATE-TIME:<attribute-list>
  • #EXT-X-START:TIME-OFFSET=<n>
  • #EXT-X-SERVER-CONTROL:<attribute-list>
  • #EXT-X-PART-INF:PART-TARGET=<n>
  • #EXT-X-PART:<attribute-list>
  • #EXT-X-SKIP:<attribute-list> قوائم تشغيل دلتا
  • #EXT-X-DATERANGE:<attribute-list> البيانات الوصفية
  • #EXT-X-DEFINE:<attribute-list> استيراد واستبدال المتغير (سمات NAME,VALUE,IMPORT,QUERYPARAM )
  • #EXT-X-GAP
  • #EXT-X-PRELOAD-HINT:<attribute-list>
  • #EXT-X-BITRATE

دعم MPEG-5 Part2 LCEVC

مدعوم فقط على المتصفحات التي تدعم ملحقات مصدر الوسائط SourceBuffer

  • دعم فك تشفير MPEG-5 Part2 LCEVC (يجب تضمين فك التشفير المقدم بواسطة lcevc_dec.js بشكل منفصل)

  • وثائق التكامل: مستندات

  • المزيد عن MPEG-5 Part2 LCEVC

مميزات إم إس إس

ميزات MSS المدعومة:

  • VOD
  • AAC وH.264
  • المحتوى المشفر (PlayReady)
  • تي تي إم إل/دفكسب
  • مدعوم فقط مع codem-isoboxer

ميزات MSS غير مدعومة:

  • يعيش

مصفوفة دعم إدارة الحقوق الرقمية

المتصفح ويديفين PlayReady اللعب العادل ClearKey⁶
كروم¹ ي - - ي
فايرفوكس² ي - - ي
الحافة³ - ي - -
حافة الكروم ي ي - ي
سفاري - - ي -
الأوبرا ي - - ي
كروم كاست ي ي - ي
تلفزيون تايزن ي ي - ي
ويب أو إس⁷ لم يتم اختباره⁷ لم يتم اختباره⁷ - لم يتم اختباره⁷
هيسنس⁷ لم يتم اختباره⁷ لم يتم اختباره⁷ - لم يتم اختباره⁷
اكس بوكس ​​​​واحد - ي - -
بلاي ستيشن 4⁷ - لم يتم اختباره⁷ - لم يتم اختباره⁷
بلاي ستيشن 5⁷ - لم يتم اختباره⁷ - لم يتم اختباره⁷

يجب أن تعمل أنظمة إدارة الحقوق الرقمية الأخرى خارج الصندوق إذا كانت قابلة للتشغيل البيني ومتوافقة مع مواصفات EME.

ملحوظات:

  • ¹: إصدارات Chrome الرسمية فقط هي التي تحتوي على Widevine CDM. لا يدعم Chromium المبني من المصدر إدارة الحقوق الرقمية (DRM).
  • ²: يجب تمكين إدارة الحقوق الرقمية (DRM) من قبل المستخدم. في المرة الأولى التي يزور فيها مستخدم Firefox موقعًا يحتوي على وسائط مشفرة، سيُطلب من المستخدم تمكين إدارة الحقوق الرقمية (DRM).
  • ³: يبدو أن PlayReady in Edge لا يعمل على جهاز افتراضي أو عبر سطح المكتب البعيد.
  • ⁶: ​​ClearKey هي أداة مفيدة لتصحيح الأخطاء، ولا توفر أمانًا فعليًا للمحتوى.
  • ⁷: من المتوقع أن تنجح هذه البرامج، ولكنها مدعومة من المجتمع ولم يتم اختبارها من قبلنا.
يظهر ويديفين PlayReady اللعب العادل كليركي
داش ي ي - ي
HLS ي ي ص ¹ -
إم إس إس - ي - -

ملحوظات:

  • ¹: افتراضيًا، يتم التعامل مع FairPlay باستخدام مشغل HLS الأصلي من Apple، عند استخدام Safari. ومع ذلك، فإننا ندعم FairPlay من خلال MSE/EME. راجع قيمة التكوين streaming.useNativeHlsForFairPlay .

حاوية الوسائط ودعم الترجمة

يدعم شاكا بلاير:

  • ISO-BMFF/CMAF/MP4
    • يعتمد على دعم المتصفح للحاوية عبر MediaSource
    • يمكن تحليل مربع "sidx" لـ DASH's SegmentBase@indexRange وSegmentTemplate@index
    • يمكن العثور على مربع "tfdt" وتحليله للعثور على وقت بدء المقطع في HLS
    • بالنسبة لـ MSS، مطلوب codem-isoboxer v0.3.7+
  • ويب إم
    • يعتمد على دعم المتصفح للحاوية عبر MediaSource
    • يمكن تحليل عناصر بيانات cueing لـ DASH's SegmentBase@indexRange وSegmentTemplate@index
    • غير مدعوم في HLS
  • MPEG-2 TS
    • يمكن تشغيلها على أي متصفح يدعم MP4
    • يمكن العثور على الطوابع الزمنية وتحليلها للعثور على وقت بدء المقطع في HLS
  • WebVTT
    • مدعوم في كل من النموذج النصي والمضمن في MP4
  • TTML
    • مدعوم في كل من نموذج XML ومضمن في MP4
  • سيا-608
    • مدعوم مضمن في MP4 وTS
  • سيا-708
    • مدعوم مضمن في MP4 وTS
  • AAC الخام
    • مدعوم في حاوية AAC الأولية والتحويل إلى AAC في حاوية MP4 (يعتمد على دعم المتصفح عبر MediaSource).
  • MP3 الخام
    • مدعوم في حاوية MP3 الأولية والتحويل إلى MP3 في حاوية MP4 (يعتمد على دعم المتصفح عبر MediaSource).
  • الخام AC-3
    • مدعوم في حاوية AC-3 الخام والتحويل إلى AC-3 في حاوية MP4 (يعتمد على دعم المتصفح عبر MediaSource).
  • الخام EC-3
    • مدعوم في حاوية EC-3 الأولية والتحويل إلى EC-3 في حاوية MP4 (يعتمد على دعم المتصفح عبر MediaSource).
  • سوبريب (SRT)
    • ترميز UTF-8 فقط
  • كلمات الأغاني (LRC)
    • ترميز UTF-8 فقط
  • المحطة الفرعية ألفا (SSA، ASS)
    • ترميز UTF-8 فقط
  • العارض الفرعي (SBV)
    • ترميز UTF-8 فقط

يتم عرض الترجمات بواسطة المتصفح بشكل افتراضي. يمكن للتطبيقات إنشاء مكون إضافي لعرض النص لعرض العملاء لتجاوز السمات التي يدعمها المتصفح.

دعم ناقل الحركة

يدعم شاكا بلاير:

  • AAC الخام إلى AAC في MP4
  • الخام MP3 إلى MP3 في MP4
  • الخام AC-3 إلى AC-3 في MP4
  • الخام EC-3 إلى EC-3 في MP4
  • AAC في MPEG-2 TS إلى AAC في MP4
  • AC-3 في MPEG-2 TS إلى AC-3 في MP4
  • EC-3 في MPEG-2 TS إلى EC-3 في MP4
  • MP3 في MPEG-2 TS إلى MP3 في MP4
  • MP3 في MPEG-2 TS إلى MP3 الخام
  • التأليف في MPEG-2 TS إلى MP3 في MP4
  • H.264 في MPEG-2 TS إلى H.264 في MP4
  • H.265 في MPEG-2 TS إلى H.265 في MP4
  • محتوى Muxed في MPEG-2 TS مع برامج الترميز السابقة

دعم الصور المصغرة

يدعم شاكا بلاير:

  • الصور المصغرة DASH الداخلية. استخدام مجموعة تعديل الصور DASH-IF IOP
  • الصور المصغرة HLS الداخلية. استخدام قائمة تشغيل وسائط الصور HLS
  • الصور المصغرة HLS الداخلية. استخدام قوائم التشغيل I-frame فقط مع برنامج الترميز mjpg
  • WebVTT خارجي مع الصور/النقوش المتحركة (فقط لـ VoD)

تحقيق الدخل من خلال الإعلانات

يدعم شاكا بلاير:

  • IMA SDK لإدراج الإعلانات من جانب العميل
  • IMA DAI SDK لإدراج الإعلانات على جانب الخادم
  • AWS MediaTailor من جانب العميل
  • AWS MediaTailor من جانب الخادم
  • تراكبات AWS MediaTailor
  • الإعلانات البينية لـ HLS
  • إدراج العرض التقديمي لوسائط DASH (بديل MPD)
  • الإعلانات البينية المخصصة
  • الدعم الأساسي لـ VAST وVMAP بدون IMA (التشغيل بدون تتبع)

دعم توجيه المحتوى

يدعم Shaka Player توجيه المحتوى (الإصدار 1) في DASH وHLS.

ميزات توجيه المحتوى المدعومة:

  • TTL، إذا كانت مفقودة، فإن القيمة الافتراضية هي 300 ثانية.
  • RELOAD-URI، إذا كان مفقودًا، نستخدم عنوان URL المقدم في البيان كبديل.
  • أولوية المسار هي استبدال المضيف فقط

ميزات توجيه المحتوى غير مدعومة:

  • PATHWAY-CLONES بدائل أخرى غير المضيف.

دعم الواقع الافتراضي

يدعم Shaka Player الواقع الافتراضي عندما:

  • يتم التعامل مع المحتوى تلقائيًا على أنه VR إذا كان يتوافق مع المعايير التالية:
    • بيان HLS أو DASH
    • قطاعات fMP4
    • يحتوي مقطع Init على مربعات prji و hfov
  • أو، إذا تم تمكينه يدويًا عبر تكوين واجهة المستخدم.

أوضاع الواقع الافتراضي المدعومة:

  • إسقاط متساوي المستطيلات مع مجال رؤية أفقي 360 درجة.
  • إسقاط Cubemap مع مجال رؤية أفقي 360 درجة.

ملحوظات:

  • يتم دعم VR فقط للتدفقات الواضحة أو دفق HLS-AES. يمنع DRM الوصول إلى وحدات بكسل الفيديو للتحويل.

الوثائق والروابط الهامة

  • العرض التوضيحي (المصادر)
  • عرض ليلي
  • مؤشر تجريبي
  • وثائق واجهة برمجة التطبيقات
  • دروس
  • الإصدارات المستضافة على مكتبات Google المستضافة
  • البناءات المستضافة على jsDelivr
  • خارطة طريق التنمية
  • قائمة الإعلانات (انضم للإعلانات والاستطلاعات النادرة)
  • اشترك في الإصدارات باتباع التعليمات الواردة في هذه المدونة

التعليمات

للحصول على مساعدة عامة وقبل تقديم أي أخطاء، يرجى قراءة الأسئلة الشائعة.

المساهمة

إذا كانت لديك تحسينات أو إصلاحات، فنحن نحب أن نحصل على مساهماتك. يرجى قراءة CONTRIBUTING.md لمزيد من المعلومات حول العملية التي نود من المساهمين اتباعها.

تكاملات الإطار

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

مكتبة شاكا + ReactJS

  • https://github.com/winoffrg/limeplay

تكاملات Shaka + ReactJS:

  • https://github.com/matvp91/shaka-player-react
  • https://github.com/amit08255/shaka-player-react-with-ui-config

التكامل شاكا + Next.js:

  • https://github.com/amit08255/shaka-player-react-with-ui-config/tree/master/nextjs-shaka-player

التكامل شاكا + Vue.js:

  • https://github.com/davidjamesherzog/shaka-player-vuejs

التكامل شاكا + Nuxt.js:

  • https://github.com/davidjamesherzog/shaka-player-nuxtjs

تكامل شاكا + video.js:

  • https://github.com/davidjamesherzog/videojs-shaka

شاكا + التكامل الزاوي:

  • https://github.com/PatrickKalkman/shaka-player-angular

إذا قمت بنشر كود/برامج تعليمية خاصة بـ Shaka Integration، فلا تتردد في إرسال العلاقات العامة لإضافتها إلى هذه القائمة، وسنوافق عليها بكل سرور!

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل