揭秘CameraProviderManager中的openSession()函数

2023-05-27 09:20:50

Android相机开发的精髓：剖析Camera2 API中的openSession()函数

理解Android相机开发的基石

Android相机开发是一个复杂而有挑战性的领域，需要开发者深入了解底层硬件和软件机制。Camera2 API是Android平台上用于访问相机硬件的底层API，它提供了强大的控制功能和灵活性。其中，openSession()函数是Camera2 API中的关键函数，负责打开相机设备并获取相机流。

CameraProviderManager中的openSession()函数

CameraProviderManager类负责管理相机设备并提供相机流。openSession()函数是CameraProviderManager中的一个关键函数，用于打开相机设备并获取相机流。它有三个参数：

callback： 一个回调函数，用于接收相机设备状态变化的通知。
executor： 一个执行器，用于执行回调函数。
requestBuilder： 一个请求构建器，用于构建相机捕获请求。

openSession()函数的内部机制

openSession()函数的内部机制涉及到多个类和方法的调用。简述如下：

设备状态检查： 检查相机设备的状态。如果已打开，直接返回相机流ID。
设备打开： 如果设备未打开，创建一个CameraDevice对象并调用其open()函数打开设备。
相机流创建： open()函数调用HAL层相机驱动程序创建相机流。
捕获请求创建： open()函数返回后，创建相机捕获请求。
重复捕获请求： 将捕获请求设置为重复执行。

关键参数：callback和requestBuilder

openSession()函数的两个关键参数是callback和requestBuilder：

callback： 接收相机设备状态变化的通知，有三个回调方法：onOpened()、onClosed()和onError()。
requestBuilder： 构建相机捕获请求，允许配置图像格式、对焦模式、曝光模式等参数。

示例代码

CameraProviderManager cameraProviderManager = CameraProviderManager.getInstance();
long cameraStreamId = cameraProviderManager.openSession(new CameraDevice.StateCallback() {
    @Override
    public void onOpened(@NonNull CameraDevice cameraDevice) {
        // 相机已打开
    }

    @Override
    public void onClosed(@NonNull CameraDevice cameraDevice) {
        // 相机已关闭
    }

    @Override
    public void onError(@NonNull CameraDevice cameraDevice, int error) {
        // 相机发生错误
    }
}, ContextCompat.getMainExecutor(this), null);