شروع به کار با «پخش‌کننده رسانه»

این سند مفاهیم پایه‌ای را معرفی می‌کند که باید قبل‌از کار با Media Player با آن‌ها آشنا باشید.

کلاس‌های صدا و ویدیو

کلاس‌های زیر صدا و ویدیو را در چارچوب Android پخش می‌کنند:

  • MediaPlayer: این کلاس میانای برنامه‌سازی کاربردی اصلی برای پخش صدا و ویدیو است.
  • AudioManager: این کلاس منابع صوتی و خروجی صوتی را در دستگاه مدیریت می‌کند.

اظهارنامه‌های مانیفست

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

  • اجازه اینترنت: اگر از MediaPlayer برای جاری‌سازی محتوای مبتنی بر شبکه استفاده می‌کنید، برنامه‌تان باید دسترسی به شبکه را درخواست کند.

    <uses-permission android:name="android.permission.INTERNET" />
    
  • اجازه قفل بیداری: اگر برنامه پخش‌کننده شما باید از کم شدن نور صفحه‌نمایش یا خوابیدن پردازنده جلوگیری کند، یا از روش‌های MediaPlayer.setScreenOnWhilePlaying(boolean) یا MediaPlayer.setWakeMode(android.content.Context, int) استفاده می‌کند، باید این اجازه را درخواست کنید.

    <uses-permission android:name="android.permission.WAKE_LOCK" />
    

استفاده از کلاس MediaPlayer

کلاس MediaPlayer مؤلفه ضروری چارچوب رسانه است. شیء این کلاس می‌تواند با حداقل راه‌اندازی، هم صدا و هم ویدیو را واکشی، رمزگشایی، و پخش کند. MediaPlayer از چندین منبع رسانه پشتیبانی می‌کند، ازجمله:

  • منابع محلی
  • URI داخلی، مثل موردی که ممکن است از Content Resolver دریافت کنید
  • نشانی‌های وب خارجی (جاری‌سازی)

برای مشاهده فهرست قالب‌های رسانه‌ای که Android پشتیبانی می‌کند، به صفحه قالب‌های رسانه‌ای پشتیبانی‌شده مراجعه کنید.

نمونه‌هایی از کار با منابع صوتی

در اینجا مثالی از نحوه پخش صدایی که به‌عنوان منبع خام محلی دردسترس است (ذخیره‌شده در دایرکتوری res/raw/ برنامه‌تان) آورده شده است:

کاتلین

var mediaPlayer = MediaPlayer.create(context, R.raw.sound_file_1)
mediaPlayer.start() // no need to call prepare(); create() does that for you

جاوا

MediaPlayer mediaPlayer = MediaPlayer.create(context, R.raw.sound_file_1);
mediaPlayer.start(); // no need to call prepare(); create() does that for you

در این مورد، منبع «خام» فایلی است که سیستم سعی نمی‌کند آن را به روش خاصی تجزیه کند. بااین‌حال، محتوای این منبع نباید صدای خام باشد. باید یک فایل رسانه‌ای با کدگذاری و قالب‌بندی مناسب در یکی از قالب‌های پشتیبانی‌شده باشد.

و در اینجا نحوه پخش از URI موجود به‌صورت محلی در سیستم (که مثلاً ازطریق Content Resolver به‌دست آورده‌اید) آمده است:

کاتلین

val myUri: Uri = .... // initialize Uri here
val mediaPlayer = MediaPlayer().apply {
    setAudioAttributes(
        AudioAttributes.Builder()
            .setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
            .setUsage(AudioAttributes.USAGE_MEDIA)
            .build()
    )
    setDataSource(applicationContext, myUri)
    prepare()
    start()
}

جاوا

Uri myUri = ....; // initialize Uri here
MediaPlayer mediaPlayer = new MediaPlayer();
mediaPlayer.setAudioAttributes(
    new AudioAttributes.Builder()
        .setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
        .setUsage(AudioAttributes.USAGE_MEDIA)
        .build()
);
mediaPlayer.setDataSource(getApplicationContext(), myUri);
mediaPlayer.prepare();
mediaPlayer.start();

پخش از نشانی وب راه دور بااستفاده از جاری‌سازی HTTP به‌صورت زیر است:

کاتلین

val url = "http://........" // your URL here
val mediaPlayer = MediaPlayer().apply {
    setAudioAttributes(
        AudioAttributes.Builder()
            .setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
            .setUsage(AudioAttributes.USAGE_MEDIA)
            .build()
    )
    setDataSource(url)
    prepare() // might take long! (for buffering, etc)
    start()
}

جاوا

String url = "http://........"; // your URL here
MediaPlayer mediaPlayer = new MediaPlayer();
mediaPlayer.setAudioAttributes(
    new AudioAttributes.Builder()
        .setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
        .setUsage(AudioAttributes.USAGE_MEDIA)
        .build()
);
mediaPlayer.setDataSource(url);
mediaPlayer.prepare(); // might take long! (for buffering, etc)
mediaPlayer.start();

برای بهبود عملکرد، از آماده‌سازی ناهمگام استفاده کنید

هنگام استفاده از MediaPlayer، عملکرد را درنظر داشته باشید. برای مثال، فراخوانی prepare() ممکن است زمان زیادی برای اجرا نیاز داشته باشد، زیرا ممکن است شامل واکشی و رمزگشایی داده‌های رسانه باشد. بنابراین، مانند هر روشی که ممکن است اجرای آن زمان زیادی ببرد، هرگز آن را از رشته میانای کاربر برنامه‌تان فراخوانی نکنید. انجام این کار باعث می‌شود میانای کاربر تا زمان بازگشت روش پاسخ ندهد، که این تجربه کاربری بدی است و می‌تواند باعث خطای ANR (برنامه پاسخ نمی‌دهد) شود.

برای جلوگیری از توقف رشته میانای کاربر، رشته دیگری را برای آماده‌سازی MediaPlayer ایجاد کنید و پس‌از اتمام کار به رشته اصلی اطلاع دهید. این چارچوب روشی راحت برای انجام دادن روش prepareAsync() برای انجام این کار ارائه می‌دهد. این روش آماده‌سازی رسانه را در پس‌زمینه شروع می‌کند و فوراً برمی‌گردد. وقتی آماده‌سازی رسانه تمام شد، روش onPrepared() MediaPlayer.OnPreparedListener، که ازطریق setOnPreparedListener() پیکربندی شده است، فراخوانی می‌شود.

بیشتر بدانید

Jetpack Media3 راه‌حل توصیه‌شده برای بازپخش رسانه در برنامه شما است. درباره آن بیشتر بخوانید.

این صفحه‌ها موضوعات مربوط به ضبط، ذخیره، و بازپخش صدا و ویدیو را پوشش می‌دهند: