前言：书接上回，上篇文章介绍了安卓5.0之前工程下Camera1包的使用，这篇介绍下安卓5.0后Camera2的原理和使用方法，只涉及到预览，其他的复杂操作后续再补上。
工程：安卓8.0，Camera2
一、 官网介绍
从 Android 5.0 开始，Google 引入了一套全新的相机框架 Camera2，android.hardware.camera2，并且废弃了旧的相机框架 Camera1（android.hardware.Camera）。
Camera2 的 API 模型被设计成一个 Pipeline（管道），它按顺序处理每一帧的请求并返回请求结果给客户端。下面这张来自官方的图展示了 Pipeline 的工作流程
Camera2 流程示意图
从以上两张图可以看出，Camera2引用了管道的概念将安卓设备和摄像头之间联通起来，系统向摄像头发送Capture请求，而摄像头会返回CameraMetadata，这一切建立在一个叫做 CameraCaptureSession 的会话中。
Camera2包中主要类：
其中CameraManager是那个站在高处统管所有摄像头设备 (CameraDevice)的管理者，而每个CameraDevice自己会负责建立CameraCaptureSession 以及建立CaptureRequest。CameraCharacteristics 是CameraDevide的属性描述类，非要做个比较的话，那么它与原来的CameraInfo 有相似性。
上图中有三个比较重要的callback，增加了源码的阅读难度。其中CameraCaptureSession.CaptureCallback用于处理预览和拍照图片的工作，需要重点对待。
这些类之间相互配合流程图如下：
二、从下到上反推
Camera2下的摄像机称为CameraDevice，现在的手机一般都是后置三摄、四摄的，每一个CameraDevice都带有一个CameraCaptureSession的会话通道，我们只要抓住一条会话通道，就可以通过这条通道传送CameraRequest请求进行预览、拍照、录像。
整体创建流程是：CameraManage→CameraDevice→CameraCaptureSession。
所以我们只要向目标CameraDevice索取一条CameraCaptureSession会话通道，利用以下方法就可以实现控制摄像头预览、拍照或者摄像：
CameraCaptureSession.setRepeatingRequest(CaptureRequest arg0, CaptureCallback arg1, Handler arg2)
从第一个参数看，我们需要通过这个会话通道向CameraDevice传送一个CaptureRequest请求；第二个参数是回调，回调用常用到以下三个函数，
@Override
public void onCaptureStarted()
@Override
public void onCaptureCompleted()
@Override
public void onCaptureFailed()第三个参数是给回调用的线程，，如果参数二为null，此处就可为null。
下面是CameraDevice创建CameraCaptureSession函数
CameraDevice.createCaptureSession(List<Surface> arg0, StateCallback arg1, Handler arg2)创建出来的CameraCaptureSession就在参数二的回调类CameraCaptureSession.StateCallback()的onConfigured(CameraCaptureSession arg0)方法的参数给与，参数三是给回调用的线程，如果是null，就代表使用主线程，参数一是Surface的list集合，用以存放请求结果。
下面是CameraManager.openCamera()方法，用以创建CameraDevice。
CameraManager.openCamera(String cameraId, StateCallback callback, Handler handler) CameraDevice同样是在参数二回调类参数中的onOpened(CameraDevice arg0)方法的参数送回，参数一是指定打开的摄像头，“0”是后置，“1”是前置，参数三是回调占用的线程，同前。
所以我们的思路就是通过CameraManager 打开CameraDevice ，创建CameraCaptureSession会话，发送CaptureRequest。
三、注释代码
package com.example.camera2;
import android.Manifest;
import android.content.Context;
import android.content.pm.PackageManager;
import android.graphics.ImageFormat;
import android.hardware.camera2.CameraAccessException;
import android.hardware.camera2.CameraCaptureSession;
import android.hardware.camera2.CameraCharacteristics;
import android.hardware.camera2.CameraDevice;
import android.hardware.camera2.CameraManager;
import android.hardware.camera2.CaptureFailure;
import android.hardware.camera2.CaptureRequest;
import android.hardware.camera2.TotalCaptureResult;
import android.media.Image;
import android.media.ImageReader;
import android.os.Build;
import android.os.Bundle;
import android.os.Handler;
import android.os.HandlerThread;
import android.view.Surface;
import android.view.SurfaceHolder;
import android.view.SurfaceView;
import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import com.apkfuns.logutils.LogUtils;
import com.permissionx.guolindev.PermissionX;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collections;
import java.util.List;
import java.util.Set;
import static android.hardware.camera2.CameraDevice.TEMPLATE_PREVIEW;
public class MainActivity extends AppCompatActivity {
private CameraManager mCameraManager;
private static final boolean DETAIL = false;
private static final boolean DEBUG = BuildConfig.DEBUG && DETAIL;
private SurfaceView mFullSurfaceView;
private HandlerThread mEyeThread;
private Handler mBgHandler;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
mFullSurfaceView = findViewById(R.id.full_surface);
mEyeThread = new HandlerThread("eyeThread") {
@Override
protected void onLooperPrepared() {
super.onLooperPrepared();
LogUtils.i("ok");
}
};
mEyeThread.start();
mBgHandler = new Handler(mEyeThread.getLooper());
}
@Override
protected void onStart() {
super.onStart();
PermissionX.init(this)
.permissions(Manifest.permission.CAMERA)
.onForwardToSettings((scope, deniedList) -> {
LogUtils.d("%s, %s", scope, deniedList);
}).onExplainRequestReason((scope, deniedList, beforeRequest) -> {
LogUtils.d("%s, %s, %s", scope, deniedList, beforeRequest);
}).request((allGranted, grantedList, deniedList) -> {
LogUtils.d("permission request result: %s, %s, %s", allGranted, grantedList, deniedList);
if (!allGranted) {
return;
}
onPermissionPrepared();
});
}
//220419 komla 当权限设置完后
private void onPermissionPrepared() {
//CameraManager：摄像头管理器。这是一个全新的系统管理器，专门用于检测系统摄像头、打开系统摄像头。
// 另外，调用CameraManager的getCameraCharacteristics(String cameraId)方法即可获取指定摄像头的相关特性。
mCameraManager = (CameraManager) getSystemService(Context.CAMERA_SERVICE);
try {
String[] cameraIdList = mCameraManager.getCameraIdList();
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
Set<Set<String>> concurrentCameraIds = mCameraManager.getConcurrentCameraIds();
}
//220420 komla 循环摄像头id，只为了找到后置摄像头
for (String cameraId : cameraIdList) {
//CameraCharacteristics：摄像头特性。该对象通过CameraManager来获取，
// 用于描述特定摄像头所支持的各种特性。类似与原来的CameraInfo 。
CameraCharacteristics characteristics = mCameraManager.getCameraCharacteristics(cameraId);
//本循环获取的摄像头face属性
Integer facing = characteristics.get(CameraCharacteristics.LENS_FACING);
if (DEBUG) {
List<CameraCharacteristics.Key<?>> keys = characteristics.getKeys();
keys.forEach(key -> {
Object value = characteristics.get(key);
});
}
//220419 komla 后置摄像头 ok set default facing is back, not front
if (facing == CameraCharacteristics.LENS_FACING_BACK) {
ImageReader imageReader = ImageReader.newInstance(100, 100, ImageFormat.JPEG, 2);
// 输入相机的尺寸必须是相机支持的尺寸，这样画面才能不失真，TextureView输入相机的尺寸也是这个
//ImageReader imageReader = ImageReader.newInstance();
//设置监听 在此可获取帧
imageReader.setOnImageAvailableListener(reader -> {
Image image = reader.acquireLatestImage();
}, mBgHandler);
if (ActivityCompat.checkSelfPermission(this, Manifest.permission.CAMERA)
!= PackageManager.PERMISSION_GRANTED) {
return;
}
// 开启摄像头操作 用CameraManager的openCamera(String cameraId, CameraDevice.StateCallback callback, Handler handler)方法打开指定摄像头。
// 该方法的第一个参数代表要打开的摄像头ID；第二个参数用于监听摄像头的状态；
// 第三个参数代表执行callback的Handler，如果程序希望直接在当前线程中执行callback，
// 则可将handler参数设为null。
mCameraManager.openCamera(cameraId, new CameraDevice.StateCallback() {
@Override
public void onOpened(CameraDevice camera) {
mFullSurfaceView.getHolder().addCallback(new SurfaceHolder.Callback() {
@Override
public void surfaceCreated(@NonNull SurfaceHolder holder) {
try {
//220419 komla
ArrayList<Surface> outputs = new ArrayList<>();
Collections.addAll(outputs, holder.getSurface());
// 当摄像头被打开之后，程序即可获取CameraDevice —— 即根据摄像头ID获取了指定摄像头设备，然后调用CameraDevice的
// createCaptureSession(List<Surface> outputs, CameraCaptureSession. StateCallback callback，Handler handler)
// 方法来创建CameraCaptureSession。
// 该方法的第一个参数是一个List集合，封装了所有需要从该摄像头获取图片的Surface，
// 第二个参数用于监听CameraCaptureSession的创建过程；
// 第三个参数代表执行callback的Handler，
// 如果程序希望直接在当前线程中执行callback，则可将handler参数设为null。
camera.createCaptureSession(outputs, new CameraCaptureSession.StateCallback() {
@Override
public void onConfigured(@NonNull CameraCaptureSession session) {
try {
// 不管预览还是拍照，程序都调用CameraDevice的createCaptureRequest(int templateType)方法创建CaptureRequest.Builder，
// 该方法支持TEMPLATE_PREVIEW（预览）、TEMPLATE_RECORD（拍摄视频）、TEMPLATE_STILL_CAPTURE（拍照）等参数。
CaptureRequest.Builder builder = camera.createCaptureRequest(TEMPLATE_PREVIEW);
// 通过第3步所调用方法返回的CaptureRequest.Builder设置拍照的各种参数，
// 比如对焦模式、曝光模式等。
builder.set(CaptureRequest.CONTROL_AF_MODE,CaptureRequest.CONTROL_AF_MODE_CONTINUOUS_PICTURE);
// CaptureRequest则由CameraDevice.createCaptureRequest（）创建的builder，
// 绑定目标surface后再builder（）出来
builder.addTarget(holder.getSurface());
// 调用CaptureRequest.Builder的build()方法即可得到CaptureRequest对象，
CaptureRequest captureRequest = builder.build();
// 接下来程序可通过CameraCaptureSession的setRepeatingRequest()方法开始预览，
// 或调用capture()方法拍照。
session.setRepeatingRequest(captureRequest, new CameraCaptureSession.CaptureCallback() {
@Override
public void onCaptureStarted(@NonNull CameraCaptureSession session,
@NonNull CaptureRequest request, long timestamp, long frameNumber) {
super.onCaptureStarted(session, request, timestamp, frameNumber);
}
@Override
public void onCaptureCompleted(@NonNull CameraCaptureSession session,
@NonNull CaptureRequest request, @NonNull TotalCaptureResult result) {
super.onCaptureCompleted(session, request, result);
}
@Override
public void onCaptureFailed(@NonNull CameraCaptureSession session,
@NonNull CaptureRequest request, @NonNull CaptureFailure failure) {
super.onCaptureFailed(session, request, failure);
}
}, mBgHandler);
} catch (CameraAccessException e) {
e.printStackTrace();
}
}
@Override
public void onConfigureFailed(@NonNull CameraCaptureSession session) {
}
}, mBgHandler);
} catch (CameraAccessException e) {
}
}
@Override
public void surfaceChanged(@NonNull SurfaceHolder holder, int format, int width, int height) {}
@Override
public void surfaceDestroyed(@NonNull SurfaceHolder holder) {}
});
}
@Override
public void onDisconnected(@NonNull CameraDevice camera) {}
@Override
public void onError(@NonNull CameraDevice camera, int error) {}
}, mBgHandler);
}
}
} catch (CameraAccessException ex) {
LogUtils.e(ex);
}
}
@Override
protected void onDestroy() {
super.onDestroy();
mBgHandler.removeCallbacksAndMessages(null);
mEyeThread.quitSafely();
}
}
四、踩坑
4.1 工程版本
因为最开始笔者创建的是安卓4工程，所以在使用Camera的时候，会默认导入Camera1这个包。5.0以下的工程，没什么事，可以正常使用，但是5.0以后的，就会提示，包及包方法已经废弃了，
4.2 Camera包
Camera 这里有一个坑，当默认导入包的时候，可能会导入
import android.graphics.Camera;这个不对，应该导入，
import android.hardware.Camera;原因自然也是版本的问题，具体的参考这篇博文 Android Camera2 教程 · 第一章 · 概览 - 简书
3435
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
