Merekam pemutaran video dan audio

Aplikasi dapat merekam video atau audio yang diputar dari aplikasi lain. Aplikasi tersebut harus menangani token MediaProjection dengan benar. Halaman ini menjelaskan caranya. Contoh ini juga menunjukkan cara admin perangkat menonaktifkan kemampuan untuk merekam snapshot layar, dan cara aplikasi audio dapat mencegah aplikasi lain merekam konten yang diputarnya.

Cara menangani token MediaProjection

MediaProjection API memungkinkan aplikasi memperoleh token MediaProjection yang memberinya akses satu kali untuk merekam konten layar atau audio. Android OS meminta izin pengguna sebelum memberikan token ke aplikasi Anda.

OS menampilkan token MediaProjection aktif di UI Setelan Cepat dan memungkinkan pengguna menarik akses ke token kapan saja. Jika hal ini terjadi, layar virtual atau streaming audio yang terkait dengan sesi akan berhenti menerima streaming media. Aplikasi Anda harus merespons dengan tepat. Jika tidak, aplikasi akan terus merekam keheningan audio atau streaming video hitam.

Untuk menangani hilangnya token, daftarkan callback pada instance MediaProjection menggunakan metode registerCallback, dan hentikan perekaman saat metode onStop dipanggil.

Untuk mengetahui informasi selengkapnya, lihat Proyeksi media.

Rekam video

Lihat aplikasi contoh ScreenCapture untuk mempelajari cara menggunakan Media Projection API untuk mengambil gambar layar perangkat secara real time dan menampilkannya di SurfaceView.

Anda dapat menggunakan DevicePolicyManager untuk mencegah perekaman layar. Untuk akun perusahaan (Android for Work), administrator dapat menonaktifkan pengumpulan data asisten untuk profil kerja menggunakan metode setScreenCaptureDisabled.

Codelab Mengelola Perangkat Android Tanpa Aplikasi menunjukkan cara melarang screenshot.

Merekam pemutaran audio

AudioPlaybackCapture API diperkenalkan di Android 10. API ini memberi aplikasi kemampuan untuk menyalin audio yang sedang diputar oleh aplikasi lain. Fitur ini adalah analog dari tangkapan layar, tetapi untuk audio. Kasus penggunaan utamanya adalah untuk aplikasi streaming yang ingin merekam audio yang diputar oleh game.

Perhatikan bahwa AudioPlaybackCapture API tidak memengaruhi latensi aplikasi yang audionya sedang direkam.

Membangun aplikasi perekaman

Untuk keamanan dan privasi, perekaman pemutaran memaksakan beberapa batasan. Untuk dapat merekam audio, aplikasi harus memenuhi persyaratan ini:

• Aplikasi harus memiliki izin RECORD_AUDIO.
• Aplikasi harus memunculkan perintah yang ditampilkan oleh MediaProjectionManager.createScreenCaptureIntent(), dan pengguna harus menyetujuinya.
• Aplikasi yang merekam dan memutar aplikasi harus dalam profil pengguna yang sama.

Untuk merekam audio dari aplikasi lain, aplikasi Anda harus membuat objek AudioRecord dan menambahkan AudioPlaybackCaptureConfiguration ke dalamnya. Ikuti langkah berikut:

1. Panggil AudioPlaybackCaptureConfiguration.Builder.build() untuk membuat AudioPlaybackCaptureConfiguration.
2. Teruskan konfigurasi ke AudioRecord dengan memanggil setAudioPlaybackCaptureConfig.

Mengontrol perekaman audio

Aplikasi Anda dapat mengontrol jenis konten yang dapat direkam, dan jenis aplikasi lain yang dapat merekam pemutarannya sendiri.

Membatasi perekaman dengan konten audio

Aplikasi dapat membatasi audio mana yang dapat direkam dengan menggunakan metode berikut:

• Teruskan AUDIO_USAGE ke AudioPlaybackCaptureConfiguration.addMatchingUsage() untuk mengizinkan perekaman penggunaan tertentu. Panggil metode ini beberapa kali untuk menentukan lebih dari satu penggunaan.
• Teruskan AUDIO_USAGE ke AudioPlaybackCaptureConfiguration.excludeUsage() untuk melarang perekaman penggunaan tersebut. Panggil metode ini beberapa kali untuk menentukan lebih dari satu penggunaan.
• Teruskan UID ke AudioPlaybackCaptureConfiguration.addMatchingUid() untuk hanya merekam aplikasi dengan UID tertentu. Panggil metode ini beberapa kali untuk menentukan lebih dari satu UID.
• Teruskan UID ke AudioPlaybackCaptureConfiguration.excludeUid() untuk melarang perekaman UID tersebut. Panggil metode ini beberapa kali untuk menentukan lebih dari satu UID.

Perhatikan bahwa Anda tidak dapat menggunakan metode addMatchingUsage() dan excludeUsage() secara bersamaan. Anda harus memilih satu atau yang lain. Demikian juga, Anda tidak dapat menggunakan addMatchingUid() dan excludeUid() secara bersamaan.

Membatasi perekaman oleh aplikasi lain

Anda dapat mengonfigurasi aplikasi untuk mencegah aplikasi lain merekam audionya. Audio yang berasal dari aplikasi hanya dapat direkam jika aplikasi memenuhi persyaratan berikut:

Penggunaan

Pemutar yang menghasilkan audio harus menetapkan penggunaannya ke USAGE_MEDIA, USAGE_GAME, atau USAGE_UNKNOWN.

Kebijakan perekaman

Kebijakan perekaman pemutar harus AudioAttributes.ALLOW_CAPTURE_BY_ALL, yang memungkinkan aplikasi lain merekam pemutaran. Ini dapat dilakukan dengan beberapa cara:

• Untuk mengaktifkan perekaman pada semua pemutar, sertakan android:allowAudioPlaybackCapture="true" dalam file manifest.xml aplikasi.
• Anda juga dapat mengaktifkan perekaman pada semua pemutar dengan memanggil AudioManager.setAllowedCapturePolicy(AudioAttributes.ALLOW_CAPTURE_BY_ALL).
• Anda dapat menetapkan kebijakan pada pemutar individu saat Anda mem-build-nya menggunakan AudioAttributes.Builder.setAllowedCapturePolicy(AudioAttributes.ALLOW_CAPTURE_BY_ALL). (Jika Anda menggunakan AAudio, panggil AAudioStreamBuilder_setAllowedCapturePolicy(AAUDIO_ALLOW_CAPTURE_BY_ALL).)

Jika prasyarat tersebut terpenuhi, audio apa pun yang diproduksi oleh pemutar dapat direkam.

Catatan: Kemampuan audio aplikasi untuk direkam juga bergantung pada targetSdkVersion aplikasi.

• Secara default, aplikasi yang menargetkan versi hingga dan termasuk Android 9.0 tidak mengizinkan perekaman pemutaran. Untuk mengaktifkannya, sertakan android:allowAudioPlaybackCapture="true" dalam file manifest.xml aplikasi.
• Secara default, aplikasi yang menargetkan Android 10 (API level 29) atau yang lebih tinggi memungkinkan audionya direkam. Untuk menonaktifkan perekaman pemutaran, sertakan android:allowAudioPlaybackCapture="false" dalam file manifest.xml aplikasi.

Menonaktifkan perekaman sistem

Perlindungan yang memungkinkan perekaman yang dijelaskan di atas hanya berlaku untuk aplikasi. Komponen sistem Android dapat merekam pemutaran secara default. Banyak dari komponen ini disesuaikan oleh vendor Android dan mendukung fitur seperti aksesibilitas dan penulisan teks. Oleh karena itu, sebaiknya aplikasi memungkinkan sistem merekam pemutarannya. Dalam kasus yang jarang terjadi, jika Anda tidak ingin sistem merekam pemutaran aplikasi, tetapkan kebijakan perekaman ke ALLOW_CAPTURE_BY_NONE.

Menetapkan kebijakan saat runtime

Anda dapat memanggil AudioManager.setAllowedCapturePolicy() untuk mengubah kebijakan perekaman saat aplikasi sedang berjalan. Jika MediaPlayer atau AudioTrack diputar saat Anda memanggil metode, audio tidak akan terpengaruh. Anda harus menutup dan membuka kembali pemutar atau melacak agar perubahan kebijakan berlaku.

Kebijakan = manifes + AudioManager + AudioAttributes

Karena kebijakan perekaman dapat ditentukan di beberapa tempat, penting untuk memahami cara menentukan kebijakan yang efektif. Kebijakan perekaman yang paling ketat selalu diterapkan. Misalnya, aplikasi yang manifesnya menyertakan setAllowedCapturePolicy="false" tidak akan pernah mengizinkan aplikasi non-sistem untuk merekam audionya, meskipun AudioManager#setAllowedCapturePolicy disetel ke ALLOW_CAPTURE_BY_ALL. Demikian pula, jika AudioManager#setAllowedCapturePolicy disetel ke ALLOW_CAPTURE_BY_ALL dan manifes menetapkan setAllowedCapturePolicy="true", tetapi AudioAttributes pemutar media dibuat dengan AudioAttributes.Builder#setAllowedCapturePolicy(ALLOW_CAPTURE_BY_SYSTEM), maka pemutar media ini tidak akan dapat direkam oleh aplikasi non-sistem.

Tabel di bawah meringkas efek atribut manifes dan kebijakan yang berlaku:

allowAudioPlaybackCapture	ALLOW_CAPTURE_BY_ALL	ALLOW_CAPTURE_BY_SYSTEM	ALLOW_CAPTURE_BY_NONE
true	aplikasi mana pun	hanya sistem	tidak ada perekaman
false	hanya sistem	hanya sistem	tidak ada perekaman