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

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

• สร้างและเริ่มต้นเซสชันสื่อ
• ตั้งค่าการเรียกกลับของเซสชันสื่อ
• ตั้งค่าตัวรับปุ่มสื่อของเซสชันสื่อเป็นค่าว่างเพื่อให้เหตุการณ์ปุ่มสื่อไม่รีสตาร์ทเพลเยอร์เมื่อมองไม่เห็น การดำเนินการนี้มีผลเฉพาะกับอุปกรณ์ 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 และเก่ากว่า ให้หยุดเพลเยอร์ใน onPause() callback
• ใน Android เวอร์ชัน 7.0 ขึ้นไป ให้หยุดเพลเยอร์ใน onStop() callback

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