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

เมื่อกิจกรรมได้รับเมธอด Callback สำหรับวงจรของ onCreate() กิจกรรมควรทำตามขั้นตอนต่อไปนี้

สร้างและเริ่มต้นเซสชันสื่อ
ตั้งค่าการเรียกกลับของเซสชันสื่อ
ตั้งค่าตัวรับปุ่มสื่อของเซสชันสื่อเป็นค่าว่างเพื่อให้เหตุการณ์ปุ่มสื่อไม่รีสตาร์ทเพลเยอร์เมื่อมองไม่เห็น การดำเนินการนี้มีผลเฉพาะกับอุปกรณ์ Android 5.0 (API ระดับ 21) ขึ้นไป
สร้างและเริ่มต้นตัวควบคุมสื่อ

โค้ด onCreate() ด้านล่างแสดงขั้นตอนเหล่านี้

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

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 และเก่ากว่า ให้หยุดเพลเยอร์ใน onPause() callback
ใน Android เวอร์ชัน 7.0 ขึ้นไป ให้หยุดเพลเยอร์ใน onStop() callback

เมื่อกิจกรรมได้รับการเรียกกลับ onDestroy() ก็ควรปล่อยและล้างข้อมูลผู้เล่น