Android MediaRecorder.setOutputFile详解与版本适配

1. MediaRecorder.setOutputFile的核心作用与调用场景

在Android多媒体开发中，MediaRecorder的setOutputFile方法扮演着关键角色。这个方法决定了录制内容的最终存储位置，直接影响着应用的稳定性和用户体验。实际开发中，90%的媒体录制问题都与文件路径设置不当有关。

setOutputFile方法有两个重载版本：

java复制public void setOutputFile(String path)
public void setOutputFile(FileDescriptor fd)

第一种接受字符串路径的方式最为常用，但在Android不同版本上有显著差异：

• 在Android 7.0（API 24）之前，可以直接使用SD卡路径
• 从Android 7.0开始，必须通过FileProvider访问外部存储
• Android 10（API 29）引入分区存储后，路径处理更加严格

第二种使用文件描述符的方式适合：

• 临时文件录制
• 需要将多个录制片段拼接的场景
• 需要更高性能的流式写入场景

关键提示：无论使用哪种方式，都必须在调用prepare()方法之前设置输出文件，否则会抛出IllegalStateException异常。

2. 从源码角度解析setOutputFile调用流程

2.1 Java层调用链路分析

MediaRecorder.java中的setOutputFile方法最终会通过JNI调用native方法：

java复制// MediaRecorder.java
public void setOutputFile(String path) throws IllegalStateException {
    if (!Arrays.asList(mPathPermissions).contains(path)) {
        throw new SecurityException("Attempt to set output file without permission");
    }
    _setOutputFile(mNativeContext, path);
}

private native void _setOutputFile(long nativePtr, String path);

这个调用会经过以下关键步骤：

1. 权限校验：检查应用是否有目标路径的写入权限
2. 路径规范化：将用户传入的路径转换为系统标准格式
3. 文件预创建：确保目标文件存在并可写入
4. 原生层绑定：将Java对象与底层媒体服务关联

2.2 Native层实现细节

在android_media_MediaRecorder.cpp中，native方法实现如下：

cpp复制static void android_media_MediaRecorder_setOutputFile(
        JNIEnv *env, jobject thiz, jlong nativePtr, jstring path) {
    sp<MediaRecorder> mr = *(MediaRecorder **)&nativePtr;
    
    const char *pathStr = env->GetStringUTFChars(path, NULL);
    status_t opStatus = mr->setOutputFile(pathStr);
    env->ReleaseStringUTFChars(path, pathStr);
    
    if (opStatus != OK) {
        jniThrowException(env, "java/io/IOException", "setOutputFile failed");
    }
}

Native层的关键处理包括：

1. 路径编码转换：将Java字符串转为C风格字符串
2. 文件系统检查：验证路径是否在应用沙箱内
3. 媒体服务通信：通过Binder与MediaServer建立连接
4. 缓冲区初始化：为录制数据分配内存缓冲区

2.3 与MediaServer的交互流程

MediaRecorder最终通过以下序列与媒体服务交互：

1. 创建MediaRecorderClient对象
2. 建立与MediaPlayerService的连接
3. 通过setOutputFile通知底层准备文件IO
4. 返回文件句柄给应用进程

这个过程中最易出错的环节是跨进程权限检查，特别是在Android 10+的设备上。

3. 不同Android版本的适配实践

3.1 Android 6.0-7.0的存储权限处理

在传统存储模型下，需要以下权限：

xml复制<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

典型代码示例：

java复制String outputPath = Environment.getExternalStorageDirectory() + "/Movies/recording.mp4";
recorder.setOutputFile(outputPath);

3.2 Android 7.0-10.0的FileProvider方案

从Android 7.0开始，必须使用FileProvider：

1. 在manifest中声明provider：

xml复制<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths"/>
</provider>

2. 创建res/xml/file_paths.xml：

xml复制<paths>
    <external-path name="movies" path="Movies"/>
</paths>

3. 代码实现：

java复制File mediaDir = new File(Environment.getExternalStorageDirectory(), "Movies");
File outputFile = new File(mediaDir, "recording_" + System.currentTimeMillis() + ".mp4");

Uri fileUri = FileProvider.getUriForFile(
    context, 
    context.getPackageName() + ".fileprovider",
    outputFile
);

recorder.setOutputFile(outputFile.getAbsolutePath());

3.3 Android 10+的分区存储适配

在Android 10及以上版本，推荐使用MediaStore API：

java复制ContentValues values = new ContentValues();
values.put(MediaStore.Video.Media.DISPLAY_NAME, "recording_" + System.currentTimeMillis() + ".mp4");
values.put(MediaStore.Video.Media.MIME_TYPE, "video/mp4");
values.put(MediaStore.Video.Media.RELATIVE_PATH, Environment.DIRECTORY_MOVIES);

Uri uri = context.getContentResolver().insert(
    MediaStore.Video.Media.EXTERNAL_CONTENT_URI,
    values
);

if (uri != null) {
    ParcelFileDescriptor pfd = context.getContentResolver().openFileDescriptor(uri, "w");
    if (pfd != null) {
        recorder.setOutputFile(pfd.getFileDescriptor());
    }
}

4. 实战中的典型问题与解决方案

4.1 权限问题排查指南

当遇到权限问题时，建议按以下步骤排查：

1. 检查manifest是否声明了所需权限
2. 确认运行时权限是否已授予（对于Android 6.0+）
3. 验证FileProvider配置是否正确
4. 检查路径是否在应用沙箱内（Android 10+）

常见错误日志分析：

code复制E/MediaRecorder: setOutputFile failed: EACCES (Permission denied)

表示文件访问权限问题，通常需要检查存储权限或FileProvider配置。

4.2 文件路径的最佳实践

推荐的文件路径管理方案：

1. 内部存储（私有目录）：

java复制File internalDir = context.getFilesDir();
String path = internalDir.getAbsolutePath() + "/recording.mp4";

2. 外部存储公共目录：

java复制File moviesDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_MOVIES);

3. 外部存储应用专属目录：

java复制File externalDir = context.getExternalFilesDir(Environment.DIRECTORY_MOVIES);

重要提示：从Android 11开始，访问外部存储公共目录需要MANAGE_EXTERNAL_STORAGE特殊权限，且需要上架Google Play时声明合理用途。

4.3 性能优化技巧

1. 使用文件描述符替代路径：

java复制FileOutputStream fos = new FileOutputStream(file);
recorder.setOutputFile(fos.getFD());

2. 预分配文件空间（针对大文件录制）：

java复制RandomAccessFile raf = new RandomAccessFile(file, "rw");
raf.setLength(1024 * 1024 * 100); // 预分配100MB
recorder.setOutputFile(raf.getFD());

3. 缓冲区大小调整：

java复制// 在setAudioSource/setVideoSource之后调用
recorder.setParameters("video-param-encoding-bitrate=8000000");

4.4 跨版本兼容方案

推荐使用以下兼容方案处理不同Android版本：

java复制private Uri getRecordingUri(Context context) throws IOException {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        return getMediaStoreUri(context);
    } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
        return getFileProviderUri(context);
    } else {
        return getLegacyUri(context);
    }
}

private Uri getMediaStoreUri(Context context) {
    // Android 10+的实现
    ContentValues values = new ContentValues();
    values.put(MediaStore.Video.Media.DISPLAY_NAME, generateFileName());
    values.put(MediaStore.Video.Media.MIME_TYPE, "video/mp4");
    values.put(MediaStore.Video.Media.RELATIVE_PATH, Environment.DIRECTORY_MOVIES);
    return context.getContentResolver().insert(
        MediaStore.Video.Media.EXTERNAL_CONTENT_URI,
        values
    );
}

private Uri getFileProviderUri(Context context) throws IOException {
    // Android 7.0-9.0的实现
    File outputFile = createOutputFileInMoviesDir();
    return FileProvider.getUriForFile(
        context,
        context.getPackageName() + ".fileprovider",
        outputFile
    );
}

private Uri getLegacyUri(Context context) throws IOException {
    // Android 6.0及以下的实现
    File outputFile = createOutputFileInMoviesDir();
    return Uri.fromFile(outputFile);
}

5. 高级应用场景与扩展

5.1 分段录制与文件拼接

实现高质量分段录制的关键点：

1. 使用文件描述符保持流连续性：

java复制ParcelFileDescriptor[] pipe = ParcelFileDescriptor.createPipe();
ParcelFileDescriptor readSide = pipe[0];
ParcelFileDescriptor writeSide = pipe[1];

// 在子线程中写入数据
new Thread(() -> {
    try (FileOutputStream fos = new FileOutputStream(writeSide.getFileDescriptor())) {
        while (isRecording) {
            byte[] data = getNextChunk();
            fos.write(data);
        }
    }
}).start();

// 设置MediaRecorder输出
recorder.setOutputFile(readSide.getFileDescriptor());

2. 使用MediaMuxer进行后期拼接：

java复制MediaMuxer muxer = new MediaMuxer(outputPath, MediaMuxer.OutputFormat.MUXER_OUTPUT_MPEG_4);

// 添加各个片段的轨道信息
// ...

// 写入样本数据
muxer.writeSampleData(trackIndex, byteBuffer, bufferInfo);

5.2 加密录制内容

实现实时加密录制的方案：

1. 自定义FileDescriptor实现：

java复制public class EncryptedFileDescriptor extends ParcelFileDescriptor {
    private Cipher cipher;
    
    public EncryptedFileDescriptor(ParcelFileDescriptor original, SecretKey key) {
        super(original);
        this.cipher = Cipher.getInstance("AES/CBC/PKCS5Padding");
        cipher.init(Cipher.ENCRYPT_MODE, key);
    }
    
    @Override
    public FileOutputStream createOutputStream() {
        return new CipherOutputStream(super.createOutputStream(), cipher);
    }
}

2. 在MediaRecorder中使用：

java复制ParcelFileDescriptor original = ...;
SecretKey key = ...; // 从KeyStore获取
ParcelFileDescriptor encrypted = new EncryptedFileDescriptor(original, key);
recorder.setOutputFile(encrypted.getFileDescriptor());

5.3 低延迟直播场景优化

对于需要低延迟的直播场景，建议：

1. 使用Socket传输替代文件：

java复制Socket socket = new Socket(serverAddress, serverPort);
recorder.setOutputFile(socket.getOutputStream().getFD());

2. 调整媒体格式参数：

java复制recorder.setVideoEncodingBitRate(2000000); // 2Mbps
recorder.setVideoFrameRate(30);
recorder.setVideoSize(1280, 720);
recorder.setOutputFormat(MediaRecorder.OutputFormat.THREE_GPP);

3. 关键帧间隔优化：

java复制recorder.setParameters("video-param-i-frames-interval=1");

6. 调试技巧与性能分析

6.1 使用ADB进行录制监控

常用ADB命令：

bash复制# 监控MediaServer进程
adb shell top -p `pgrep mediaserver`

# 查看录制文件描述符
adb shell ls -l /proc/`pgrep mediaserver`/fd

# 获取MediaRecorder日志
adb logcat -s MediaRecorder

6.2 性能瓶颈分析

常见性能问题及解决方案：

1. 文件IO瓶颈：

• 症状：录制帧率不稳定，logcat中出现"skipped frames"警告
• 解决方案：使用SSD存储或内存缓冲

2. 编码器过载：

• 症状：视频质量下降，出现马赛克
• 解决方案：降低分辨率或比特率

3. 权限检查延迟：

• 症状：prepare()调用耗时过长
• 解决方案：预检查权限，使用缓存路径

6.3 自动化测试方案

推荐使用AndroidX Test进行自动化测试：

java复制@RunWith(AndroidJUnit4.class)
public class MediaRecorderTest {
    @Test
    public void testOutputFileSetting() throws Exception {
        Context context = InstrumentationRegistry.getInstrumentation().getTargetContext();
        
        File testFile = new File(context.getExternalCacheDir(), "test.mp4");
        MediaRecorder recorder = new MediaRecorder();
        
        recorder.setAudioSource(MediaRecorder.AudioSource.MIC);
        recorder.setOutputFormat(MediaRecorder.OutputFormat.MPEG_4);
        recorder.setOutputFile(testFile.getAbsolutePath());
        
        // 验证文件是否可访问
        assertTrue(testFile.createNewFile());
        
        // 验证MediaRecorder状态
        recorder.prepare();
        assertTrue(recorder.toString().contains("output file"));
    }
}

在实际项目中，我发现MediaRecorder的输出文件设置虽然看似简单，但涉及到底层媒体服务、文件系统和权限模型的复杂交互。特别是在处理大文件录制时，正确的文件预分配和缓冲区管理可以显著提升录制稳定性。建议在关键业务场景中，除了标准的异常捕获外，还应该实现录制状态监控和自动恢复机制，比如当检测到存储空间不足时，自动切换到备用存储位置并保持录制连续性。