هنگامی که اکتیویتی متد برگشت فراخوانی چرخه حیات onCreate()
را دریافت می کند، باید این مراحل را انجام دهد:
- جلسه رسانه را ایجاد و مقداردهی اولیه کنید
- پاسخ تماس جلسه رسانه را تنظیم کنید
- گیرنده دکمه رسانه جلسه رسانه را روی تهی تنظیم کنید تا زمانی که رویداد دکمه رسانه پخش کننده قابل مشاهده نیست، پخش کننده را دوباره راه اندازی نکند. این فقط روی Android 5.0 (سطح API 21) و دستگاههای بالاتر تأثیر میگذارد.
- کنترلر رسانه را ایجاد و مقداردهی اولیه کنید
کد onCreate()
زیر این مراحل را نشان می دهد:
private lateinit var mediaSession: MediaSessionCompat
public override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// Create a MediaSessionCompat
mediaSession = MediaSessionCompat(this, LOG_TAG).apply {
// Enable callbacks from MediaButtons and TransportControls
setFlags(MediaSessionCompat.FLAG_HANDLES_MEDIA_BUTTONS or
MediaSessionCompat.FLAG_HANDLES_TRANSPORT_CONTROLS)
// Do not let MediaButtons restart the player when the app is not visible
setMediaButtonReceiver(null)
// Set an initial PlaybackState with ACTION_PLAY, so media buttons can start the player
val stateBuilder = PlaybackStateCompat.Builder()
.setActions(PlaybackStateCompat.ACTION_PLAY or PlaybackStateCompat.ACTION_PLAY_PAUSE)
setPlaybackState(stateBuilder.build())
// MySessionCallback has methods that handle callbacks from a media controller
setCallback(MySessionCallback())
}
// Create a MediaControllerCompat
MediaControllerCompat(this, mediaSession).also { mediaController ->
MediaControllerCompat.setMediaController(this, mediaController)
}
}
MediaSessionCompat mediaSession;
PlaybackStateCompat.Builder stateBuilder;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// Create a MediaSessionCompat
mediaSession = new MediaSessionCompat(this, LOG_TAG);
// Enable callbacks from MediaButtons and TransportControls
mediaSession.setFlags(
MediaSessionCompat.FLAG_HANDLES_MEDIA_BUTTONS |
MediaSessionCompat.FLAG_HANDLES_TRANSPORT_CONTROLS);
// Do not let MediaButtons restart the player when the app is not visible
mediaSession.setMediaButtonReceiver(null);
// Set an initial PlaybackState with ACTION_PLAY, so media buttons can start the player
stateBuilder = new PlaybackStateCompat.Builder()
.setActions(
PlaybackStateCompat.ACTION_PLAY |
PlaybackStateCompat.ACTION_PLAY_PAUSE);
mediaSession.setState(stateBuilder.build());
// MySessionCallback has methods that handle callbacks from a media controller
mediaSession.setCallback(new MySessionCallback());
// Create a MediaControllerCompat
MediaControllerCompat mediaController =
new MediaControllerCompat(this, mediaSession);
MediaControllerCompat.setMediaController(this, mediaController);
}
هنگامی که یک برنامه بسته میشود، اکتیویتی تماسهای onPause()
و onStop()
را پشت سر هم دریافت میکند. اگر بازیکن در حال بازی است، باید قبل از از بین رفتن فعالیت آن، آن را متوقف کنید. انتخاب اینکه از کدام پاسخ تماس استفاده کنید بستگی به نسخه اندرویدی دارد که در حال اجرا هستید.
در اندروید 6.0 (سطح API 23) و قبل از آن هیچ تضمینی برای فراخوانی onStop()
وجود ندارد. ممکن است 5 ثانیه پس از ناپدید شدن فعالیت شما تماس گرفته شود. بنابراین، در نسخههای اندرویدی زودتر از ۷.۰، برنامه شما باید پخش در onPause()
متوقف کند. در اندروید 7.0 و بالاتر، به محض اینکه فعالیت قابل مشاهده نباشد، سیستم onStop()
را فراخوانی می کند، بنابراین مشکلی نیست.
به طور خلاصه:
- در اندروید نسخه 6.0 و نسخه های قبلی، پخش کننده را در پاسخ به تماس
onPause()
متوقف کنید. - در اندروید نسخه 7.0 و بالاتر، پخش کننده را در پاسخ به تماس
onStop()
متوقف کنید.
هنگامی که اکتیویتی با فراخوانی onDestroy()
دریافت می کند، باید پخش کننده شما را آزاد کرده و پاکسازی کند.