دستورالعمل AEP: رسانه ۳

کتابخانه Jetpack Media3 را به عنوان استانداردی برای پخش رسانه، جلسات، ویرایش، ابرداده و استخراج فریم ادغام کنید تا اطمینان حاصل شود که برنامه‌ها از APIهای توصیه‌شده برای مدیریت وظایف پیچیده رسانه‌ای در میان فرم‌فاکتورهای اندروید استفاده می‌کنند. مدرن‌سازی معماری رسانه با مهاجرت از APIهای چارچوب قدیمی (مانند MediaPlayer، MediaMuxer و MediaExtractor) به کتابخانه قدرتمند Jetpack Media3، یک جعبه ابزار یکپارچه و غنی از ویژگی‌ها را فراهم می‌کند که تجربیات رسانه‌ای سازگار را تضمین می‌کند.

پیاده‌سازی مورد نیاز

برای واجد شرایط بودن برای AEP، برنامه شما باید شرایط زیر را رعایت کند:

  • نباید از APIهای قدیمی چارچوب اندروید، از جمله MediaPlayer، MediaExtractor، MediaMuxer و MediaMetadataRetriever استفاده کند.
  • اگر پخش مجدد، بخش اصلی سفر کاربر باشد، برنامه باید جلسات رسانه‌ای را برای آگاهی از سیستم‌عامل و ادغام بین دستگاهی ادغام کند.
  • اگر برنامه دارای کتابخانه محتوای صوتی است، باید محتوا را از طریق MediaLibraryService در معرض نمایش قرار دهد و پشتیبانی از از سرگیری پخش رسانه را پیاده‌سازی کند.

کاربردپذیری دستورالعمل

این دستورالعمل در موارد زیر اعمال می‌شود:

  • برنامه‌هایی که از پخش رسانه (فیلم یا صدا) یا ویرایش ویدیو پشتیبانی می‌کنند.
  • برای تمام فرم فاکتورهایی که برنامه روی آنها موجود است.

معافیت‌ها

برنامه‌ها می‌توانند از یک چارچوب جایگزین معادل استفاده کنند که کیفیت، قابلیت‌های کاربری، پایداری و سازگاری مشابهی را در سراسر اکوسیستم ارائه می‌دهد. در صورت وجود چارچوب مناسب برای بررسی، با پشتیبانی تماس بگیرید . برای واجد شرایط بودن، پیاده‌سازی جایگزین باید معیارهای زیر را داشته باشد:

  • در یک شبکه پرسرعت، اولین فریم ویدیویی باید ظرف ۵۰۰ میلی‌ثانیه پس از شروع به کار کاربر نمایش داده شود.
  • پخش باید روان باشد، بدون هیچ افت فریم قابل مشاهده یا افت کیفیت صدا در طول یک پنجره 30 ثانیه‌ای.
  • برنامه باید به درستی فوکوس صوتی را مدیریت کند.
  • برنامه باید به کلیدهای رسانه‌ای سخت‌افزاری پاسخ دهد، حتی وقتی در پس‌زمینه اجرا می‌شود.
  • اگر پخش پس‌زمینه پشتیبانی شود، برنامه باید یک اعلان به سبک رسانه ارسال کند و از یک سرویس پیش‌زمینه استفاده کند.
  • اگر برنامه از قابلیت از سرگیری پخش پشتیبانی می‌کند، باید قابلیت از سرگیری رسانه را پیاده‌سازی کند.
  • قطع شدن هدفون باید به طور مناسب مدیریت شود. برای مثال، به جای رفتن به بلندگو، پخش را متوقف کنید.
  • هنگام تغییر جهت دستگاه، پخش باید بدون افت فریم ادامه یابد.

مستندات و منابع ویژه

منابع زیر راهنمایی‌های پیاده‌سازی و جزئیات فنی در مورد ویژگی Media3 را ارائه می‌دهند. این منابع فقط برای مرجع شما هستند و شامل الزامات برنامه اضافی نمی‌شوند.