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);创建新会话包含两个SurfacecameraDevice.createCaptureSession(Arrays.asList(previewSurface, recorderSurface), new CameraCaptureSession.StateCallback() { Override public void onConfigured(NonNull CameraCaptureSession session) { // 启动重复请求和MediaRecorder } }, handler);注意必须在MediaRecorder.start()之前启动重复请求否则会导致首帧丢失。4. 录制状态转换与异常处理录像过程中的状态管理是稳定性的关键。我们需要处理以下典型场景正常停止流程停止捕获请求session.stopRepeating()中止未完成捕获session.abortCaptures()停止MediaRecordermediaRecorder.stop()重置MediaRecordermediaRecorder.reset()切换回预览模式异常处理矩阵异常类型检测方法恢复策略相机断开onDisconnected()关闭当前会话重新初始化权限丢失SecurityException请求权限重建会话存储空间不足IOException检查存储提示用户过热保护CameraAccessException.CAMERA_ERROR暂停功能等待冷却资源释放顺序特别重要错误的顺序可能导致死锁先停止MediaRecorder再关闭CameraCaptureSession最后关闭CameraDevice5. 视频存储与系统相册集成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 10File 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 Profile7. 设备兼容性处理不同厂商的设备实现存在差异必须进行兼容性处理编码器能力检测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录像功能时保持代码的灵活性和可配置性至关重要。建议将关键参数设计为可动态调整的以应对不同设备的特性。录制过程中详细的日志记录和性能监控也能帮助快速定位问题。