בניית פעילות בנגן וידאו

כשהפעילות מקבלת את שיטת הקריאה החוזרת של מחזור החיים onCreate(), היא צריכה לבצע את השלבים הבאים:

• יצירה ואתחול של סשן המדיה
• הגדרת הקריאה החוזרת (callback) של סשן המדיה
• יש להגדיר את הערך של מקלט המדיה בסשן המדיה כ-null כדי שאירוע של לחצן מדיה לא יפעיל מחדש את הנגן כשהוא לא גלוי. הפעולה הזו משפיעה רק על Android 5.0 (רמת API 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);
}

כשאפליקציה נסגרת, הפעילות מקבלת ברצף את הקריאות החוזרות (callback) מסוג onPause() ו-onStop(). אם הנגן פועל, חייבים להפסיק אותו לפני שהפעילות שלו נעלמת. בחירת הקריאה החוזרת שבה להשתמש תלויה בגרסת Android שמותקנת במכשיר.

ב-Android 6.0 (רמת API 23) ובגרסאות קודמות, אי אפשר להבטיח מתי תתבצע קריאה ל-onStop(). ייתכן שהקריאה תופיע 5 שניות אחרי שהפעילות תיעלם. לכן, בגרסאות Android שקודמות לגרסה 7.0, האפליקציה צריכה להפסיק את הפעלת האפליקציה בonPause(). ב-Android 7.0 ואילך, המערכת קוראת ל-onStop() ברגע שהפעילות אינה גלויה, כך שזו לא בעיה.

לסיכום:

• בגרסה Android 6.0 ובגרסאות קודמות, צריך להפסיק את הנגן בקריאה חוזרת (callback) של onPause().
• ב-Android בגרסה 7.0 ואילך, צריך להפסיק את הנגן בקריאה חוזרת (callback) של onStop().

כשהפעילות מקבלת את הקריאה החוזרת של onDestroy(), היא צריכה לשחרר את הנגן ולנקות אותו.