Android Camera2录像实战：从MediaRecorder配置到Gallery保存的完整避坑指南
Android Camera2录像开发全流程：从参数优化到系统相册集成的深度实践
在移动应用开发中，视频录制功能的需求日益增长，而Android Camera2 API提供了比传统Camera API更强大的控制能力。本文将深入探讨Camera2录像功能的完整实现路径，特别聚焦于那些官方文档未明确说明但实际开发中必然会遇到的"坑点"。
1. 录像前的关键准备工作
实现一个稳定的录像功能，准备工作往往比编码本身更重要。首先需要明确的是，Camera2 API的设计哲学与旧版Camera API有本质区别——它采用管道(pipeline)模式，将相机操作抽象为请求(request)和会话(session)的概念模型。
硬件兼容性检查是第一步。通过CameraCharacteristics获取设备支持的能力：
CameraManager manager = (CameraManager) context.getSystemService(Context.CAMERA_SERVICE); CameraCharacteristics characteristics = manager.getCameraCharacteristics(cameraId); // 检查是否支持录制级别的硬件 Integer hardwareLevel = characteristics.get( CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL); boolean isRecordSupported = hardwareLevel == CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL_3 || hardwareLevel == CameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL_FULL;视频录制特有的参数配置需要特别注意：
| 参数类型 | 检查方法 | 典型值 |
|---|---|---|
| 输出尺寸 | characteristics.get(CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP).getOutputSizes(MediaRecorder.class) | 1080p, 4K |
| 帧率范围 | characteristics.get(CameraCharacteristics.CONTROL_AE_AVAILABLE_TARGET_FPS_RANGES) | [15,30], [30,30] |
| 视频稳定 | characteristics.get(CameraCharacteristics.CONTROL_AVAILABLE_VIDEO_STABILIZATION_MODES) | ON/OFF |
提示：Android设备对Camera2的支持程度差异很大，特别是中低端设备可能仅支持LEGACY模式，这种情况下建议降级使用Camera API。
2. MediaRecorder配置的艺术
MediaRecorder的配置看似简单，实则暗藏玄机。以下是经过实战检验的最佳参数组合：
mediaRecorder.setAudioSource(MediaRecorder.AudioSource.CAMCORDER); mediaRecorder.setVideoSource(MediaRecorder.VideoSource.SURFACE); mediaRecorder.setOutputFormat(MediaRecorder.OutputFormat.MPEG_4); mediaRecorder.setAudioEncoder(MediaRecorder.AudioEncoder.AAC); mediaRecorder.setVideoEncoder(MediaRecorder.VideoEncoder.H264); mediaRecorder.setVideoEncodingBitRate(bitRate); mediaRecorder.setVideoFrameRate(30); mediaRecorder.setVideoSize(width, height); mediaRecorder.setOrientationHint(orientation);关键参数选择依据：
- 编码器选择：永远不要使用DEFAULT，而应明确指定AAC和H264。某些设备DEFAULT会使用低效编码
- 比特率计算：推荐公式：
width * height * fps * 0.1（普通质量）到width * height * fps * 0.3（高质量） - 方向提示：必须正确设置setOrientationHint，否则播放器可能无法正确旋转视频
常见的配置陷阱包括：
- 未调用
prepare()就直接start - 重复使用MediaRecorder实例前未reset()
- 输出文件路径没有写权限
- 视频尺寸不是设备支持的精确分辨率
3. 双Surface协同工作流程
Camera2录像需要同时处理预览Surface和录制Surface，这带来了额外的复杂性。正确的工作流程应该是：
停止预览会话：先停止当前运行的预览会话
captureSession.stopRepeating(); captureSession.abortCaptures();创建录制请求：使用TEMPLATE_RECORD模板
previewRequestBuilder = cameraDevice.createCaptureRequest( CameraDevice.TEMPLATE_RECORD);添加双Surface目标：
previewRequestBuilder.addTarget(previewSurface); previewRequestBuilder.addTarget(recorderSurface);创建新会话：包含两个Surface
cameraDevice.createCaptureSession(Arrays.asList(previewSurface, recorderSurface), new CameraCaptureSession.StateCallback() { @Override public void onConfigured(@NonNull CameraCaptureSession session) { // 启动重复请求和MediaRecorder } }, handler);
注意：必须在MediaRecorder.start()之前启动重复请求，否则会导致首帧丢失。
4. 录制状态转换与异常处理
录像过程中的状态管理是稳定性的关键。我们需要处理以下典型场景：
正常停止流程：
- 停止捕获请求：
session.stopRepeating() - 中止未完成捕获：
session.abortCaptures() - 停止MediaRecorder：
mediaRecorder.stop() - 重置MediaRecorder：
mediaRecorder.reset() - 切换回预览模式
异常处理矩阵：
| 异常类型 | 检测方法 | 恢复策略 |
|---|---|---|
| 相机断开 | onDisconnected() | 关闭当前会话，重新初始化 |
| 权限丢失 | SecurityException | 请求权限，重建会话 |
| 存储空间不足 | IOException | 检查存储，提示用户 |
| 过热保护 | CameraAccessException.CAMERA_ERROR | 暂停功能，等待冷却 |
资源释放顺序特别重要，错误的顺序可能导致死锁：
- 先停止MediaRecorder
- 再关闭CameraCaptureSession
- 最后关闭CameraDevice
5. 视频存储与系统相册集成
Android 10(API 29)引入的Scoped Storage对视频存储产生了重大影响。正确的现代存储方案应：
对于Android 10+设备：
ContentValues values = new ContentValues(); values.put(MediaStore.Video.Media.DISPLAY_NAME, "video.mp4"); values.put(MediaStore.Video.Media.MIME_TYPE, "video/mp4"); values.put(MediaStore.Video.Media.RELATIVE_PATH, "Movies/MyApp"); ContentResolver resolver = context.getContentResolver(); Uri uri = resolver.insert(MediaStore.Video.Media.EXTERNAL_CONTENT_URI, values); // 使用此uri作为MediaRecorder的输出 mediaRecorder.setOutputFile(context.getContentResolver().openFileDescriptor(uri, "w"));传统方法（预Android 10）：
File moviesDir = Environment.getExternalStoragePublicDirectory( Environment.DIRECTORY_MOVIES); File videoFile = new File(moviesDir, "video.mp4"); mediaRecorder.setOutputFile(videoFile.getAbsolutePath()); // 录制完成后通知系统扫描 MediaScannerConnection.scanFile(context, new String[]{videoFile.getAbsolutePath()}, new String[]{"video/mp4"}, null);视频元数据优化：
- 设置正确的DATE_TAKEN（影响相册排序）
- 添加地理位置信息（需要权限）
- 设置视频方向标记
- 包括视频时长信息
6. 性能优化实战技巧
高质量视频录制对性能要求极高，以下是经过验证的优化手段：
内存管理：
- 使用SurfaceView代替TextureView（减少1-2帧延迟）
- 设置合适的预览缓冲区大小
- 避免在录制过程中分配大对象
功耗控制：
// 在CaptureRequest中设置 previewRequestBuilder.set(CaptureRequest.CONTROL_AE_TARGET_FPS_RANGE, new Range<>(30, 30)); previewRequestBuilder.set(CaptureRequest.CONTROL_MODE, CameraMetadata.CONTROL_MODE_AUTO);编解码参数调优表：
| 参数 | 影响维度 | 推荐值 |
|---|---|---|
| 关键帧间隔 | 文件大小/seek性能 | 2-5秒 |
| 音频采样率 | 音质/大小 | 44.1kHz |
| 音频比特率 | 音质/大小 | 96-128kbps |
| 视频Profile | 兼容性 | Baseline Profile |
7. 设备兼容性处理
不同厂商的设备实现存在差异，必须进行兼容性处理：
编码器能力检测：
MediaCodecList codecList = new MediaCodecList(MediaCodecList.ALL_CODECS); MediaCodecInfo[] codecInfos = codecList.getCodecInfos(); for (MediaCodecInfo info : codecInfos) { if (info.isEncoder()) { String[] types = info.getSupportedTypes(); // 检查H264/AAC支持 } }分辨率适配策略：
- 优先选择设备原生分辨率
- 若无精确匹配，选择最接近的16:9比例
- 考虑性能降级方案（如1080p→720p）
厂商特定问题：
- 某些华为设备需要额外设置color format
- 部分三星设备对Surface处理有特殊要求
- 小米设备可能需要禁用某些高级特性
在实现Camera2录像功能时，保持代码的灵活性和可配置性至关重要。建议将关键参数设计为可动态调整的，以应对不同设备的特性。录制过程中详细的日志记录和性能监控也能帮助快速定位问题。