CameraX设置VideoCapture参数无效，如何实现指定参数的视频录制？

问题原因 #

• CameraX的VideoCapture.Builder中设置的帧率、码率等参数只是系统参考建议值，并非强制生效。底层的MediaCodec会根据设备硬件兼容性、实时系统负载自动调整参数，优先保证录制稳定性。
• 未指定目标分辨率时，系统会自动选择当前摄像头支持的最优分辨率（通常是较高规格），分辨率提升后，即使码率参数不变，实际编码后的码率也会因分辨率变大而上升。
• 部分设备硬件不支持你设置的参数组合（比如30fps+指定码率的搭配），系统会自动回退到设备兼容的配置。

解决办法 #

1. 明确锁定目标分辨率 #

先通过setTargetResolution或setTargetAspectRatio指定需要的分辨率，避免系统自动选择过高规格导致码率失控：

val targetSize = Size(1280, 720) // 720P分辨率
videoCapture = VideoCapture.Builder()
    .setTargetResolution(targetSize)
    .setVideoFrameRate(30)
    .setBitRate(480000)
    .setAudioBitRate(70000)
    .setAudioChannelCount(1)
    .build()

2. 切换至CameraX推荐的Recorder API（参数控制更可靠） #

CameraX 1.1及以上版本推荐使用Recorder+Recording的新API，参数控制能力更强，且支持更多自定义配置：

// 1. 创建Recorder并配置参数
val recorder = Recorder.Builder()
    .setQualitySelector(QualitySelector.from(Quality.HD720, FallbackStrategy.lowerQuality()))
    .setVideoFrameRate(30)
    .setBitRate(480000)
    .setAudioBitRate(70000)
    .setAudioChannelCount(1)
    .build()

// 2. 创建VideoCapture
val videoCapture = VideoCapture.withOutput(recorder)

// 3. 绑定生命周期
cameraProvider.bindToLifecycle(this, cameraSelector, preview, imageCapture, videoCapture)

QualitySelector可指定画质等级，搭配FallbackStrategy能确保设备不支持指定画质时自动降级，保证录制正常进行。

3. 验证设备支持的参数组合 #

若参数仍不生效，可先查询当前摄像头支持的视频配置，确保设置的参数在设备支持范围内：

val cameraInfo = cameraProvider.getCameraInfo(cameraSelector)
val supportedResolutions = cameraInfo.getSupportedResolutions(UseCaseGroup.Type.VIDEO_CAPTURE)
val supportedFrameRates = cameraInfo.getSupportedFrameRates(UseCaseGroup.Type.VIDEO_CAPTURE)
// 打印或检查这些支持的参数，再调整配置

4. 录制时通过OutputFileOptions细化配置 #

调用startRecording时，可通过OutputFileOptions进一步配置MediaRecorder参数，比如强制指定编码格式：

val outputOptions = VideoCapture.OutputFileOptions.Builder(file).build()
videoCapture.startRecording(
    outputOptions,
    ContextCompat.getMainExecutor(this),
    object : VideoCapture.OnVideoSavedCallback {
        override fun onVideoSaved(outputFileResults: VideoCapture.OutputFileResults) {
            // 录制完成回调
        }

        override fun onError(videoCaptureError: Int, message: String, cause: Throwable?) {
            // 错误处理
        }
    }
)

内容的提问来源于stack exchange，提问作者james04