إنشاء نشاط لمشغّل فيديو

عندما يتلقّى النشاط طريقة الاستدعاء في إحدى مراحل النشاط onCreate()، يجب اتّباع الخطوات التالية:

• إنشاء جلسة الوسائط وبدؤها
• ضبط معاودة الاتصال بجلسة الوسائط
• اضبط مستقبِل زر الوسائط في جلسة الوسائط على "فارغ" لكي لا يؤدي حدث زر الوسائط إلى إعادة تشغيل المشغّل عندما لا يكون مرئيًا. يؤثر ذلك فقط في الأجهزة التي تعمل بنظام التشغيل Android 5.0 (المستوى 21 من واجهة برمجة التطبيقات) والإصدارات الأحدث.
• إنشاء وحدة التحكّم في الوسائط وإعدادها

يوضّح رمز onCreate() التالي هذه الخطوات:

Kotlin

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)
    }
}

Java

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() على التوالي. إذا كان المشغّل قيد التشغيل، يجب إيقافه قبل أن يختفي نشاطه. يعتمد اختيار دالة الاستدعاء التي يجب استخدامها على إصدار Android الذي تستخدمه.

في الإصدار 6.0 من نظام التشغيل Android (المستوى 23 من واجهة برمجة التطبيقات) والإصدارات الأقدم، لا يوجد ضمان لموعد استدعاء onStop()، فقد يتم استدعاؤه بعد 5 ثوانٍ من اختفاء نشاطك. لذلك، في إصدارات Android الأقدم من 7.0، يجب أن يتوقف تطبيقك عن التشغيل في onPause(). في الإصدار Android 7.0 والإصدارات الأحدث، يستدعي النظام onStop() بمجرد أن يصبح النشاط غير مرئي، لذا لا يمثل ذلك مشكلة.

باختصار:

• في الإصدار 6.0 من Android والإصدارات الأقدم، يمكنك إيقاف المشغّل في دالة الاستدعاء onPause().
• في الإصدار 7.0 من Android والإصدارات الأحدث، يمكنك إيقاف المشغّل في دالة الاستدعاء onStop().

عندما يتلقّى النشاط دالة الاستدعاء onDestroy()، يجب أن يحرّر المشغّل وينظّفه.