การสร้างกิจกรรมโปรแกรมเล่นวิดีโอ

เมื่อกิจกรรมได้รับเมธอด Lifecycle Callback 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() ตามลำดับ หากเพลเยอร์กำลังเล่นอยู่ คุณต้องหยุดเล่นก่อนที่กิจกรรมจะหายไป การเลือก Callback ที่จะใช้ขึ้นอยู่กับเวอร์ชัน 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()

เมื่อกิจกรรมได้รับ Callback onDestroy() กิจกรรมควรปล่อยและล้างเพลเยอร์