RootEncoder项目中摄像头方向与分辨率设置的技术解析

摄像头参数设置的核心概念

在RootEncoder项目中，关于摄像头方向与分辨率的设置涉及到两个关键参数组：

1. 摄像头原始输出参数：通过getCameraResolutions获取设备支持的原始分辨率列表，如320x240、240x320等
2. 视频输出参数：通过prepareVideo方法设置最终输出的视频参数

方向参数的作用机制

方向参数(rotation)在RootEncoder中扮演着重要角色，但它的行为需要特别注意：

• prepareVideo中的rotation参数：控制最终输出视频的方向，当设置为90度时，会将输出视频的宽高值互换（例如320x240变为240x320）
• setCameraOrientation方法：调整摄像头捕获图像的方向，不影响输出视频的宽高值
• autoHandleOrientation属性：当启用时（默认值），系统会自动根据设备方向调整输出

黑边问题的产生与解决

当出现视频两侧黑边时，通常是由于以下原因：

1. 输出方向与设备方向不匹配：例如在竖屏设备上输出横屏分辨率
2. 分辨率比例不一致：输出分辨率比例与摄像头原始捕获比例不同

解决方案包括：

• 保持设备方向与输出方向一致
• 正确设置autoHandleOrientation参数
• 使用SensorRotationManager进行更精细的方向控制

预览与输出同步问题

在实际测试中发现，输出流方向正确时预览可能不同步，这是因为：

• 预览SurfaceView需要单独处理方向
• 系统默认不会自动旋转预览画面

正确的参数组合应该是：

• 手机竖屏时：prepareVideo rotation=90，setCameraOrientation=0
• 手机横屏时：需要相应调整参数组合

最佳实践建议

1. 优先使用设备原生支持的分辨率：避免使用非常规分辨率组合
2. 合理设置autoHandleOrientation：根据应用场景决定是否启用自动方向处理
3. 统一处理预览和输出：确保两者方向参数一致
4. 测试多种设备：不同厂商设备可能有不同的方向处理机制

通过深入理解这些参数的作用机制，开发者可以更好地控制RootEncoder的摄像头输出效果，避免黑边和方向错误等问题。