1. 配置权限
- AndroidManifext.xml文件：
<uses-permission android:name="android.permission.CAMERA" /> - android6.0以后的动态权限：网上很多教程，这里不再赘述。
2. 布局文件
很简单的布局，只有一个 TextureView 。
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".fragments.PreviewFragment">
<TextureView
android:id="@+id/ttv_camera"
android:layout_width="wrap_content"
android:layout_height="wrap_content" />
</RelativeLayout>
3. 实现预览
在具体实现编码之前，先简单介绍下相关的几个重要的类。
- CameraManager：相机管理类，可以用来遍历相机列表，获取相机配置类，打开相机等。
- CameraCharacteristics：相机配置类，用来获取相机的朝向/输出尺寸/格式等具体配置。
- CameraDevice：相机设备类，有很多参数（预览/拍照等等），主要用来创建相机会话（session）和请求（request）。
- CameraCaptureSession：相机捕获会话类，用于预览和拍照等。
- CaptureRequest：相机捕获请求类，用来定义输出缓冲区和显示界面。
3.1 初始化界面和 CameraManager
在 fragment 的 onViewCreated 声明周期方法中进行。
@Override
public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
previewView = view.findViewById(R.id.ttv_camera);
//初始化 CameraManager
cameraManager = (CameraManager) getActivity().getSystemService(Context.CAMERA_SERVICE);
}
3.2 设置预览TextureView状态监听
在 fragment 的 onResume 声明周期方法中对 TextureView 的状态进行监听，当其可用是会调用监听器的 onSurfaceTextureAvailable 方法，即可在该方法中启动相机。
@Override
public void onResume() {
super.onResume();
//设置 TextureView 的状态监听
previewView.setSurfaceTextureListener(new TextureView.SurfaceTextureListener() {
//TextureView 可用时调用改回调方法
@Override
public void onSurfaceTextureAvailable(SurfaceTexture surface, int width, int height) {
//TextureView 可用，启动相机
setupCamera();
}
@Override
public void onSurfaceTextureSizeChanged(SurfaceTexture surface, int width, int height) {
}
@Override
public boolean onSurfaceTextureDestroyed(SurfaceTexture surface) {
return false;
}
@Override
public void onSurfaceTextureUpdated(SurfaceTexture surface) {
}
});
}
3.3 启动相机
启动相机可以分为两个步骤： 配置相机相关参数，打开相机。
private void setupCamera() {
//配置相机参数（cameraId，previewSize）
configCamera();
//打开相机
openCamera();
}
配置相机相关参数（待打开的相机id，相机输出尺寸）。
- 获取相机列表，选择要打开的相机id。
- 获取选择相机的输出尺寸，配合预览窗口的尺寸，选择最合适的预览尺寸。
private void configCamera() {
try {
//遍历相机列表，使用前置相机
for (String cid : cameraManager.getCameraIdList()) {
//获取相机配置
CameraCharacteristics characteristics = cameraManager.getCameraCharacteristics(cid);
//使用后置相机
int facing = characteristics.get(CameraCharacteristics.LENS_FACING);//获取相机朝向
if (facing == CameraCharacteristics.LENS_FACING_FRONT) {
continue;
}
//获取相机输出格式/尺寸参数
StreamConfigurationMap configs = characteristics.get(CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP);
//打印相关参数（相机id，相机输出尺寸、设备屏幕尺寸、previewView尺寸）
printSizes(cid, configs);
//设定最佳预览尺寸
previewSize = setOptimalPreviewSize(configs.getOutputSizes(SurfaceTexture.class),
previewView.getMeasuredWidth(),
previewView.getMeasuredHeight());
//打印最佳预览尺寸
Log.d(TAG, "最佳预览尺寸（w-h）：" + previewSize.getWidth() + "-" + previewSize.getHeight());
cameraId = cid;
}
} catch (CameraAccessException e) {
e.printStackTrace();
}
}
private Size setOptimalPreviewSize(Size[] sizes, int previewViewWidth, int previewViewHeight) {
List<Size> bigEnoughSizes = new ArrayList<>();
List<Size> notBigEnoughSizes = new ArrayList<>();
for (Size size : sizes) {
if (size.getWidth() >= previewViewWidth && size.getHeight() >= previewViewHeight) {
bigEnoughSizes.add(size);
} else {
notBigEnoughSizes.add(size);
}
}
if (bigEnoughSizes.size() > 0) {
return Collections.min(bigEnoughSizes, new CompareSizesByArea());
} else if (notBigEnoughSizes.size() > 0) {
return Collections.max(notBigEnoughSizes, new CompareSizesByArea());
} else {
Log.d(TAG, "未找到合适的预览尺寸");
return sizes[0];
}
}
打开相机
- 调用
CameraManager.openCamera()方法打开相机。 - 第二个参数是相机设备状态监听，相机打开时会调用
onOpened()回调方法。 - 在
onOpened()回调方法中创建预览会话。（很重要）- 根据TextureView 和 选定的 previewSize 创建用于显示预览数据的Surface
- 调用
CameraDevice.createCaptureSession()方法创建捕获会话，第一个参数是捕获数据的输出Surface列表，第二个参数是CameraCaptureSession的状态回调接口，当它创建好后会回调onConfigured方法，第三个参数用来确定Callback在哪个线程执行，为null的话就在当前线程执行。 - 创建预览捕获请求，并设置会话进行重复请求，以获取连续的预览数据。
- 相机打开异常和断开连接后，需要释放相机资源。
private void openCamera() {
try {
//打开相机
cameraManager.openCamera(cameraId,
new CameraDevice.StateCallback() {
@Override
public void onOpened(CameraDevice camera) {
cameraDevice = camera;
//创建相机预览 session
createPreviewSession();
}
@Override
public void onDisconnected(CameraDevice camera) {
//释放相机资源
releseCamera();
}
@Override
public void onError(CameraDevice camera, int error) {
//释放相机资源
releseCamera();
}
},
null);
} catch (CameraAccessException e) {
e.printStackTrace();
}
}
private void createPreviewSession() {
//根据TextureView 和 选定的 previewSize 创建用于显示预览数据的Surface
SurfaceTexture surfaceTexture = previewView.getSurfaceTexture();
surfaceTexture.setDefaultBufferSize(previewSize.getWidth(), previewSize.getHeight());//设置SurfaceTexture缓冲区大小
final Surface previewSurface = new Surface(surfaceTexture);
try {
//创建预览session
cameraDevice.createCaptureSession(Arrays.asList(previewSurface),
new CameraCaptureSession.StateCallback() {
@Override
public void onConfigured(CameraCaptureSession session) {
try {
//构建预览捕获请求
CaptureRequest.Builder builder = cameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW);
builder.addTarget(previewSurface);//设置 previewSurface 作为预览数据的显示界面
CaptureRequest captureRequest = builder.build();
//设置重复请求，以获取连续预览数据
session.setRepeatingRequest(captureRequest, new CameraCaptureSession.CaptureCallback() {
@Override
public void onCaptureProgressed(CameraCaptureSession session, CaptureRequest request, CaptureResult partialResult) {
super.onCaptureProgressed(session, request, partialResult);
}
@Override
public void onCaptureCompleted(CameraCaptureSession session, CaptureRequest request, TotalCaptureResult result) {
super.onCaptureCompleted(session, request, result);
}
},
null);
} catch (CameraAccessException e) {
e.printStackTrace();
}
}
@Override
public void onConfigureFailed(CameraCaptureSession session) {
}
},
null);
} catch (CameraAccessException e) {
e.printStackTrace();
}
}
private void releseCamera() {
if (cameraDevice != null) {
cameraDevice.close();
cameraDevice = null;
}
}
4. 效果图
从下面效果图可以看到，相机预览的画面有变形，需要进一步处理。
相机竖向的效果图
相机竖向的效果图
相机横向的效果图
相机横向的效果图
5. 总结
本文实现了最基础的相机预览功能，重点放在梳理相机预览的关键步骤和相关类的使用。
针对画面拉伸变形的纠正以及横竖向布局切换的问题，后续文章进行实现。
