Android Camera2录像实战：从MediaRecorder配置到视频保存到相册的完整避坑指南

Android Camera2录像开发全流程：从参数优化到相册同步的工程实践

在移动应用开发中，视频录制功能的需求日益增长，而Android Camera2 API提供了更强大的控制能力，同时也带来了更复杂的实现细节。本文将深入探讨Camera2录像功能的完整实现路径，特别聚焦于那些官方文档未曾明示的实战技巧和常见陷阱。

1. Camera2录像架构设计与初始化

Camera2 API采用管道式架构，与传统的Camera API有本质区别。理解这个架构是避免后续开发中各种诡异问题的关键。整个录像流程可以分解为以下几个核心组件：

• CameraManager：系统的入口点，用于检测和访问摄像头设备
• CameraCharacteristics：描述摄像头硬件特性的不可变对象
• CameraDevice：代表物理摄像头设备的抽象
• CameraCaptureSession：管理摄像头数据流的管道
• Surface：数据流的接收端点（预览Surface或MediaRecorder Surface）

设备兼容性检查是第一步，很多开发者会忽略这一点导致后续功能异常。我们需要检查设备是否支持LEGACY硬件级别：

CameraCharacteristics characteristics = cameraManager.getCameraCharacteristics(cameraId); Integer level = characteristics.get(CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL); if (level == null || level == CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY) { // 设备仅支持遗留模式，Camera2功能受限 return; }

创建录像会话时，必须同时处理预览Surface和录制Surface。这是Camera2与MediaRecorder集成的关键环节：

// 创建预览Surface SurfaceTexture texture = textureView.getSurfaceTexture(); texture.setDefaultBufferSize(previewSize.getWidth(), previewSize.getHeight()); Surface previewSurface = new Surface(texture); // 创建录制Surface（通过MediaRecorder） Surface recorderSurface = mediaRecorder.getSurface(); // 构建包含两个Surface的CaptureRequest mPreviewRequestBuilder = cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_RECORD); mPreviewRequestBuilder.addTarget(previewSurface); mPreviewRequestBuilder.addTarget(recorderSurface);

2. MediaRecorder参数配置的艺术

MediaRecorder的配置看似简单，实则暗藏玄机。以下是经过大量设备测试得出的最佳实践参数组合：

比特率设置特别值得关注。我们经常看到这样的错误配置：

// 不推荐的简单比特率设置 mediaRecorder.setVideoEncodingBitRate(8000000); // 8Mbps固定值 // 推荐的动态比特率计算（基于分辨率） int bitrate = (int)(8 * 1920 * 1080); // 1080p视频 mediaRecorder.setVideoEncodingBitRate(bitrate);

方向设置也是常见坑点。Camera2需要正确处理设备旋转：

// 获取设备自然方向 int rotation = activity.getWindowManager().getDefaultDisplay().getRotation(); int orientation = getOrientation(rotation, characteristics); // 设置MediaRecorder方向提示 mediaRecorder.setOrientationHint(orientation);

3. 录像会话的生命周期管理

录像会话的生命周期管理是稳定性的关键。一个完整的录像周期应该包含以下阶段：

1. 预览阶段：常规的摄像头预览
2. 过渡阶段：停止预览，准备录制
3. 配置阶段：设置MediaRecorder并创建录制会话
4. 录制阶段：同时处理预览和录制数据流
5. 停止阶段：有序释放资源
6. 后处理阶段：保存视频并恢复预览

过渡阶段最容易出现问题。必须确保完全停止预览后再开始录制准备：

// 正确停止预览的方式 try { captureSession.stopRepeating(); captureSession.abortCaptures(); // 关键！丢弃待处理帧 captureSession.close(); } catch (CameraAccessException e) { // 处理异常 }

录制启动时，正确的顺序至关重要：

1. 配置MediaRecorder所有参数
2. 调用prepare()
3. 获取MediaRecorder的Surface
4. 创建包含预览和录制Surface的CaptureRequest
5. 创建新的CameraCaptureSession
6. 在Session回调中启动MediaRecorder

mediaRecorder.prepare(); Surface recorderSurface = mediaRecorder.getSurface(); // 创建包含两个Surface的CaptureRequest mPreviewRequestBuilder = cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_RECORD); mPreviewRequestBuilder.addTarget(previewSurface); mPreviewRequestBuilder.addTarget(recorderSurface); // 创建新的录制会话 cameraDevice.createCaptureSession(Arrays.asList(previewSurface, recorderSurface), new CameraCaptureSession.StateCallback() { @Override public void onConfigured(CameraCaptureSession session) { // 在这里启动MediaRecorder mediaRecorder.start(); } }, handler);

4. 视频保存与相册同步的完整方案

录制完成后，正确处理视频文件关系到用户体验。以下是完整的保存流程：

1. 停止MediaRecorder并释放资源
2. 将视频文件从缓存目录移动到永久存储
3. 通过MediaStore将文件添加到系统媒体库
4. 发送广播通知媒体扫描器

文件保存的最佳实践：

// 创建时间戳文件名 String timestamp = new SimpleDateFormat("yyyyMMdd_HHmmss").format(new Date()); String fileName = "VID_" + timestamp + ".mp4"; // 获取公共Movies目录 ContentValues values = new ContentValues(); values.put(MediaStore.Video.Media.DISPLAY_NAME, fileName); values.put(MediaStore.Video.Media.MIME_TYPE, "video/mp4"); values.put(MediaStore.Video.Media.RELATIVE_PATH, Environment.DIRECTORY_MOVIES); ContentResolver resolver = context.getContentResolver(); Uri collectionUri = MediaStore.Video.Media.getContentUri( MediaStore.VOLUME_EXTERNAL_PRIMARY); Uri videoUri = resolver.insert(collectionUri, values); // 将临时文件写入MediaStore try (OutputStream out = resolver.openOutputStream(videoUri); FileInputStream in = new FileInputStream(tempFile)) { byte[] buf = new byte[4096]; int len; while ((len = in.read(buf)) > 0) { out.write(buf, 0, len); } }

相册即时刷新的三种方案对比：

1. MediaScannerConnection：传统方式，但效率较低

   MediaScannerConnection.scanFile(context, new String[]{file.getAbsolutePath()}, new String[]{"video/mp4"}, null);

2. MediaStore直接插入：Android 10+推荐方式

   ContentValues values = new ContentValues(); // ...填充values... resolver.insert(MediaStore.Video.Media.EXTERNAL_CONTENT_URI, values);

3. FileProvider共享文件：适合需要共享的场景

注意：从Android 10开始，直接文件路径访问受限，MediaStore是首选方案。同时要考虑作用域存储(Scoped Storage)的限制。

5. 性能优化与异常处理

高质量的视频录制需要考虑性能和稳定性。以下是关键优化点：

温度管理策略：

• 动态调整分辨率和帧率
• 监控设备温度API（Android 11+）
• 实现过热降级逻辑

内存优化技巧：

• 使用SurfaceView代替TextureView（减少1-2帧延迟）
• 配置合适的缓冲区大小
• 及时释放不再使用的资源

异常处理框架应该覆盖：

• 摄像头权限变化
• 摄像头被其他应用占用
• 存储空间不足
• 编码器不支持所选参数
• 设备过热保护

典型的健壮性检查流程：

// 检查存储空间 File dir = context.getExternalFilesDir(null); if (dir.getFreeSpace() < MIN_FREE_SPACE) { throw new IOException("Insufficient storage space"); } // 检查编码器支持 MediaCodecList codecList = new MediaCodecList(MediaCodecList.ALL_CODECS); for (MediaCodecInfo info : codecList.getCodecInfos()) { if (info.isEncoder() && info.getName().contains("h264")) { // 检查具体能力 CodecCapabilities caps = info.getCapabilitiesForType("video/avc"); // ... } }

6. 高级技巧与未来适配

随着Android版本的演进，Camera2的最佳实践也在变化。以下是前瞻性建议：

CameraX兼容层考虑：

• 简化生命周期管理
• 自动设备兼容性处理
• 与Camera2 API共存方案

动态分辨率切换实现：

1. 在录制过程中检测网络条件或用户偏好
2. 准备新的MediaRecorder配置
3. 平滑过渡到新分辨率

多摄像头协同场景：

• 前后摄像头同时录制
• 画中画视频合成
• 深度数据与视频同步

视频录制功能的完整实现远不止调用几个API那么简单。从参数优化到异常处理，从性能调优到未来适配，每个环节都需要精心设计。特别是在Camera2架构下，理解数据流管道和Surface的运作机制是解决问题的关键。