Android Camera2 API实用技巧：处理相机回调

# 1. Android Camera2 API简介

## 1.1 传统相机API的限制
传统相机API存在诸多限制，包括性能不佳、功能受限、兼容性差等问题，无法满足现代移动设备对相机功能的需求。

## 1.2 Camera2 API的优势与特点
Camera2 API是Android 5.0引入的新一代相机API，它支持更丰富的相机操作和功能，具有更高的性能和灵活性，解决了传统相机API的诸多问题。

## 1.3 Camera2 API的基本概念与架构
Camera2 API基于一套新的架构和概念，包括相机设备、相机管理器、相机会话等组件，通过这些组件，应用可以更灵活地控制和操作相机设备。

# 2. Camera2 API基本使用

### 2.1 初始化相机设备

在使用Camera2 API之前，我们需要先初始化相机设备。通过以下步骤来完成相机设备的初始化：

1. 获取相机管理器(CameraManager)的实例：

CameraManager manager = (CameraManager) getSystemService(Context.CAMERA_SERVICE);

2. 获取可用的相机设备列表：

String[] cameraIds = manager.getCameraIdList();

3. 选择一个相机设备进行初始化（通常使用后置相机）：

String cameraId = cameraIds[0]; // 使用第一个设备
CameraDevice cameraDevice;
manager.openCamera(cameraId, new CameraDevice.StateCallback() {
    @Override
    public void onOpened(CameraDevice device) {
        // 相机设备成功打开后的回调
        cameraDevice = device;
    }
    @Override
    public void onDisconnected(CameraDevice device) {
        // 相机设备被断开连接后的回调
        cameraDevice = null;
    }
    @Override
    public void onError(CameraDevice device, int error) {
        // 相机设备出现错误时的回调
        cameraDevice = null;
    }
}, null);

### 2.2 创建预览

初始化相机设备后，我们可以创建预览界面来显示相机的实时预览画面。以下是创建预览的基本步骤：

1. 创建用于显示预览的SurfaceTexture对象：

SurfaceTexture surfaceTexture = new SurfaceTexture(0);

2. 获取预览尺寸：

CameraCharacteristics characteristics = manager.getCameraCharacteristics(cameraId);
StreamConfigurationMap configMap = characteristics.get(CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP);
Size[] sizes = configMap.getOutputSizes(SurfaceTexture.class);
Size previewSize = sizes[0]; // 使用第一个预览尺寸

3. 配置预览尺寸和SurfaceTexture对象：

surfaceTexture.setDefaultBufferSize(previewSize.getWidth(), previewSize.getHeight());
Surface surface = new Surface(surfaceTexture);

4. 创建预览请求及构建器：

CaptureRequest.Builder previewRequestBuilder = cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW);
previewRequestBuilder.addTarget(surface);

5. 设置预览画面的自动对焦模式：

previewRequestBuilder.set(CaptureRequest.CONTROL_AF_MODE, CaptureRequest.CONTROL_AF_MODE_CONTINUOUS_PICTURE);

6. 创建预览会话(Session)：

cameraDevice.createCaptureSession(Arrays.asList(surface), new CameraCaptureSession.StateCallback() {
    @Override
    public void onConfigured(CameraCaptureSession session) {
        // 预览会话成功配置后的回调
        session.setRepeatingRequest(previewRequestBuilder.build(), null, null);
    }
    @Override
    public void onConfigureFailed(CameraCaptureSession session) {
        // 预览会话配置失败后的回调
    }
}, null);

7. 将预览画面显示在TextureView中：

TextureView textureView = findViewById(R.id.texture_view);
textureView.setSurfaceTexture(surfaceTexture);

### 2.3 拍照与捕捉图像

除了实时预览，我们还可以通过Camera2 API进行拍照和捕捉静态图像。以下是拍照的基本步骤：

1. 创建拍照请求及构建器：

CaptureRequest.Builder captureRequestBuilder = cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_STILL_CAPTURE);
captureRequestBuilder.addTarget(imageReader.getSurface());

2. 配置拍照请求的参数：

captureRequestBuilder.set(CaptureRequest.CONTROL_AF_MODE, CaptureRequest.CONTROL_AF_MODE_AUTO);

3. 创建拍照会话：

cameraDevice.createCaptureSession(Arrays.asList(imageReader.getSurface()), new CameraCaptureSession.StateCallback() {
    @Override
    public void onConfigured(CameraCaptureSession session) {
        // 拍照会话成功配置后的回调
        session.capture(captureRequestBuilder.build(), null, null);
    }
    @Override
    public void onCon