ایجاد فعالیت پخش کننده ویدیو

هنگامی که اکتیویتی متد برگشت فراخوانی چرخه حیات 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() دریافت می کند، باید پخش کننده شما را آزاد کرده و پاکسازی کند.