CameraView：Android相机开发终极指南

2026-02-06 04:42:16作者：裴锟轩Denise

📸 A well documented, high-level Android interface that makes capturing pictures and videos easy, addressing all of the common issues and needs. Real-time filters, gestures, watermarks, frame processing, RAW, output of any size.

项目地址：https://gitcode.com/gh_mirrors/ca/CameraView

CameraView是一个高度文档化的Android相机库，旨在简化图片和视频的捕获过程，解决常见的摄像头问题和需求。它提供了实时滤镜、手势支持、水印、帧处理、RAW格式输出等功能，并且支持自定义输出尺寸。CameraView适用于从API 15开始的Android设备，并且经过了充分的测试。

快速集成CameraView

添加依赖配置

在项目的build.gradle文件中添加CameraView依赖：

dependencies {
    implementation 'com.otaliastudios:cameraview:2.7.2'
}

布局文件配置

在布局XML文件中添加CameraView组件：

<com.otaliastudios.cameraview.CameraView
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/camera"
    android:keepScreenOn="true"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    app:cameraEngine="camera2"
    app:cameraPreview="glSurface"
    app:cameraFacing="back"
    app:cameraFlash="auto"
    app:cameraMode="picture" />

核心代码实现

在Activity或Fragment中初始化和控制CameraView：

public class MainActivity extends AppCompatActivity {

    private CameraView cameraView;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        cameraView = findViewById(R.id.camera);
        cameraView.setLifecycleOwner(this);
    }

    @Override
    protected void onResume() {
        super.onResume();
        cameraView.open();
    }

    @Override
    protected void onPause() {
        super.onPause();
        cameraView.close();
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        cameraView.destroy();
    }
}

CameraView核心功能详解

实时滤镜系统

CameraView内置了丰富的实时滤镜效果，包括黑白滤镜、对比度调整、饱和度控制等。通过简单的配置即可为相机预览添加专业级的视觉效果。

手势控制功能

支持多种手势操作，让用户体验更加自然流畅：

点击手势：自动对焦或拍照
长按手势：自动对焦或拍照
捏合手势：缩放或曝光校正
滑动手势：滤镜参数调整

水印和动画叠加

CameraView支持在预览和输出内容上添加水印或动画元素：

<ImageView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_gravity="bottom|end"
    android:src="@drawable/watermark"
    app:layout_drawOnPreview="true"
    app:layout_drawOnPictureSnapshot="true"
    app:layout_drawOnVideoSnapshot="true"/>

自定义输出尺寸

通过灵活的尺寸选择器，可以精确控制输出图片和视频的尺寸：

app:cameraPictureSizeMinWidth="@integer/picture_min_width"
app:cameraPictureSizeMinHeight="@integer/picture_min_height"
app:cameraPictureSizeMaxWidth="@integer/picture_max_width"
app:cameraPictureSizeMaxHeight="@integer/picture_max_height"

高级功能配置

帧处理支持

CameraView提供了强大的帧处理能力，可以在每一帧上进行实时处理：

cameraView.addFrameProcessor(frame -> {
    // 实时处理每一帧数据
    // 支持图像识别、特效添加等复杂操作

多引擎支持

支持Camera1和Camera2两种引擎，确保在不同Android版本上的兼容性：

app:cameraEngine="camera1|camera2"

预览渲染选项

提供多种预览渲染方式，包括OpenGL、Surface和Texture：

app:cameraPreview="glSurface|surface|texture"

实战应用案例

拍照功能实现

cameraView.addCameraListener(new CameraListener() {
    @Override
    public void onPictureTaken(PictureResult result) {
        // 处理拍摄结果
        result.toBitmap(maxWidth, maxHeight, callback);
    }
});

cameraView.takePicture();

视频录制功能

cameraView.addCameraListener(new CameraListener() {
    @Override
    public void onVideoTaken(VideoResult result) {
        // 处理视频录制结果
    }
});

cameraView.setMode(Mode.VIDEO);
cameraView.takeVideo(file);
cameraView.stopVideo();