鸿蒙HarmonyOS开发实战—多媒体开发（相机开发二，2024年最新HarmonyOS鸿蒙framework视频

本文链接：https://blog.csdn.net/m0_57502067/article/details/137636108

接口名	描述
triggerSingleCapture(FrameConfig frameConfig)	启动相机帧的单帧捕获。
triggerMultiCapture(List frameConfigs)	启动相机帧的多帧捕获。
configure(CameraConfig config)	配置相机。
flushCaptures()	停止并清除相机帧的捕获，包括循环帧/单帧/多帧捕获。
getCameraConfigBuilder()	获取相机配置构造器对象。
getCameraId()	获取当前相机的ID。
getFrameConfigBuilder(int type)	获取指定类型的相机帧配置构造器对象。
release()	释放相机对象及资源。
triggerLoopingCapture(FrameConfig frameConfig)	启动或者更新相机帧的循环捕获。
stopLoopingCapture()	停止当前相机帧的循环捕获。

启动预览（循环帧捕获）

用户一般都是先看见预览画面才执行拍照或者其他功能，所以对于一个普通的相机应用，预览是必不可少的。启动预览的建议步骤如下：

通过getFrameConfigBuilder(FRAME_CONFIG_PREVIEW)方法获取预览配置模板，常用帧配置项见下表，更多的帧配置项以及详细使用方法请参考API接口说明的FrameConfig.Builder部分。

接口名	描述	是否必选
addSurface(Surface surface)	配置预览surface和帧的绑定。	是
setAfMode(int afMode, Rect rect)	配置对焦模式。	否
setAeMode(int aeMode, Rect rect)	配置曝光模式。	否
setZoom(float value)	配置变焦值。	否
setFlashMode(int flashMode)	配置闪光灯模式。	否
setFaceDetection(int type, boolean isEnable)	配置人脸检测或者笑脸检测。	否
setParameter(Key key, T value)	配置其他属性（如自拍镜像等）。	否
setMark(Object mark)	配置一个标签，后续可以从FrameConfig中通过Object getMark()拿到标签，判断两个是否相等，相等就说明是同一个配置。	否
setCoordinateSurface(Surface surface)	配置坐标系基准Surface，后续计算Ae/Af等区域都会基于此Surface为基本的中心坐标系，不设置默认使用添加的第一个Surface。	否

通过triggerLoopingCapture(FrameConfig)方法实现循环帧捕获(如预览/录像)。

private final class CameraStateCallbackImpl extends CameraStateCallback {
@Override
public void onConfigured(Camera camera) {
// 获取预览配置模板
frameConfigBuilder = camera.getFrameConfigBuilder(FRAME_CONFIG_PREVIEW);
// 配置预览Surface
frameConfigBuilder.addSurface(previewSurface);
previewFrameConfig = frameConfigBuilder.build();
try {
// 启动循环帧捕获
int triggerId = camera.triggerLoopingCapture(previewFrameConfig);
} catch (IllegalArgumentException e) {
HiLog.error(LABEL, “Argument Exception”);
} catch (IllegalStateException e) {
HiLog.error(LABEL, “State Exception”);
}
}
}

复制

经过以上的操作，相机应用已经可以正常进行实时预览了。在预览状态下，开发者还可以执行其他操作，比如：

当预览帧配置更改时，可以通过triggerLoopingCapture(FrameConfig)方法实现预览帧配置的更新；

// 预览帧变焦值变更
frameConfigBuilder.setZoom(1.2f);
// 调用triggerLoopingCapture方法实现预览帧配置更新
triggerLoopingCapture(frameConfigBuilder.build());

复制

通过stopLoopingCapture()方法停止循环帧捕获(停止预览)。

// 停止预览帧捕获
camera.stopLoopingCapture()

复制

实现拍照（单帧捕获）

拍照功能属于相机应用的最重要功能之一，而且照片质量对用户至关重要。相机模块基于相机复杂的逻辑，从应用接口层到器件驱动层都已经默认的做好了最适合用户的配置，这些默认配置尽可能地保证用户拍出的每张照片的质量。发起拍照的建议步骤如下：

通过getFrameConfigBuilder(FRAME_CONFIG_PICTURE)方法获取拍照配置模板，并且设置拍照帧配置，如下表

接口名	描述	是否必选
FrameConfig.Builder addSurface(Surface)	实现拍照Surface和帧的绑定。	必选
FrameConfig.Builder setImageRotation(int)	设置图片旋转角度。	可选
FrameConfig.Builder setLocation(Location)	设置图片地理位置信息。	可选
FrameConfig.Builder setParameter(Key, T)	配置其他属性（如自拍镜像等）。	可选

2. 拍照前准备图像帧数据的接收实现

// 图像帧数据接收处理对象
private ImageReceiver imageReceiver;
// 执行回调的EventHandler
private EventHandler eventHandler = new EventHandler(EventRunner.create(“CameraCb”));
// 拍照支持分辨率
private Size pictureSize;

// 单帧捕获生成图像回调Listener
private final ImageReceiver.IImageArrivalListener imageArrivalListener = new ImageReceiver.IImageArrivalListener() {
@Override
public void onImageArrival(ImageReceiver imageReceiver) {
StringBuffer fileName = new StringBuffer(“picture_”);
fileName.append(UUID.randomUUID()).append(“.jpg”); // 定义生成图片文件名
File myFile = new File(dirFile, fileName.toString()); // 创建图片文件
imageSaver = new ImageSaver(imageReceiver.readNextImage(), myFile); // 创建一个读写线程任务用于保存图片
eventHandler.postTask(imageSaver); // 执行读写线程任务生成图片
}
};

// 保存图片, 图片数据读写，及图像生成见run方法
class ImageSaver implements Runnable {
private final Image myImage;
private final File myFile;

ImageSaver(Image image, File file) {
myImage = image;
myFile = file;
}

@Override
public void run() {
Image.Component component = myImage.getComponent(ImageFormat.ComponentType.JPEG);
byte[] bytes = new byte[component.remaining()];
component.read(bytes);
FileOutputStream output = null;
try {
output = new FileOutputStream(myFile);
output.write(bytes); // 写图像数据
} catch (IOException e) {
HiLog.error(LABEL, “save picture occur exception!”);
} finally {
if (output != null) {
try {
output.close(); // 关闭流
} catch (IOException e) {
HiLog.error(LABEL, “image release occur exception!”);
}
}
myImage.release();
}
}
}
private void takePictureInit() {
List pictureSizes = cameraAbility.getSupportedSizes(ImageFormat.JPEG); // 获取拍照支持分辨率列表
pictureSize = getPictureSize(pictureSizes) // 根据拍照要求选择合适的分辨率
imageReceiver = ImageReceiver.create(Math.max(pictureSize.width, pictureSize.height),
Math.min(pictureSize.width, pictureSize.height), ImageFormat.JPEG, 5); // 创建ImageReceiver对象，注意create函数中宽度要大于高度；5为最大支持的图像数，请根据实际设置。
imageReceiver.setImageArrivalListener(imageArrivalListener);
}

复制

3. 通过triggerSingleCapture(FrameConfig)方法实现单帧捕获(如拍照)。

private void capture() {
// 获取拍照配置模板
framePictureConfigBuilder = cameraDevice.getFrameConfigBuilder(FRAME_CONFIG_PICTURE);
// 配置拍照Surface
framePictureConfigBuilder.addSurface(imageReceiver.getRecevingSurface());
// 配置拍照其他参数
framePictureConfigBuilder.setImageRotation(90);
try {
// 启动单帧捕获(拍照)
cameraDevice.triggerSingleCapture(framePictureConfigBuilder.build());
} catch (IllegalArgumentException e) {
HiLog.error(LABEL, “Argument Exception”);
} catch (IllegalStateException e) {
HiLog.error(LABEL, “State Exception”);
}
}