1. 安卓摄像头预览问题概述
在安卓开发中,摄像头预览是最基础也是最容易出问题的功能之一。不同于简单的静态图片显示,预览需要实时处理来自摄像头传感器的数据流,同时还要应对各种设备旋转、屏幕尺寸变化等复杂场景。根据我的经验,大约70%的摄像头相关问题都出现在预览阶段。
预览问题的典型表现包括:画面方向错误、画面拉伸变形、预览帧率过低、画面卡顿等。这些问题往往与设备硬件差异、API使用不当、屏幕适配不足等因素相关。特别是在当今设备形态多样化(可折叠设备、多屏设备)的背景下,传统的预览实现方式已经无法满足需求。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心问题解析
2.1 方向问题根源
摄像头传感器的物理安装方向与设备屏幕方向通常不一致。根据Android兼容性定义,摄像头传感器必须朝向特定方向:
- 前置摄像头通常旋转270度(逆时针)
- 后置摄像头通常旋转90度(顺时针)
这意味着原始图像数据需要经过旋转才能正确显示。计算公式如下:
code复制rotation = (sensorOrientationDegrees - deviceOrientationDegrees * sign + 360) % 360
其中sign值:前置摄像头为1,后置摄像头为-1。
2.2 宽高比适配挑战
现代安卓设备的屏幕宽高比差异巨大,从传统的16:9到全面屏的19:9,再到折叠屏展开后的4:3等。同时,摄像头传感器常见的4:3输出与屏幕宽高比不匹配,导致预览时需要做裁剪或留黑边处理。
3. 解决方案实现
3.1 CameraX方案
对于大多数应用,推荐使用Jetpack CameraX库。它提供了自动处理方向和大小的PreviewView:
kotlin复制val preview = Preview.Builder()
.setTargetAspectRatio(AspectRatio.RATIO_16_9)
.build()
val previewView = findViewById<PreviewView>(R.id.previewView)
preview.setSurfaceProvider(previewView.surfaceProvider)
val cameraSelector = CameraSelector.DEFAULT_BACK_CAMERA
LifecycleOwner.lifecycleScope.launch {
CameraX.bindToLifecycle(
lifecycleOwner,
cameraSelector,
preview
)
}
关键配置点:
- setTargetAspectRatio():设置期望的宽高比
- PreviewView的缩放类型:
- FIT_CENTER:保持原比例,可能有黑边
- FILL_CENTER:填充视图,可能裁剪
3.2 Camera2高级方案
对于需要更精细控制的场景,可以使用Camera2 API:
java复制private void createCameraPreview() {
try {
SurfaceTexture texture = textureView.getSurfaceTexture();
texture.setDefaultBufferSize(previewSize.getWidth(), previewSize.getHeight());
Surface surface = new Surface(texture);
captureRequestBuilder = cameraDevice.createCaptureRequest(
CameraDevice.TEMPLATE_PREVIEW);
captureRequestBuilder.addTarget(surface);
cameraDevice.createCaptureSession(
Arrays.asList(surface),
new CameraCaptureSession.StateCallback() {
