MediaRecorder 概述

Android 多媒体框架包括对捕获和编码各种常见音频和视频格式的支持。如果设备硬件支持，您可以使用 MediaRecorder API。

本文件介绍如何使用 MediaRecorder 编写一个应用程序，该应用程序可以从设备麦克风捕获音频，保存音频并将其播放（使用 MediaPlayer）。要录制视频，您需要使用设备摄像头以及 MediaRecorder。这在 Camera 指南中有所介绍。

注意： Android 模拟器无法录制音频。请确保在可以录制音频的真实设备上测试您的代码。

请求录制音频的权限

为了能够录制，您的应用程序必须告知用户它将访问设备的音频输入。您必须在应用程序的清单文件中包含此权限标签

<uses-permission android:name="android.permission.RECORD_AUDIO" />

RECORD_AUDIO 被视为 "危险" 权限，因为它可能对用户的隐私构成风险。从 Android 6.0（API 级别 23）开始，使用危险权限的应用程序必须在运行时向用户请求批准。在用户授予权限后，应用程序应该记住并不再询问。下面的示例代码展示了如何使用 ActivityCompat.requestPermissions() 实现此行为。

创建和运行 MediaRecorder

使用以下调用初始化 MediaRecorder 的新实例

使用 setAudioSource() 设置音频源。您可能需要使用 MIC。
注意：大多数音频源（包括 DEFAULT）会对音频信号进行处理。要录制原始音频，请选择 UNPROCESSED。某些设备不支持未经处理的输入。首先调用 AudioManager.getProperty(AudioManager.PROPERTY_SUPPORT_AUDIO_SOURCE_UNPROCESSED) 验证其是否可用。如果不可用，请尝试使用 VOICE_RECOGNITION，它不使用 AGC 或降噪功能。即使属性不受支持，您也可以使用 UNPROCESSED 作为音频源，但在这种情况下，无法保证信号是否会被处理。
使用 setOutputFormat() 设置输出文件格式。请注意，从 Android 8.0（API 级别 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（API 级别 28）或更高版本的设备上，在后台运行的应用程序无法访问麦克风。因此，您的应用程序应该仅在处于前台时或将 MediaRecorder 的实例包含在前台服务中时录制音频。

使用 MediaMuxer 录制多个通道

从 Android 8.0（API 级别 26）开始，您可以使用 MediaMuxer 录制多个同步的音频和视频流。在早期的 Android 版本中，您一次只能录制一条音频轨道和/或一条视频轨道。

使用 addTrack() 方法将多个轨道混合在一起。

您还可以添加一个或多个包含自定义信息的元数据轨道，但只能添加到 MP4 容器中。您的应用程序定义元数据的格式和内容。

添加元数据

元数据对于离线处理非常有用。例如，从陀螺仪传感器捕获的数据可用于执行视频稳定。

当您添加元数据轨道时，轨道 MIME 格式必须以 application/ 为前缀。写入元数据与写入视频或音频数据相同，只是数据不是来自 MediaCodec。相反，应用程序会将带有关联时间戳的 ByteBuffer 传递给 writeSampleData() 方法。时间戳必须与视频和音频轨道的相同时间基准一致。

生成的 MP4 文件使用 TextMetaDataSampleEntry，该条目在 ISO BMFF 规范的第 12.3.3.2 节中定义，用于指示元数据的 MIME 格式。当您使用 MediaExtractor 提取包含元数据轨道的文件时，元数据的 MIME 格式会显示为 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;
        }
    }
}

了解更多

这些页面涵盖了与录制、存储和播放音频和视频相关的主题。