راهنمای انتقال AndroidX Media3

برنامه‌هایی که درحال‌حاضر از کتابخانه مستقل com.google.android.exoplayer2 و androidx.media استفاده می‌کنند باید به androidx.media3 منتقل شوند. از اسکریپت انتقال برای انتقال فایل‌های ساخت gradle، فایل‌های منبع جاوا و Kotlin، و فایل‌های طرح‌بندی XML از ExoPlayer 2.19.1 به AndroidX Media3 1.1.1 استفاده کنید.

نمای کلی

قبل‌از انتقال، بخش‌های زیر را مرور کنید تا درباره مزایای میاناهای برنامه‌سازی کاربردی جدید، میاناهای برنامه‌سازی کاربردی برای انتقال، و پیش‌نیازهایی که پروژه برنامه‌تان باید داشته باشد بیشتر بدانید.

چرا باید به Jetpack Media3 مهاجرت کرد

• این خانه جدید ExoPlayer است، درحالی‌که com.google.android.exoplayer2 متوقف شده است.
• دسترسی به میانای برنامه‌سازی کاربردی Player در سراسر مؤلفه‌ها/فرایندها با MediaBrowser/MediaController.
• از قابلیت‌های گسترش‌یافته MediaSession و MediaController API استفاده کنید.
• قابلیت‌های بازپخش را با کنترل دسترسی دقیق تبلیغ کنید.
• با برداشتن MediaSessionConnector و PlayerNotificationManager، برنامه‌تان را ساده کنید.
• سازگار با نسخه قدیمی با میاناهای برنامه‌سازی کاربردی کارخواه media-compat (MediaBrowserCompat/MediaControllerCompat/MediaMetadataCompat)

میاناهای برنامه‌سازی کاربردی رسانه برای انتقال به AndroidX Media3

• ExoPlayer و افزونه‌های آن
  این شامل همه ماژول‌های پروژه ExoPlayer قدیمی به‌جز ماژول mediasession می‌شود که متوقف شده است. برنامه‌ها یا ماژول‌های وابسته به بسته‌ها در com.google.android.exoplayer2 را می‌توان با اسکریپت انتقال منتقل کرد.
• MediaSessionConnector (بسته به androidx.media.* بسته‌های androidx.media:media:1.4.3+)
  MediaSessionConnector را بردارید و درعوض از androidx.media3.session.MediaSession استفاده کنید.
• MediaBrowserServiceCompat (بسته به androidx.media.* بسته‌های androidx.media:media:1.4.3+)
  زیرکلاس‌های androidx.media.MediaBrowserServiceCompat را به androidx.media3.session.MediaLibraryService و کد بااستفاده از MediaBrowserCompat.MediaItem به androidx.media3.common.MediaItem منتقل کنید.
• MediaBrowserCompat (بسته به android.support.v4.media.* بسته‌های androidx.media:media:1.4.3+)
  کد مشتری را بااستفاده از MediaBrowserCompat یا MediaControllerCompat انتقال دهید تا از androidx.media3.session.MediaBrowser با androidx.media3.common.MediaItem استفاده کنید.

پیش‌نیازها

1. مطمئن شوید پروژه‌تان تحت کنترل منبع است

   مطمئن شوید که می‌توانید تغییرات اعمال‌شده توسط ابزارهای انتقال اسکریپت‌شده را برگردانید. اگر هنوز پروژه‌تان را تحت کنترل منبع قرار نداده‌اید، اکنون زمان خوبی برای شروع آن است. اگر به هر دلیلی نمی‌خواهید این کار را انجام دهید، قبل‌از شروع انتقال، یک نسخه پشتیبان از پروژه‌تان تهیه کنید.

2. به‌روزرسانی برنامه

   • توصیه می‌کنیم پروژه‌تان را به‌روز کنید تا از جدیدترین نسخه کتابخانه ExoPlayer استفاده کند و هرگونه فراخوانی به روش‌های منسوخ‌شده را بردارید. اگر قصد دارید از دستورگان برای انتقال استفاده کنید، باید نسخه‌ای را که به آن به‌روزرسانی می‌کنید با نسخه‌ای که توسط دستورگان مدیریت می‌شود مطابقت دهید.

   • compileSdkVersion برنامه‌تان را حداقل به ۳۲ افزایش دهید.

   • Gradle و افزایه Android Studio Gradle را به نسخه جدیدی ارتقا دهید که با وابستگی‌های به‌روزشده ذکرشده در بالا کار می‌کند. برای مثال:

     • نسخه افزایه Android Gradle: 7.1.0
     • نسخه Gradle: ‏ ۷.۴

   • همه عبارت‌های وارد کردن با نویسه عام را که از ستاره (*) استفاده می‌کنند جایگزین کنید و از عبارت‌های وارد کردن کاملاً واجدشرایط استفاده کنید: عبارت‌های وارد کردن با نویسه عام را حذف کنید و از Android Studio برای وارد کردن عبارت‌های کاملاً واجدشرایط استفاده کنید (F2 - Alt/Enter،‏ F2 - Alt/Enter،‏ ...).

   • از com.google.android.exoplayer2.PlayerView به com.google.android.exoplayer2.StyledPlayerView منتقل شوید. این کار ضروری است زیرا معادل com.google.android.exoplayer2.PlayerView در AndroidX Media3 وجود ندارد.

انتقال ExoPlayer با پشتیبانی از دستورگان

این دستورگان انتقال از com.google.android.exoplayer2 به ساختار جدید بسته و واحد را تحت androidx.media3 تسهیل می‌کند. این اسکریپت برخی بررسی‌های اعتبارسنجی را روی پروژه‌تان اعمال می‌کند و اگر اعتبارسنجی ناموفق باشد، هشدارهایی را چاپ می‌کند. درغیراین‌صورت، نگاشت‌های کلاس‌ها و بسته‌های تغییرنام‌یافته را در منابع پروژه gradle Android نوشته‌شده در Java یا Kotlin اعمال می‌کند.

usage: ./media3-migration.sh [-p|-c|-d|-v]|[-m|-l [-x <path>] [-f] PROJECT_ROOT]
 PROJECT_ROOT: path to your project root (location of 'gradlew')
 -p: list package mappings and then exit
 -c: list class mappings (precedence over package mappings) and then exit
 -d: list dependency mappings and then exit
 -l: list files that will be considered for rewrite and then exit
 -x: exclude the path from the list of file to be changed: 'app/src/test'
 -m: migrate packages, classes and dependencies to AndroidX Media3
 -f: force the action even when validation fails
 -v: print the exoplayer2/media3 version strings of this script
 -h, --help: show this help text

استفاده از دستورگان انتقال

1. اسکریپت انتقال را از برچسب پروژه ExoPlayer در GitHub که با نسخه‌ای که برنامه‌تان را به آن به‌روز کرده‌اید مطابقت دارد بارگیری کنید:

   curl -o media3-migration.sh \
     "https://raw.githubusercontent.com/google/ExoPlayer/r2.19.1/media3-migration.sh"
   

2. متن را قابل‌اجرا کنید:

   chmod 744 media3-migration.sh
   

3. برای آشنایی با گزینه‌ها، دستورات را با --help اجرا کنید.

4. اسکریپت را با -l اجرا کنید تا مجموعه فایل‌هایی را که برای انتقال انتخاب شده‌اند فهرست کنید (از -f برای اجبار فهرست‌بندی بدون هشدار استفاده کنید):

   ./media3-migration.sh -l -f /path/to/gradle/project/root
   

5. اسکریپت را با -m اجرا کنید تا بسته‌ها، کلاس‌ها، و مدول‌ها را به Media3 نگاشت کنید. اجرای اسکریپت با گزینه -m تغییرات را در فایل‌های انتخاب‌شده اعمال خواهد کرد.

   • توقف در خطای اعتبارسنجی بدون اعمال تغییرات

   ./media3-migration.sh -m /path/to/gradle/project/root
   

   • اجرای اجباری

   اگر اسکریپت نقض پیش‌نیازها را پیدا کند، انتقال می‌تواند با پرچم -f اجباری شود:

   ./media3-migration.sh -m -f /path/to/gradle/project/root
   

 # list files selected for migration when excluding paths
 ./media3-migration.sh -l -x "app/src/test/" -x "service/" /path/to/project/root
 # migrate the selected files
 ./media3-migration.sh -m -x "app/src/test/" -x "service/" /path/to/project/root

پس‌از اجرای اسکریپت با گزینه -m، این مراحل دستی را تکمیل کنید:

1. بررسی کنید که اسکریپت چگونه کد شما را تغییر داده است: از ابزار diff استفاده کنید و مشکلات احتمالی را برطرف کنید (اگر فکر می‌کنید اسکریپت مشکل کلی دارد که بدون گذراندن گزینه -f معرفی شده است، اشکال را ثبت کنید).
2. پروژه را بسازید: از ./gradlew clean build استفاده کنید یا در «استودیو Android» فایل > همگام‌سازی پروژه با فایل‌های Gradle، سپس ساختن > پاک کردن پروژه، و سپس ساختن > بازساختن پروژه را انتخاب کنید (ساختن خود را در برگه «ساختن - خروجی ساختن» در «استودیو Android» پایش کنید).

مراحل پیگیری توصیه‌شده:

1. موافقت کردن با خطاهای مربوط به استفاده از میاناهای برنامه‌سازی کاربردی ناپایدار را حل کنید.
2. جایگزین کردن فراخوانی‌های API منسوخ‌شده: از API جایگزین پیشنهادی استفاده کنید. اشاره‌گر را روی هشدار در «استودیو Android» نگه دارید و JavaDoc نماد منسوخ‌شده را بررسی کنید تا ببینید به‌جای تماس داده‌شده از چه چیزی باید استفاده کنید.
3. مرتب‌سازی دستورات وارد کردن: پروژه را در «استودیو Android» باز کنید، سپس روی گره پوشه بسته در نمایشگر پروژه کلیک راست کنید و بهینه‌سازی وارد کردن‌ها را در بسته‌هایی که حاوی فایل‌های منبع تغییریافته هستند انتخاب کنید.

MediaSessionConnector را با androidx.media3.session.MediaSession جایگزین کنید

در دنیای قدیمی MediaSessionCompat، MediaSessionConnector مسئول همگام‌سازی وضعیت پخش‌کننده با وضعیت جلسه و دریافت فرمان‌ها از کنترل‌کننده‌هایی بود که نیاز به واگذاری به روش‌های مناسب پخش‌کننده داشتند. با AndroidX Media3، این کار مستقیماً توسط MediaSession بدون نیاز به اتصال‌دهنده انجام می‌شود.

1. همه ارجاع‌ها و موارد استفاده از MediaSessionConnector را بردارید: اگر از دست‌نوشته خودکارشده برای انتقال کلاس‌ها و بسته‌های ExoPlayer استفاده کرده‌اید، احتمالاً دست‌نوشته کد شما را در وضعیت غیرقابل‌کامپایل کردن رها کرده است که نمی‌توان آن را حل کرد.MediaSessionConnector وقتی می‌خواهید برنامه را بسازید یا شروع کنید، Android Studio کد خراب را به شما نشان می‌دهد.

2. در فایل build.gradle که وابستگی‌هایتان را در آن نگهداری می‌کنید، یک وابستگی پیاده‌سازی به ماژول جلسه AndroidX Media3 اضافه کنید و وابستگی قدیمی را بردارید:

   implementation "androidx.media3:media3-session:1.11.1"
   

3. MediaSessionCompat را با androidx.media3.session.MediaSession جایگزین کنید.

4. در سایت کدی که MediaSessionCompat قدیمی را ایجاد کرده‌اید، از androidx.media3.session.MediaSession.Builder برای ساختن MediaSession استفاده کنید. پخش‌کننده را ارسال کنید تا سازنده جلسه ساخته شود.

   کاتلین

   val player = ExoPlayer.Builder(context).build()
   mediaSession = MediaSession.Builder(context, player).setCallback(MySessionCallback()).build()
   MigrationGuide.kt

   جاوا

   ExoPlayer player = new ExoPlayer.Builder(context).build();
   mediaSession =
       new MediaSession.Builder(context, player).setCallback(new MySessionCallback()).build();
   MigrationGuide.java

5. MySessionCallback را طبق نیاز برنامه‌تان پیاده‌سازی کنید. این کار اختیاری است. اگر می‌خواهید به کنترل‌کننده‌ها اجازه دهید فایل‌های رسانه‌ای را به پخش‌کننده اضافه کنند، MediaSession.Callback.onAddMediaItems() را پیاده‌سازی کنید. این میانای برنامه‌سازی کاربردی روش‌های مختلف فعلی و قدیمی را ارائه می‌دهد که فایل‌های رسانه‌ای را به پخش‌کننده اضافه می‌کنند تا به‌صورت سازگار با نسخه‌های قدیمی بازپخش شوند. این شامل روش‌های MediaController.set/addMediaItems() کنترل‌کننده Media3 و همچنین روش‌های TransportControls.prepareFrom*/playFrom* میانای برنامه‌سازی کاربردی قدیمی می‌شود. نمونه‌ای از پیاده‌سازی onAddMediaItems را می‌توانید در PlaybackService برنامه نمایشی جلسه پیدا کنید.

6. جلسه رسانه را در سایت کد که در آن جلسه را قبل‌از انتقال ازبین بردید، منتشر کنید:

   کاتلین

   mediaSession?.run {
     player.release()
     release()
     mediaSession = null
   }
   MigrationGuide.kt

   جاوا

   if (mediaSession != null) {
     mediaSession.getPlayer().release();
     mediaSession.release();
     mediaSession = null;
   }
   MigrationGuide.java

عملکرد MediaSessionConnector در Media3

جدول زیر میاناهای برنامه‌سازی کاربردی Media3 را نشان می‌دهد که عملکردی را که قبلاً در MediaSessionConnector پیاده‌سازی شده بود مدیریت می‌کنند.

انتقال MediaBrowserService به MediaLibraryService

AndroidX Media3 MediaLibraryService را معرفی می‌کند که جایگزین MediaBrowserServiceCompat می‌شود. JavaDoc مربوط به MediaLibraryService و کلاس فوق‌العاده آن MediaSessionService مقدمه خوبی برای API و مدل برنامه‌نویسی ناهمگام سرویس ارائه می‌دهد.

‫MediaLibraryService با MediaBrowserService سازگار با نسخه قدیمی است. برنامه کارخواهی که از MediaBrowserCompat یا MediaControllerCompat استفاده می‌کند، هنگام اتصال به MediaLibraryService بدون تغییر کد به کار خود ادامه می‌دهد. برای کارخواه، شفاف است که برنامه شما از MediaLibraryService استفاده می‌کند یا MediaBrowserServiceCompat قدیمی.

1. برای اینکه سازگاری با نسخه قدیمی کار کند، باید هر دو میانای سرویس را با سرویس خود در AndroidManifest.xml ثبت کنید. به‌این‌ترتیب، کارخواه سرویس شما را ازطریق میانای سرویس موردنیاز پیدا می‌کند:

   <service android:name=".MusicService" android:exported="true">
       <intent-filter>
           <action android:name="androidx.media3.session.MediaLibraryService"/>
           <action android:name="android.media.browse.MediaBrowserService" />
       </intent-filter>
   </service>
   

2. در فایل build.gradle که وابستگی‌هایتان را در آن نگهداری می‌کنید، یک وابستگی پیاده‌سازی به واحد جلسه AndroidX Media3 اضافه کنید و وابستگی قدیمی را بردارید:

   implementation "androidx.media3:media3-session:1.11.1"
   

3. سرویس خود را تغییر دهید تا به‌جای MediaBrowserServiceاز MediaLibraryService ارث‌بری کند. همان‌طور که قبلاً گفته شد، MediaLibraryService با MediaBrowserService قدیمی سازگار است. بنابراین، میانای برنامه‌سازی کاربردی گسترده‌تری که سرویس به کارخواهان ارائه می‌دهد همچنان یکسان است. بنابراین احتمالاً برنامه می‌تواند بیشتر منطق لازم برای پیاده‌سازی MediaBrowserService را حفظ کند و آن را برای MediaLibraryService جدید تطبیق دهد.

   تفاوت‌های اصلی در مقایسه با MediaBrowserServiceCompat قدیمی به شرح زیر است:

   • پیاده‌سازی روش‌های چرخه حیات سرویس: روش‌هایی که باید در خود سرویس لغو شوند عبارت‌اند از onCreate و onDestroy، که در آن‌ها برنامه جلسه کتابخانه، پخش‌کننده، و سایر منابع را اختصاص می‌دهد یا آزاد می‌کند. علاوه‌بر روش‌های استاندارد چرخه حیات سرویس، برنامه باید onGetSession(MediaSession.ControllerInfo) را لغو کند تا MediaLibrarySession ساخته‌شده در onCreate را برگرداند.

   • پیاده‌سازی MediaLibraryService.MediaLibrarySessionCallback: ساختن جلسه به MediaLibraryService.MediaLibrarySessionCallback نیاز دارد که روش‌های میانای برنامه‌سازی کاربردی دامنه واقعی را پیاده‌سازی می‌کند. بنابراین، به‌جای لغو کردن روش‌های میانای برنامه‌سازی کاربردی سرویس قدیمی، روش‌های MediaLibrarySession.Callback را لغو خواهید کرد.

     سپس از فراخوانی برگشتی برای ساختن MediaLibrarySession استفاده می‌شود:

     کاتلین

     mediaLibrarySession = MediaLibrarySession.Builder(context, player, MySessionCallback()).build()
     MigrationGuide.kt

     جاوا

     mediaLibrarySession =
         new MediaLibrarySession.Builder(context, player, new MySessionCallback()).build();
     MigrationGuide.java

     میانای برنامه‌سازی کاربردی کامل MediaLibrarySessionCallback را در اسناد میانای برنامه‌سازی کاربردی پیدا کنید.

   • MediaSession.Callback.onAddMediaItems() را پیاده‌سازی کنید: فراخوانی برگشتی onAddMediaItems(MediaSession, ControllerInfo, List<MediaItem>) به روش‌های مختلف میانای برنامه‌سازی کاربردی فعلی و قدیمی که فایل‌های رسانه‌ای را برای بازپخش به روش سازگار با نسخه قدیمی به پخش‌کننده اضافه می‌کنند، خدمات ارائه می‌دهد. این شامل روش‌های MediaController.set/addMediaItems() کنترل‌کننده Media3 و همچنین روش‌های TransportControls.prepareFrom*/playFrom* میانای برنامه‌سازی کاربردی قدیمی می‌شود. نمونه‌ای از پیاده‌سازی فراخوانی برگشتی را می‌توانید در PlaybackService برنامه نمایشی جلسه پیدا کنید.

   • AndroidX Media3 به‌جای MediaBrowserCompat.MediaItem و MediaMetadataCompat از androidx.media3.common.MediaItem استفاده می‌کند. بخش‌هایی از کد شما که به کلاس‌های قدیمی گره خورده است باید به‌طور مناسب تغییر کند یا به‌جای آن به Media3 MediaItem نگاشت شود.

   • مدل برنامه‌نویسی ناهمگام عمومی به Futures تغییر کرد، برخلاف رویکرد Result جداشدنی MediaBrowserServiceCompat. پیاده‌سازی سرویس شما می‌تواند به‌جای جدا کردن نتیجه، ListenableFuture ناهمگام برگرداند یا برای برگرداندن مستقیم مقدار، Future فوری برگرداند.

برداشتن PlayerNotificationManager

MediaLibraryService به‌طور خودکار از اعلان‌های رسانه پشتیبانی می‌کند و PlayerNotificationManager را می‌توان هنگام استفاده از MediaLibraryService یا MediaSessionService برداشت.

برنامه می‌تواند با تنظیم MediaNotification.Provider سفارشی در onCreate() که جایگزین DefaultMediaNotificationProvider می‌شود، اعلان را سفارشی‌سازی کند. سپس MediaLibraryService شروع سرویس را در پیش‌نما طبق نیاز انجام می‌دهد.

با لغو کردن MediaLibraryService.updateNotification()، برنامه می‌تواند مالکیت کامل پست کردن اعلان و شروع یا توقف سرویس در پیش‌نما را درصورت نیاز به‌دست آورد.

انتقال کد کارخواه بااستفاده از MediaBrowser

با AndroidX Media3، یک MediaBrowser میاناهای MediaController/Player را پیاده‌سازی می‌کند و می‌تواند برای کنترل بازپخش رسانه علاوه‌بر مرور کتابخانه رسانه استفاده شود. اگر مجبور بودید MediaBrowserCompat و MediaControllerCompat را در دنیای قدیمی ایجاد کنید، می‌توانید همین کار را فقط بااستفاده از MediaBrowser در Media3 انجام دهید.

می‌توان MediaBrowser را ساخت و منتظر برقراری اتصال به سرویس ماند:

scope.launch {
  val sessionToken = SessionToken(context, ComponentName(context, "MusicService"))
  browser =
    MediaBrowser.Builder(context, sessionToken)
      .setListener(BrowserListener())
      .buildAsync()
      .await()
}
MigrationGuide.kt

SessionToken sessionToken =
    new SessionToken(context, new ComponentName(context, "MusicService"));
ListenableFuture<MediaBrowser> browserFuture =
    new MediaBrowser.Builder(context, sessionToken)
        .setListener(new BrowserListener())
        .buildAsync();
MigrationGuide.java

برای آشنایی با نحوه ایجاد MediaController برای کنترل بازپخش در پس‌زمینه، به کنترل بازپخش در جلسه رسانه مراجعه کنید.

مراحل بعدی و پاک‌سازی

بخش‌های زیر نحوه رسیدگی به خطاهای lint میانای برنامه‌سازی کاربردی ناپایدار و میاناهای برنامه‌سازی کاربردی منسوخ‌شده را پس‌از تکمیل انتقال اولیه توضیح می‌دهند.

خطاهای میانای برنامه‌سازی کاربردی ناپایدار

پس‌از انتقال به Media3، ممکن است خطاهای lint درباره استفاده از میانای برنامه‌سازی کاربردی ناپایدار ببینید. استفاده از این میاناهای برنامه‌سازی کاربردی ایمن است و خطاهای lint محصول جانبی خط‌مشی جدید سازگاری دودویی ما است. اگر به سازگاری دودویی دقیق نیاز ندارید، این خطاها را می‌توان با حاشیه‌نویسی @OptIn به‌طور ایمن سرکوب کرد.

پس‌زمینه

هیچ‌کدام از نسخه‌های ۱ یا ۲ ExoPlayer سازگاری دودویی دقیقی برای کتابخانه بین نسخه‌های بعدی ارائه نمی‌دهند. سطح ExoPlayer API ازنظر طراحی بسیار بزرگ است تا برنامه‌ها بتوانند تقریباً همه جنبه‌های بازپخش را سفارشی‌سازی کنند. نسخه‌های بعدی ExoPlayer گاهی‌اوقات تغییر نام نمادها یا تغییرات مخرب دیگری را معرفی می‌کردند (مثلاً روش‌های جدید موردنیاز در رابط‌ها). در بیشتر موارد، این خرابی‌ها با معرفی نماد جدید در کنار منسوخ کردن نماد قدیمی برای چند نسخه کاهش یافت تا توسعه‌دهندگان زمان کافی برای انتقال کاربردهای خود داشته باشند، اما این کار همیشه ممکن نبود.

این تغییرات ناسازگار منجر به دو مشکل برای کاربران کتابخانه‌های ExoPlayer نسخه ۱ و ۲ شد:

1. ارتقا دادن به نسخه ExoPlayer می‌تواند باعث شود کد دیگر کامپایل نشود.
2. برنامه‌ای که هم به‌طور مستقیم و هم بااستفاده از کتابخانه واسطه به ExoPlayer وابسته بود، باید اطمینان حاصل می‌کرد که هر دو وابستگی از یک نسخه باشند، درغیراین‌صورت ناسازگاری‌های دودویی می‌توانست منجر به ازکارافتادن زمان اجرا شود.

بهبودهای Media3

Media3 سازگاری دودویی را برای زیرمجموعه‌ای از سطح میانای برنامه‌سازی کاربردی ارائه می‌دهد. بخش‌هایی که سازگاری دودویی ارائه نمی‌دهند با @UnstableApi علامت‌گذاری شده‌اند. برای شفاف‌سازی این تمایز، استفاده از نمادهای ناپایدار میانای برنامه‌سازی کاربردی خطای lint ایجاد می‌کند، مگراینکه با @OptIn حاشیه‌نویسی شده باشند.

پس‌از انتقال از ExoPlayer نسخه ۲ به Media3، ممکن است خطاهای lint زیادی در API ناپایدار مشاهده کنید. این ممکن است باعث شود Media3 «کم‌ثبات‌تر» از ExoPlayer v2 به‌نظر برسد. این‌طور نیست. بخش‌های «ناپایدار» Media3 API همان سطح پایداری را دارند که کل سطح ExoPlayer v2 API دارد، و سازگاری دودویی سطح Media3 API پایدار اصلاً در ExoPlayer v2 دردسترس نیست. تفاوت این است که اکنون خطای lint به شما درباره سطوح مختلف پایداری هشدار می‌دهد.

رسیدگی به خطاهای lint میانای برنامه‌سازی کاربردی ناپایدار

برای جزئیات بیشتر درباره نحوه حاشیه‌نویسی کاربردهای Java و Kotlin از میاناهای برنامه‌سازی کاربردی ناپایدار با @OptIn، به بخش عیب‌یابی مربوط به این خطاهای lint مراجعه کنید.

میاناهای برنامه‌سازی کاربردی منسوخ‌شده

ممکن است متوجه شوید که فراخوانی‌های میاناهای برنامه‌سازی کاربردی منسوخ‌شده در Android Studio خط‌خورده‌اند. توصیه می‌کنیم این فراخوانی‌ها را با جایگزین مناسب عوض کنید. نشانگر را روی نماد نگه دارید تا JavaDoc را ببینید که می‌گوید به‌جای آن از کدام API استفاده کنید.

نمونه‌های کد و برنامه‌های نمایشی

• برنامه نمایشی جلسه AndroidX Media3 (تلفن همراه و WearOS)
  • کنش‌های سفارشی
  • اعلان میانای کاربری سیستم، MediaButton/BT
  • کنترل بازپخش «دستیار Google»
• UAMP: Android Media Player (branch media3) (تلفن همراه، AutomotiveOS)
  • اعلان واسط کاربری سیستم، MediaButton/BT، ازسرگیری بازپخش
  • کنترل بازپخش «دستیار Google»/WearOS
  • AutomotiveOS: custom command and sign-in