إرشادات AEP: Media3

يمكنك دمج مكتبة Jetpack Media3 كمعيار لتشغيل الوسائط والجلسات والتعديل والبيانات الوصفية واستخراج اللقطات لضمان استخدام التطبيقات لواجهات برمجة التطبيقات المقترَحة للتعامل مع مهام الوسائط المعقّدة على جميع أشكال أجهزة Android. يؤدي تحديث بنية الوسائط من خلال نقل البيانات من واجهات برمجة التطبيقات القديمة (مثل MediaPlayer وMediaMuxer وMediaExtractor) إلى مكتبة Jetpack Media3 القوية إلى توفير مجموعة أدوات موحّدة وغنية بالميزات تضمن تقديم تجارب متسقة في مجال الوسائط.

عملية التنفيذ المطلوبة

للتأهّل لبرنامج AEP، يجب أن يلتزم تطبيقك بالمتطلبات التالية:

  • يجب عدم استخدام واجهات برمجة التطبيقات القديمة لإطار عمل Android، بما في ذلك MediaPlayer وMediaExtractor وMediaMuxer وMediaMetadataRetriever.
  • إذا كان التشغيل رحلة مستخدم أساسية، يجب أن يدمج التطبيق جلسات وسائط ليتمكّن نظام التشغيل من التعرّف عليها وليتم دمجها على جميع الأجهزة.
  • إذا كان التطبيق يتضمّن مكتبة محتوى صوتي، يجب أن يعرض المحتوى من خلال MediaLibraryService وأن يتيح إمكانية استئناف تشغيل الوسائط.

قابلية تطبيق الإرشادات

تنطبق هذه الإرشادات على ما يلي:

  • التطبيقات التي تتيح تشغيل الوسائط (الفيديو أو الصوت) أو تعديل الفيديو
  • جميع أشكال الأجهزة التي يتوفّر عليها التطبيق

الإعفاءات

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

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

مستندات الميزات والمراجع

تقدّم المراجع التالية إرشادات حول التنفيذ وتفاصيل فنية حول ميزة Media3. هذه المراجع مخصّصة للاطّلاع فقط ولا تتضمّن متطلبات إضافية للبرنامج.