android 自定义相机预览界面

原创

mob64ca12e3a791 2024-10-28 05:33:13 ©著作权

文章标签 自定义相机 xml API 文章分类 Android 移动开发

©著作权归作者所有：来自51CTO博客作者mob64ca12e3a791的原创作品，请联系作者获取转载授权，否则将追究法律责任

自定义 Android 相机预览界面

在Android开发中，实现一个自定义相机预览界面是一个非常有趣且实用的挑战。许多应用都需要拍照或录制视频，并希望以最适合用户的方式呈现这一功能。本文将引导你构建一个基本的自定义相机预览界面，包括必要的代码示例。

自定义相机预览的基本构成

要实现一个自定义相机，我们需要以下几个核心组件：

Camera API：大多数应用使用 CameraX、Camera2 API，或者简单的 Camera API 进行图像捕获。
SurfaceView：用于显示相机预览。
权限管理：请求并管理摄像头和存储的相关权限。
UI 组件：如快门按钮、切换摄像头等功能。

第一步：设置权限

确保你的 AndroidManifest.xml 文件中添加了必要的权限：

<uses-permission android:name="android.permission.CAMERA"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

第二步：创建相机预览界面

在你的布局文件中，定义一个 SurfaceView 以展示相机预览：

<FrameLayout xmlns:android="
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <SurfaceView
        android:id="@+id/surfaceView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

    <Button
        android:id="@+id/captureButton"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="bottom|center_horizontal"
        android:text="拍照"/>
</FrameLayout>

第三步：实现 Camera 逻辑

在你的 Activity 中，建立一个 SurfaceHolder.Callback 来开始相机预览：

import android.Manifest;
import android.content.pm.PackageManager;
import android.hardware.Camera;
import android.os.Bundle;
import android.view.SurfaceHolder;
import android.view.SurfaceView;
import android.view.View;
import android.widget.Button;
import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;

public class CameraActivity extends AppCompatActivity {

    private Camera camera;
    private SurfaceView surfaceView;
    private SurfaceHolder surfaceHolder;

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

        surfaceView = findViewById(R.id.surfaceView);
        Button captureButton = findViewById(R.id.captureButton);

        surfaceHolder = surfaceView.getHolder();
        surfaceHolder.addCallback(surfaceCallback);

        captureButton.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                if (camera != null) {
                    camera.takePicture(null, null, pictureCallback);
                }
            }
        });
    }

    private SurfaceHolder.Callback surfaceCallback = new SurfaceHolder.Callback() {
        @Override
        public void surfaceCreated(SurfaceHolder holder) {
            camera = Camera.open();
            try {
                camera.setPreviewDisplay(holder);
                camera.startPreview();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }

        @Override
        public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) {
            // 处理变化
        }

        @Override
        public void surfaceDestroyed(SurfaceHolder holder) {
            if (camera != null) {
                camera.stopPreview();
                camera.release();
                camera = null;
            }
        }
    };

    private Camera.PictureCallback pictureCallback = new Camera.PictureCallback() {
        @Override
        public void onPictureTaken(byte[] data, Camera camera) {
            // 处理拍摄后的数据
        }
    };

    @Override
    protected void onPause() {
        super.onPause();
        if (camera != null) {
            camera.stopPreview();
            camera.release();
            camera = null;
        }
    }
}

第四步：权限管理

在运行时请求权限是很重要的，尤其是在 Android 6.0 及以上版本：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    if (ActivityCompat.checkSelfPermission(this, Manifest.permission.CAMERA) != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.CAMERA}, 200);
    } else {
        // 继续初始化相机
    }
}

旅行图示例

使用 mermaid 语法，可以示意相机应用的开发过程：

journey
    title 相机应用开发进程
    section 权限管理
      请求相机权限: 5: 手机用户
    section 实现相机界面
      创建布局: 4: 开发者
      编写 Camera 逻辑: 4: 开发者
    section 测试及完善
      运行测试: 3: 测试者
      完善功能: 4: 开发者