鸿蒙HarmonyOS开发实战—多媒体开发（相机开发 一）_arkts cameraconfig(1)

先自我介绍一下，小编浙江大学毕业，去过华为、字节跳动等大厂，目前阿里P7

深知大多数程序员，想要提升技能，往往是自己摸索成长，但自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年最新HarmonyOS鸿蒙全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上鸿蒙开发知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新

如果你需要这些资料，可以添加V获取：vip204888 （备注鸿蒙）

正文

调用getDeviceLinkType​(String physicalId)方法获取物理相机连接方式；

调用getCameraInfo(String cameraId)方法查询相机硬件朝向等信息；

调用getCameraAbility(String cameraId)方法查询相机能力信息（比如支持的分辨率列表等）。

CameraInfo的主要接口

接口名	描述
getDeviceLinkType​(String physicalId)	获取物理相机连接方式。
getFacingType​()	获取相机朝向信息。
getLogicalId​()	获取逻辑相机ID。
getPhysicalIdList​()	获取对应的物理相机ID列表。

CameraAbility的主要接口

接口名	描述
getSupportedSizes​(int format)	根据格式查询输出图像的分辨率列表。
getSupportedSizes​(Class clazz)	根据Class类型查询分辨率列表。
getParameterRange​(ParameterKey.Key parameter)	获取指定参数能够设置的值范围。
getPropertyValue​(PropertyKey.Key property)	获取指定属性对应的值。
getSupportedAeMode​()	获取当前相机支持的自动曝光模式。
getSupportedAfMode​()	获取当前相机支持的自动对焦模式。
getSupportedFaceDetection​()	获取相机支持的人脸检测类型范围。
getSupportedFlashMode​()	当前相机支持的闪光灯取值范围。
getSupportedParameters​()	当前相机支持的参数设置。
getSupportedProperties​()	获取当前相机的属性列表。
getSupportedResults​()	获取当前相机支持的参数设置可返回的结果列表。
getSupportedZoom​()	获取相机支持的变焦范围。

3. 通过createCamera(String cameraId, CameraStateCallback callback, EventHandler handler)方法，创建相机对象，此步骤执行成功意味着相机系统的硬件已经完成了上电。

// 前置相机类型
int frontCamera = CameraInfo.FacingType.CAMERA_FACING_FRONT;
// 后置相机类型
int backCamera = CameraInfo.FacingType.CAMERA_FACING_BACK;
// 其他相机类型
int otherCamera = CameraInfo.FacingType.CAMERA_FACING_OTHERS;

// 选择想要创建的相机类型，如果不存在该类型相机，则返回false
boolean isCameraCreated = openCameraByFacingType(frontCamera);

复制

// 根据类型创建相机的方法
private boolean openCameraByFacingType(int facingType) {
CameraKit cameraKit = CameraKit.getInstance(getApplicationContext());
for(String cameraId : cameraKit.getCameraIds()) {
CameraInfo cameraInfo = cameraKit.getCameraInfo(cameraId);
if(facingType == cameraInfo.getFacingType()) {
cameraKit.createCamera(cameraId, cameraStateCallback, eventHandler);
return true;
}
}
return false;
}

复制

参数cameraId可以是上一步获取的逻辑相机列表中的任何一个相机ID。

第二和第三个参数负责相机创建和相机运行时的数据和状态检测，请务必保证在整个相机运行周期内有效。

private final class CameraStateCallbackImpl extends CameraStateCallback {
@Override
public void onCreated(Camera camera) {
// 创建相机设备
}

@Override
public void onConfigured(Camera camera) {
// 配置相机设备
}

@Override
public void onPartialConfigured(Camera camera) {
// 当使用了addDeferredSurfaceSize配置了相机，会接到此回调
}

@Override
public void onReleased(Camera camera) {
// 释放相机设备
}
}

// 相机创建和相机运行时的回调
CameraStateCallbackImpl cameraStateCallback = new CameraStateCallbackImpl();

复制

import ohos.eventhandler.EventHandler;
import ohos.eventhandler.EventRunner;

// 执行回调的EventHandler
EventHandler eventHandler = new EventHandler(EventRunner.create(“CameraCb”));

复制

至此，相机设备的创建已经完成。相机设备创建成功会在CameraStateCallback中触发onCreated(Camera camera)回调。在进入相机设备配置前，请确保相机设备已经创建成功。否则会触发相机设备创建失败的回调，并返回错误码，需要进行错误处理后，重新执行相机设备的创建。

相机设备配置

创建相机设备成功后，在CameraStateCallback中会触发onCreated(Camera camera)回调，并且带回Camera对象，用于执行相机设备的操作。

当一个新的相机设备成功创建后，首先需要对相机进行配置，调用configure(CameraConfig)方法实现配置。相机配置主要是设置预览、拍照、录像用到的Surface(详见ohos.agp.graphics.Surface)，没有配置过Surface，相应的功能不能使用。

为了进行相机帧捕获结果的数据和状态检测，还需要在相机配置时调用setFrameStateCallback(FrameStateCallback, EventHandler)方法设置帧回调。

// Surface提供对象
private SurfaceProvider surfaceProvider;

private void initSurface() {
surfaceProvider = new SurfaceProvider(this);
DirectionalLayout.LayoutConfig params = new DirectionalLayout.LayoutConfig(
ComponentContainer.LayoutConfig.MATCH_PARENT, ComponentContainer.LayoutConfig.MATCH_PARENT);
surfaceProvider.setLayoutConfig(params);
surfaceProvider.pinToZTop(false);
surfaceProvider.getSurfaceOps().get().addCallback(new SurfaceCallBack());
((ComponentContainer)
findComponentById(ResourceTable.Id_surface_container)).addComponent(surfaceProvider);
}

private FrameStateCallback frameStateCallbackImpl = new FrameStateCallback(){
@Override
public void onFrameStarted(Camera camera, FrameConfig frameConfig, long frameNumber, long timestamp) {
…
}
@Override
public void onFrameProgressed(Camera camera, FrameConfig frameConfig, FrameResult frameResult) {
…
}
@Override
public void onFrameFinished(Camera camera, FrameConfig frameConfig, FrameResult frameResult) {
…
}
@Override
public void onFrameError(Camera camera, FrameConfig frameConfig, int errorCode, FrameResult frameResult) {
…
}
@Override
public void onCaptureTriggerStarted(Camera camera, int captureTriggerId, long firstFrameNumber) {
…
}
@Override
public void onCaptureTriggerFinished(Camera camera, int captureTriggerId, long lastFrameNumber) {
…
}
@Override
public void onCaptureTriggerInterrupted(Camera camera, int captureTriggerId) {
…
}
};

// 相机设备
private Camera cameraDevice;
// 相机预览模板
private Surface previewSurface;
// 相机配置模板
private CameraConfig.Builder cameraConfigBuilder;
// 图像帧数据接收处理对象
private ImageReceiver imageReceiver;

private final class CameraStateCallbackImpl extends CameraStateCallback {
@Override
public void onCreated(Camera camera) {
cameraDevice = camera;
previewSurface = surfaceProvider.getSurfaceOps().get().getSurface();
cameraConfigBuilder = camera.getCameraConfigBuilder();
if (cameraConfigBuilder == null) {
HiLog.error(LABEL, “onCreated cameraConfigBuilder is null”);
return;
}
// 配置预览的Surface
cameraConfigBuilder.addSurface(previewSurface);
// 配置拍照的Surface
cameraConfigBuilder.addSurface(imageReceiver.getRecevingSurface());
// 配置帧结果的回调
cameraConfigBuilder.setFrameStateCallback(frameStateCallbackImpl, eventHandler);
try {
// 相机设备配置
camera.configure(cameraConfigBuilder.build());
} catch (IllegalArgumentException e) {
HiLog.error(LABEL, “Argument Exception”);
} catch (IllegalStateException e) {
HiLog.error(LABEL, “State Exception”);
}
}
}

复制

相机配置成功后，在CameraStateCallback中会触发onConfigured(Camera camera)回调，然后才可以执行相机帧捕获相关的操作。

CameraConfig.Builder的主要接口

接口名	描述
addSurface​(Surface surface)	相机配置中增加Surface。
build​()	相机配置的构建类。
removeSurface​(Surface surface)	移除先前添加的Surface。
setFrameStateCallback​(FrameStateCallback callback, EventHandler handler)	设置用于相机帧结果返回的FrameStateCallback和Handler。
addDeferredSurfaceSize(Size surfaceSize, Class clazz)	添加延迟Surface的尺寸、类型。
addDeferredSurface(Surface surface)	设置延迟的Surface，此Surface的尺寸和类型必须和使用addDeferredSurfaceSize配置的一致。

---

最后，为了能让大家更好的去学习提升鸿蒙 (Harmony OS) 开发技术，小编连夜整理了一份30个G纯血版学习资料（含视频、电子书、学习文档等）以及一份在Github上持续爆火霸榜的《纯血版华为鸿蒙 (Harmony OS)开发手册》（共计890页），希望对大家有所帮助。

纯血版鸿蒙 HarmonyOS 4.0 视频学习资料

需要以上视频学习资料小伙伴

请点击→纯血版全套鸿蒙HarmonyOS学习资料

---

《纯血版华为鸿蒙 (Harmony OS)开发手册》

这份手册涵盖了当前鸿蒙 (Harmony OS) 开发技术必掌握的核心知识点

纯血版鸿蒙 (Harmony OS)开发手册部分精彩内容

HarmonyOS 概念：

• 系统定义
• 技术架构
• 技术特性
• 系统安全

如何快速入门？

• 基本概念
• 构建第一个ArkTS应用

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加V获取：vip204888 （备注鸿蒙）

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

4d7db5a414156dc9a832.png)

如何快速入门？

• 基本概念
• 构建第一个ArkTS应用

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以添加V获取：vip204888 （备注鸿蒙）
[外链图片转存中…(img-qY0mLJ0p-1713655040209)]

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！