Android मल्टीमीडिया फ़्रेमवर्क में, कॉन्टेंट को कैप्चर करने और उसे कोड में बदलने के लिए कई तरह की सामान्य सुविधाएं इस्तेमाल की जा सकती हैं
ऑडियो और वीडियो फ़ॉर्मैट में होता है. अगर MediaRecorder
एपीआई काम करता है, तो उसका इस्तेमाल किया जा सकता है
डिवाइस हार्डवेयर के हिसाब से.
इस दस्तावेज़ में, किसी डिवाइस से ऑडियो कैप्चर करने वाला ऐप्लिकेशन लिखने के लिए, MediaRecorder
का इस्तेमाल करने का तरीका बताया गया है
माइक्रोफ़ोन को ऐक्सेस करने के लिए, ऑडियो सेव करें, और इसे वापस चलाएं (MediaPlayer
के साथ). वीडियो रिकॉर्ड करने के लिए आपको इनकी ज़रूरत होगी
MediaRecorder
के साथ-साथ डिवाइस के कैमरे का इस्तेमाल करें. यह जानकारी कैमरा गाइड में दी गई है.
ध्यान दें: Android Emulator रिकॉर्ड नहीं कर सकता ऑडियो. पक्का करें कि आपके कोड की जांच, रिकॉर्ड करने वाले किसी असल डिवाइस पर की जा रही हो.
ऑडियो रिकॉर्ड करने के लिए अनुमति का अनुरोध किया जा रहा है
रिकॉर्ड करने के लिए, आपके ऐप्लिकेशन को उपयोगकर्ता को बताना होगा कि वह डिवाइस का ऑडियो इनपुट डालें. आपको ऐप्लिकेशन की मेनिफ़ेस्ट फ़ाइल में इस अनुमति टैग को शामिल करना होगा:
<uses-permission android:name="android.permission.RECORD_AUDIO" />
RECORD_AUDIO
को
"खतरनाक" अनुमति
क्योंकि इससे लोगों की निजता को खतरा हो सकता है. ऐप्लिकेशन को Android 6.0 (एपीआई लेवल 23) के साथ शुरू करना
जो खतरनाक अनुमति का इस्तेमाल करती है, उसे रन टाइम के समय उपयोगकर्ता से मंज़ूरी लेनी होगी. जब उपयोगकर्ता के पास ये चीज़ें हों
अनुमति नहीं दी है, तो ऐप्लिकेशन को याद रखना चाहिए और दोबारा नहीं पूछना चाहिए. नीचे दिया गया सैंपल कोड,
इसका इस्तेमाल करके इस व्यवहार को लागू करें
ActivityCompat.requestPermissions()
.
MediaRecorder बनाना और चलाना
MediaRecorder
का नया इंस्टेंस शुरू करें
ये कॉल किए जा सकते हैं:
- ऑडियो सोर्स सेट करने के लिए, इनका इस्तेमाल करें
setAudioSource()
. आपको शायदMIC
का इस्तेमाल करते हों.ध्यान दें: ज़्यादातर ऑडियो सोर्स (इसमें
DEFAULT
भी शामिल हैं) इस प्रोसेसिंग को प्रोसेस करते हैं: ऑडियो सिग्नल. रॉ ऑडियो रिकॉर्ड करने के लिए, इसे चुनेंUNPROCESSED
. कुछ डिवाइस प्रोसेस नहीं किए गए डिवाइसों पर काम नहीं करते इनपुट.AudioManager.getProperty(AudioManager.PROPERTY_SUPPORT_AUDIO_SOURCE_UNPROCESSED)
पर कॉल करके पुष्टि करें कि यह उपलब्ध है या नहीं. अगर ऐसा नहीं है, तोVOICE_RECOGNITION
का इस्तेमाल करके देखें, जो एजीसी या शोर को कम करने की सुविधा का इस्तेमाल नहीं करती है.UNPROCESSED
का इस्तेमाल किया जा सकता है प्रॉपर्टी के साथ काम न करने पर भी, ऑडियो सोर्स के तौर पर काम करता है. हालांकि, इस बात की कोई गारंटी नहीं है कि इस मामले में, सिग्नल को प्रोसेस नहीं किया जाएगा या नहीं. - आउटपुट फ़ाइल फ़ॉर्मैट को इसका इस्तेमाल करके सेट करें
setOutputFormat()
. ध्यान दें कि Android 8.0 (एपीआई लेवल 26) के साथ,MediaRecorder
में MPEG2_TS काम करता है फ़ॉर्मैट, जो स्ट्रीमिंग के लिए उपयोगी है:Kotlin
mediaRecorder.setOutputFormat(MediaRecorder.OutputFormat.MPEG_2_TS)
Java
mediaRecorder.setOutputFormat(MediaRecorder.OutputFormat.MPEG_2_TS);
- आउटपुट फ़ाइल का नाम सेट करने के लिए, इसका इस्तेमाल करें
setOutputFile()
. आपको ऐसा फ़ाइल डिस्क्रिप्टर तय करना होगा जो किसी असल फ़ाइल के बारे में बताता हो. - ऑडियो एन्कोडर को इनका इस्तेमाल करके सेट करें
setAudioEncoder()
. - कॉल करके शुरू करने की प्रक्रिया पूरी करें
prepare()
.
कॉल करके रिकॉर्डर को चालू और बंद करें
start()
और
stop()
क्रम से.
MediaRecorder
इंस्टेंस का काम पूरा हो जाने पर, इसके संसाधनों को खाली कर दें
कॉल करके जितनी जल्दी हो सके
release()
.
ध्यान दें: Android 9 (एपीआई लेवल 28) वाले डिवाइसों पर या
बाद में, बैकग्राउंड में चल रहे ऐप्लिकेशन माइक्रोफ़ोन को ऐक्सेस नहीं कर सकते. इसलिए,
आपके ऐप्लिकेशन को ऑडियो सिर्फ़ तब रिकॉर्ड करना चाहिए, जब वह फ़ोरग्राउंड में हो या
MediaRecorder
का एक इंस्टेंस शामिल करना
फ़ोरग्राउंड सेवा.
कई चैनल रिकॉर्ड करने के लिए MediaMuxer का इस्तेमाल करना
Android 8.0 (एपीआई लेवल 26) और इसके बाद के वर्शन में, MediaMuxer
का इस्तेमाल किया जा सकता है
एक साथ कई ऑडियो और वीडियो स्ट्रीम रिकॉर्ड करने के लिए. Android के पुराने वर्शन में आप सिर्फ़
एक बार में एक ऑडियो ट्रैक और/या एक वीडियो ट्रैक रिकॉर्ड करने की सुविधा मिलती है.
addTrack()
का इस्तेमाल करना
कई ट्रैक को एक साथ मिक्स करने का तरीका.
हर फ़्रेम के लिए अपनी पसंद की जानकारी के साथ, एक या एक से ज़्यादा मेटाडेटा ट्रैक भी जोड़े जा सकते हैं, लेकिन सिर्फ़ MP4 कंटेनर के लिए. आपका ऐप्लिकेशन, मेटाडेटा के फ़ॉर्मैट और कॉन्टेंट के बारे में बताता है.
मेटाडेटा जोड़ना
मेटाडेटा, ऑफ़लाइन प्रोसेसिंग के लिए काम का हो सकता है. उदाहरण के लिए, वीडियो स्टेबलाइज़ेशन के लिए जाइरो सेंसर का इस्तेमाल किया जा सकता है.
मेटाडेटा ट्रैक जोड़ते समय, ट्रैक के MIME फ़ॉर्मैट को प्रीफ़िक्स से शुरू होना चाहिए
application/
. मेटाडेटा लिखना, वीडियो या ऑडियो डेटा लिखने जैसा ही होता है. हालांकि, इसमें बदलाव नहीं किया जा सकता
यह जानकारी कि डेटा MediaCodec
से नहीं मिला है. इसके बजाय, ऐप्लिकेशन
ByteBuffer
writeSampleData()
तरीका.
यह टाइमस्टैंप, वीडियो और ऑडियो ट्रैक के टाइम बेस में होना चाहिए.
जनरेट की गई MP4 फ़ाइल, सेक्शन 12.3.3.2 में बताए गए TextMetaDataSampleEntry
का इस्तेमाल करती है
आईएसओ बीएमएफ़एफ़ स्पेसिफ़िकेशन के हिसाब से
माइम फ़ॉर्मैट के बारे में बताने के लिए. जब मेटाडेटा ट्रैक वाली किसी फ़ाइल को एक्सट्रैक्ट करने के लिए MediaExtractor
का इस्तेमाल किया जाता है, तो मेटाडेटा का माइम
फ़ॉर्मैट, MediaFormat
के इंस्टेंस के तौर पर दिखता है.
नमूना कोड
MediaRecorder सैंपल में MediaRecorder और Camera API का इस्तेमाल करके वीडियो रिकॉर्डिंग करने का तरीका बताया गया है.
नीचे दी गई गतिविधि के उदाहरण में, ऑडियो फ़ाइल रिकॉर्ड करने के लिए MediaRecorder
का इस्तेमाल करने का तरीका बताया गया है. यह
ऑडियो को चलाने के लिए MediaPlayer
का भी इस्तेमाल करता है.
Kotlin
package com.android.audiorecordtest import android.Manifest import android.content.Context import android.content.pm.PackageManager import android.media.MediaPlayer import android.media.MediaRecorder import android.os.Bundle import android.support.v4.app.ActivityCompat import android.support.v7.app.AppCompatActivity import android.util.Log import android.view.View.OnClickListener import android.view.ViewGroup import android.widget.Button import android.widget.LinearLayout import java.io.IOException private const val LOG_TAG = "AudioRecordTest" private const val REQUEST_RECORD_AUDIO_PERMISSION = 200 class AudioRecordTest : AppCompatActivity() { private var fileName: String = "" private var recordButton: RecordButton? = null private var recorder: MediaRecorder? = null private var playButton: PlayButton? = null private var player: MediaPlayer? = null // Requesting permission to RECORD_AUDIO private var permissionToRecordAccepted = false private var permissions: Array<String> = arrayOf(Manifest.permission.RECORD_AUDIO) override fun onRequestPermissionsResult( requestCode: Int, permissions: Array<String>, grantResults: IntArray ) { super.onRequestPermissionsResult(requestCode, permissions, grantResults) permissionToRecordAccepted = if (requestCode == REQUEST_RECORD_AUDIO_PERMISSION) { grantResults[0] == PackageManager.PERMISSION_GRANTED } else { false } if (!permissionToRecordAccepted) finish() } private fun onRecord(start: Boolean) = if (start) { startRecording() } else { stopRecording() } private fun onPlay(start: Boolean) = if (start) { startPlaying() } else { stopPlaying() } private fun startPlaying() { player = MediaPlayer().apply { try { setDataSource(fileName) prepare() start() } catch (e: IOException) { Log.e(LOG_TAG, "prepare() failed") } } } private fun stopPlaying() { player?.release() player = null } private fun startRecording() { recorder = MediaRecorder().apply { setAudioSource(MediaRecorder.AudioSource.MIC) setOutputFormat(MediaRecorder.OutputFormat.THREE_GPP) setOutputFile(fileName) setAudioEncoder(MediaRecorder.AudioEncoder.AMR_NB) try { prepare() } catch (e: IOException) { Log.e(LOG_TAG, "prepare() failed") } start() } } private fun stopRecording() { recorder?.apply { stop() release() } recorder = null } internal inner class RecordButton(ctx: Context) : Button(ctx) { var mStartRecording = true var clicker: OnClickListener = OnClickListener { onRecord(mStartRecording) text = when (mStartRecording) { true -> "Stop recording" false -> "Start recording" } mStartRecording = !mStartRecording } init { text = "Start recording" setOnClickListener(clicker) } } internal inner class PlayButton(ctx: Context) : Button(ctx) { var mStartPlaying = true var clicker: OnClickListener = OnClickListener { onPlay(mStartPlaying) text = when (mStartPlaying) { true -> "Stop playing" false -> "Start playing" } mStartPlaying = !mStartPlaying } init { text = "Start playing" setOnClickListener(clicker) } } override fun onCreate(icicle: Bundle?) { super.onCreate(icicle) // Record to the external cache directory for visibility fileName = "${externalCacheDir.absolutePath}/audiorecordtest.3gp" ActivityCompat.requestPermissions(this, permissions, REQUEST_RECORD_AUDIO_PERMISSION) recordButton = RecordButton(this) playButton = PlayButton(this) val ll = LinearLayout(this).apply { addView(recordButton, LinearLayout.LayoutParams( ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT, 0f)) addView(playButton, LinearLayout.LayoutParams( ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT, 0f)) } setContentView(ll) } override fun onStop() { super.onStop() recorder?.release() recorder = null player?.release() player = null } }
Java
package com.android.audiorecordtest; import android.Manifest; import android.content.Context; import android.content.pm.PackageManager; import android.media.MediaPlayer; import android.media.MediaRecorder; import android.os.Bundle; import android.support.annotation.NonNull; import android.support.v4.app.ActivityCompat; import android.support.v7.app.AppCompatActivity; import android.util.Log; import android.view.View; import android.view.ViewGroup; import android.widget.Button; import android.widget.LinearLayout; import java.io.IOException; public class AudioRecordTest extends AppCompatActivity { private static final String LOG_TAG = "AudioRecordTest"; private static final int REQUEST_RECORD_AUDIO_PERMISSION = 200; private static String fileName = null; private RecordButton recordButton = null; private MediaRecorder recorder = null; private PlayButton playButton = null; private MediaPlayer player = null; // Requesting permission to RECORD_AUDIO private boolean permissionToRecordAccepted = false; private String [] permissions = {Manifest.permission.RECORD_AUDIO}; @Override public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) { super.onRequestPermissionsResult(requestCode, permissions, grantResults); switch (requestCode){ case REQUEST_RECORD_AUDIO_PERMISSION: permissionToRecordAccepted = grantResults[0] == PackageManager.PERMISSION_GRANTED; break; } if (!permissionToRecordAccepted ) finish(); } private void onRecord(boolean start) { if (start) { startRecording(); } else { stopRecording(); } } private void onPlay(boolean start) { if (start) { startPlaying(); } else { stopPlaying(); } } private void startPlaying() { player = new MediaPlayer(); try { player.setDataSource(fileName); player.prepare(); player.start(); } catch (IOException e) { Log.e(LOG_TAG, "prepare() failed"); } } private void stopPlaying() { player.release(); player = null; } private void startRecording() { recorder = new MediaRecorder(); recorder.setAudioSource(MediaRecorder.AudioSource.MIC); recorder.setOutputFormat(MediaRecorder.OutputFormat.THREE_GPP); recorder.setOutputFile(fileName); recorder.setAudioEncoder(MediaRecorder.AudioEncoder.AMR_NB); try { recorder.prepare(); } catch (IOException e) { Log.e(LOG_TAG, "prepare() failed"); } recorder.start(); } private void stopRecording() { recorder.stop(); recorder.release(); recorder = null; } class RecordButton extends Button { boolean mStartRecording = true; OnClickListener clicker = new OnClickListener() { public void onClick(View v) { onRecord(mStartRecording); if (mStartRecording) { setText("Stop recording"); } else { setText("Start recording"); } mStartRecording = !mStartRecording; } }; public RecordButton(Context ctx) { super(ctx); setText("Start recording"); setOnClickListener(clicker); } } class PlayButton extends Button { boolean mStartPlaying = true; OnClickListener clicker = new OnClickListener() { public void onClick(View v) { onPlay(mStartPlaying); if (mStartPlaying) { setText("Stop playing"); } else { setText("Start playing"); } mStartPlaying = !mStartPlaying; } }; public PlayButton(Context ctx) { super(ctx); setText("Start playing"); setOnClickListener(clicker); } } @Override public void onCreate(Bundle icicle) { super.onCreate(icicle); // Record to the external cache directory for visibility fileName = getExternalCacheDir().getAbsolutePath(); fileName += "/audiorecordtest.3gp"; ActivityCompat.requestPermissions(this, permissions, REQUEST_RECORD_AUDIO_PERMISSION); LinearLayout ll = new LinearLayout(this); recordButton = new RecordButton(this); ll.addView(recordButton, new LinearLayout.LayoutParams( ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT, 0)); playButton = new PlayButton(this); ll.addView(playButton, new LinearLayout.LayoutParams( ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT, 0)); setContentView(ll); } @Override public void onStop() { super.onStop(); if (recorder != null) { recorder.release(); recorder = null; } if (player != null) { player.release(); player = null; } } }
ज़्यादा जानें
इन पेजों पर ऑडियो और वीडियो को रिकॉर्ड करने, सेव करने, और उन्हें चलाने से जुड़े विषय दिए गए हैं.