App
CameraManager
谷歌将CameraManager定义为一个系统服务,通过 Context.getService 来获取(Context.CAMERA_SERVICE),主要用于检测以及打开系统相机,通过 OpenCamera 方法来打开相机;此外,还定义了 getCameraCharacteristics 方法来获取当前 Camera 设备支持的属性信息,该属性信息通过 CameraCharacteristics 来表示,其中包括了图像数据的大小以及帧率等信息
CameraDevice
代表被打开的系统相机,用于创建 CameraCaptureSession 以及对于最后相机资源的释放
//打开给定的Camera的连接。使用 getCameraIdList 获取可用相机设备的列表
public void openCamera(String cameraId,final CameraDevice.StateCallback callback, Handler handler)
CameraDevice.StateCallback
定义了一些回调方法,实现交由 App 来完成,主要用于返回创建 Camera 设备的结果
//当相机设备完成打开时调用该方法,此时摄像头设备已经准备就绪,可以调用 createCaptureSession 来设置会话
public abstrace void onOpened(CameraDevice camera);
//当使用 close 关闭相机设备时调用的方法
public void onClosed(CameraDevice camera)
//当相机设备不再可用时调用的方法,如果打开相机失败,则可能会调用此回调而不是 onOpened。断开连接可能是由于安全策略或权限的变更,或者更高优先级的相机 API 客户端调用
public abstract void onDisconnected(CameraDevice camera)
//当相机设备遇到严重错误时调用的方法,这以某种方式表明相机设备或者相机服务出现故障
public abstract void onError(CameraDevice camera, int error)
CameraCaptureSession
该类代表了一个具体的相机会话,创建了与 Camera 设备的通道,而之后对于 Camera 设