Panduan ini membahas API MediaCompat, yang tidak lagi diupdate. Sebaiknya gunakan library
Jetpack Media3 sebagai gantinya.
Membuat aktivitas pemutar video
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Saat menerima metode callback siklus proses onCreate()
, aktivitas harus melakukan langkah-langkah berikut:
- Membuat dan menginisialisasi sesi media
- Menetapkan callback sesi media
- Menetapkan penerima tombol media sesi media ke null sehingga peristiwa tombol media tidak akan memulai ulang pemutar jika tidak terlihat. Ini hanya memengaruhi perangkat Android 5.0 (API level 21) dan yang lebih tinggi.
- Membuat dan menginisialisasi pengontrol media
Kode onCreate()
di bawah ini menunjukkan langkah-langkah tersebut:
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);
}
Saat aplikasi ditutup, aktivitas akan menerima callback onPause()
dan onStop()
secara berurutan. Jika pemutar sedang memutar media, Anda harus menghentikannya sebelum aktivitasnya menghilang. Pilihan callback yang akan digunakan bergantung pada versi Android yang Anda jalankan.
Di Android 6.0 (API level 23) dan yang lebih lama, tidak ada jaminan kapan onStop()
akan dipanggil; panggilan dapat dilakukan 5 detik setelah aktivitas menghilang. Oleh karena itu, di Android versi sebelum 7.0, aplikasi Anda harus menghentikan pemutaran di onPause()
. Di Android 7.0 dan yang lebih baru, sistem akan memanggil onStop()
segera setelah aktivitas tidak terlihat, jadi hal ini tidak menjadi masalah.
Ringkasnya:
- Di Android versi 6.0 dan yang lebih lama, hentikan pemutar di callback
onPause()
.
- Di Android versi 7.0 dan yang lebih baru, hentikan pemutar di callback
onStop()
.
Saat menerima callback onDestroy()
, aktivitas harus melepas dan membersihkan pemutar.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-27 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-27 UTC."],[],[],null,["# Building a video player activity\n\nWhen the activity receives the `onCreate()` lifecycle callback method it should perform these steps:\n\n- Create and [initialize the media session](/guide/topics/media-apps/working-with-a-media-session#init-session)\n- Set the media session callback\n- Set the media session's media button receiver to null so that a [media button event](/guide/topics/media-apps/mediabuttons#restarting-inactive-mediasessions) won't restart the player when it is not visible. This only affects Android 5.0 (API level 21) and higher devices.\n- Create and initialize the media controller\n\nThe `onCreate()` code below demonstrates these steps: \n\n### Kotlin\n\n```kotlin\nprivate lateinit var mediaSession: MediaSessionCompat\n\npublic override fun onCreate(savedInstanceState: Bundle?) {\n super.onCreate(savedInstanceState)\n\n // Create a MediaSessionCompat\n mediaSession = MediaSessionCompat(this, LOG_TAG).apply {\n\n // Enable callbacks from MediaButtons and TransportControls\n setFlags(MediaSessionCompat.FLAG_HANDLES_MEDIA_BUTTONS or\n MediaSessionCompat.FLAG_HANDLES_TRANSPORT_CONTROLS)\n\n // Do not let MediaButtons restart the player when the app is not visible\n setMediaButtonReceiver(null)\n\n // Set an initial PlaybackState with ACTION_PLAY, so media buttons can start the player\n val stateBuilder = PlaybackStateCompat.Builder()\n .setActions(PlaybackStateCompat.ACTION_PLAY or PlaybackStateCompat.ACTION_PLAY_PAUSE)\n setPlaybackState(stateBuilder.build())\n\n // MySessionCallback has methods that handle callbacks from a media controller\n setCallback(MySessionCallback())\n }\n\n // Create a MediaControllerCompat\n MediaControllerCompat(this, mediaSession).also { mediaController -\u003e\n MediaControllerCompat.setMediaController(this, mediaController)\n }\n}\n```\n\n### Java\n\n```java\nMediaSessionCompat mediaSession;\nPlaybackStateCompat.Builder stateBuilder;\n\n@Override\npublic void onCreate(Bundle savedInstanceState) {\n super.onCreate(savedInstanceState);\n\n // Create a MediaSessionCompat\n mediaSession = new MediaSessionCompat(this, LOG_TAG);\n\n // Enable callbacks from MediaButtons and TransportControls\n mediaSession.setFlags(\n MediaSessionCompat.FLAG_HANDLES_MEDIA_BUTTONS |\n MediaSessionCompat.FLAG_HANDLES_TRANSPORT_CONTROLS);\n\n // Do not let MediaButtons restart the player when the app is not visible\n mediaSession.setMediaButtonReceiver(null);\n\n // Set an initial PlaybackState with ACTION_PLAY, so media buttons can start the player\n stateBuilder = new PlaybackStateCompat.Builder()\n .setActions(\n PlaybackStateCompat.ACTION_PLAY |\n PlaybackStateCompat.ACTION_PLAY_PAUSE);\n mediaSession.setState(stateBuilder.build());\n\n // MySessionCallback has methods that handle callbacks from a media controller\n mediaSession.setCallback(new MySessionCallback());\n\n // Create a MediaControllerCompat\n MediaControllerCompat mediaController =\n new MediaControllerCompat(this, mediaSession);\n\n MediaControllerCompat.setMediaController(this, mediaController);\n}\n```\n\nWhen an app is closed, the activity receives the `onPause()` and `onStop()` callbacks in succession. If the player is playing, you must stop it before its activity goes away. The choice of which callback to use depends on what Android version you're running.\n\nIn Android 6.0 (API level 23) and earlier there is no guarantee of when `onStop()` is called; it could get called 5 seconds after your activity disappears. Therefore, in Android versions earlier than 7.0, your app should stop playback in `onPause()`. In Android 7.0 and beyond, the system calls `onStop()` as soon as the activity becomes not visible, so this is not a problem.\n\nTo summarize:\n\n- In Android version 6.0 and earlier, stop the player in the `onPause()` callback.\n- In Android version 7.0 and later, stop the player in the `onStop()` callback.\n\nWhen the activity receives the `onDestroy()` callback, it should release and clean up your player."]]