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

เมื่อกิจกรรมได้รับเมธอด 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() กิจกรรมควรจะปล่อยและทำความสะอาดโปรแกรมเล่นของคุณ