Android Camera2 之 CameraManager 详解

一、简介

CameraManager 是系统服务之一，专门用于检测和 打开相机，以及 获取相机设备特性。

官方文档其实说的蛮清楚的了，英文好的同学也可以直接看官方文档把：https://developer.android.google.cn/reference/android/hardware/camera2/CameraManager

二、获取 CameraManager 实例

通过 Context 类的 getSystemService() 方法来获取一个系统服务，参数使用 Context.CAMERA_SERVICE 或 CameraManager.class 都行。

// 方式一CameraManager manager = (CameraManager) context.getSystemService(Context.CAMERA_SERVICE);// 方式二CameraManager manager = (CameraManager) context.getSystemService(CameraManager.class);

三、内部类

CameraManager 中包含两个公有的内部类，分别为：

1. CameraManager.AvailabilityCallback

当一个相机设备的可用状态发生变化时，就会回调这个类的 onCameraAvailable(String cameraId) 和 onCameraUnavailable(String cameraId) 方法。

2. CameraManager.TorchCallback

当一个相机设备的闪光灯的 Torch 模式可用状态发生变化时，就会回调这个类的 onTorchModeChanged(String cameraId, boolean enabled) 和 onTorchModeUnavailable(String cameraId) 方法。

通过 setTorchMode(String cameraId, boolean enabled) 方法设置 Torch 模式。

四、常用方法

其中第二条和第三条是重点的重点，一定要掌握的。

1. String[] getCameraIdList()

获取当前连接的相机设备列表，这个 id 通常都是从 0 开始并依次递增的。

对于一般的手机而言:

后置摄像头一般为 “0”，常量值为 CameraCharacteristics.LENS_FACING_FRONT；
前置摄像头一般为 “1”，常量值为 CameraCharacteristics.LENS_FACING_BACK。

2. CameraCharacteristics getCameraCharacteristics(String cameraId)

根据 cameraId 获取对应相机设备的特征。返回一个 CameraCharacteristics，类比于旧 API 中的 Camera.Parameter 类，里面封装了相机设备固有的所有属性功能。

3. void openCamera(String cameraId, final CameraDevice.StateCallback callback, Handler handler)

打开指定的相机设备，该方法使用当前进程 uid 继续调用 openCameraForUid(cameraId, callback, handler, USE_CALLING_UID) 方法。

参数解释：

cameraId ：需要打开的相机 id。
callback ：回调类，常用如下几个回调方法。
- onOpened(CameraDevice camera) 成功打开时的回调，此时 camera 就准备就绪，并且可以得到一个 CameraDevice 实例。
- onDisconnected(CameraDevice camera) 当 camera 不再可用或打开失败时的回调，通常在该方法中进行资源释放的操作。
- onError(CameraDevice camera, int error) 当 camera 打开失败时的回调，error 为具体错误原因，定义在 CameraDevice.StateCallback 类中。通常在该方法中也要进行资源释放的操作。
handler ：指定回调执行的线程。传 null 时默认使用当前线程的 Looper，我们通常创建一个后台线程来处理。

使用示例：

    private int mCameraId = CameraCharacteristics.LENS_FACING_FRONT;    private CameraManager mCameraManager; // 相机管理者    private CameraDevice mCameraDevice; // 相机对象    private Handler mBackgroundHandler;    private HandlerThread mBackgroundThread;    private CameraDevice.StateCallback mStateCallback = new CameraDevice.StateCallback() {        @Override        public void onOpened(@NonNull CameraDevice camera) {            mCameraDevice = camera;            // 当相机成功打开时回调该方法，接下来可以执行创建预览的操作        }        @Override        public void onDisconnected(@NonNull CameraDevice camera) {            // 当相机断开连接时回调该方法，应该在此执行释放相机的操作        }        @Override        public void onError(@NonNull CameraDevice camera, int error) {            // 当相机打开失败时，应该在此执行释放相机的操作        }    };    public void openCamera() {        try {            // 前处理            mCameraManager.openCamera(Integer.toString(mCameraId), mStateCallback, mBackgroundHandler);        } catch (CameraAccessException e) {            e.printStackTrace();        }    }

后台线程创建示例：

    private void startBackgroundThread() {        mBackgroundThread = new HandlerThread("CameraBackground");        mBackgroundThread.start();        mBackgroundHandler = new Handler(mBackgroundThread.getLooper());    }    private void stopBackgroundThread() {        mBackgroundThread.quitSafely();        try {            mBackgroundThread.join();            mBackgroundThread = null;            mBackgroundHandler = null;        } catch (InterruptedException e) {            e.printStackTrace();        }    }

4. void registerAvailabilityCallback(AvailabilityCallback callback, Handler handler)

注册一个 AvailabilityCallback 回调，handle 指定处理回调的线程，传 null 时默认使用当前线程的 Looper。

CameraManager cameraManager = (CameraManager) context.getSystemService(Context.CAMERA_SERVICE);cameraManager.registerAvailabilityCallback(new CameraManager.AvailabilityCallback() {    @Override    public void onCameraAvailable(@NonNull String cameraId) {        super.onCameraAvailable(cameraId);    }    @Override    public void onCameraUnavailable(@NonNull String cameraId) {        super.onCameraUnavailable(cameraId);    }}, mBackgroundHandler);

5. void unregisterAvailabilityCallback(AvailabilityCallback callback)

注销 AvailabilityCallback 回调，当回调不再需要时一定要注销，否则将带来内存泄漏的问题。

6. void registerTorchCallback(TorchCallback callback, Handler handler)

注册一个 TorchCallback 回调，handle 解释如上。

CameraManager cameraManager = (CameraManager) context.getSystemService(Context.CAMERA_SERVICE);cameraManager.registerTorchCallback(new CameraManager.TorchCallback() {    @Override    public void onTorchModeUnavailable(@NonNull String cameraId) {        super.onTorchModeUnavailable(cameraId);    }    @Override    public void onTorchModeChanged(@NonNull String cameraId, boolean enabled) {        super.onTorchModeChanged(cameraId, enabled);    }}, mBackgroundHandler);

7. void unregisterTorchCallback(TorchCallback callback)

注销 TorchCallback 回调，当回调不再需要时一定要注销，否则将带来内存泄漏的问题。

8. void setTorchMode(String cameraId, boolean enabled)

打开和关闭指定相机设备的闪光灯功能。