כשהפעילות מקבלת את שיטת הקריאה החוזרת של מחזור החיים 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()
, היא צריכה לשחרר את הנגן ולנקות אותו.