إرشادات AEP: Media3

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

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

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

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

المنتجات التي تسري عليها الإرشادات

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

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

الإعفاءات

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

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

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

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