前言:书接上回,上篇文章介绍了安卓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 教程 · 第一章 · 概览 - 简书