鸿蒙next版开发：相机开发-元数据(ArkTS)

2025/5/1 17:57:54 来源：https://blog.csdn.net/lbcyllqj/article/details/143753653 浏览: 次关键词：鸿蒙next版开发：相机开发-元数据(ArkTS)

在HarmonyOS 5.0中，ArkTS提供了对相机元数据的访问能力，这对于开发者在相机应用中获取图像的详细信息非常有用。元数据（Metadata）是对相机返回的图像信息数据的描述和上下文，比如照片或视频中识别人像的取景框坐标等信息。本文将详细介绍如何在ArkTS中获取和使用相机元数据，并提供代码示例进行详细解读。

相机元数据开发步骤

1. 导入相关接口

首先，需要导入相机相关的接口，以便使用相机服务。

import { camera } from '@kit.CameraKit';
import { BusinessError } from '@kit.BasicServicesKit';

2. 获取元数据输出流

通过CameraOutputCapability类的supportedMetadataObjectTypes属性获取当前设备支持的元数据类型，并通过createMetadataOutput方法创建元数据输出流。

function getMetadataOutput(cameraManager: camera.CameraManager, cameraOutputCapability: camera.CameraOutputCapability): camera.MetadataOutput | undefined {let metadataObjectTypes: Array<camera.MetadataObjectType> = cameraOutputCapability.supportedMetadataObjectTypes;let metadataOutput: camera.MetadataOutput | undefined;try {metadataOutput = cameraManager.createMetadataOutput(metadataObjectTypes);} catch (error) {let err = error as BusinessError;console.error(`Failed to createMetadataOutput, error code: ${err.code}`); // 引用[^7^]}return metadataOutput;
}

3. 开启元数据数据输出

调用Session.start方法开启元数据数据输出，再通过监听事件metadataObjectsAvailable回调拿到数据。

async function startMetadataOutput(previewOutput: camera.PreviewOutput, metadataOutput: camera.MetadataOutput, cameraManager: camera.CameraManager): Promise<void> {let cameraArray: Array<camera.CameraDevice> = [];cameraArray = cameraManager.getSupportedCameras();if (cameraArray.length == 0) {console.error('no camera.');return;}let sceneModes: Array<camera.SceneMode> = cameraManager.getSupportedSceneModes(cameraArray[0]);let isSupportPhotoMode: boolean = sceneModes.indexOf(camera.SceneMode.NORMAL_PHOTO) >= 0;if (!isSupportPhotoMode) {console.error('photo mode not support');return;}let cameraInput: camera.CameraInput | undefined = undefined;cameraInput = cameraManager.createCameraInput(cameraArray[0]);if (cameraInput === undefined) {console.error('cameraInput is undefined');return;}await cameraInput.open();let session: camera.PhotoSession = cameraManager.createSession(camera.SceneMode.NORMAL_PHOTO) as camera.PhotoSession;session.beginConfig();session.addInput(cameraInput);session.addOutput(previewOutput);session.addOutput(metadataOutput);await session.commitConfig();await session.start();
}

4. 监听元数据对象可用事件

在相机应用开发过程中，可以随时监听元数据对象可用事件。

function onMetadataObjectsAvailable(metadataOutput: camera.MetadataOutput): void {metadataOutput.on('metadataObjectsAvailable', (err: BusinessError, metadataObjectArr: Array<camera.MetadataObject>) => {if (err !== undefined && err.code !== 0) {return;}console.info('metadata output metadataObjectsAvailable');// 处理元数据对象...});
}

5. 停止输出元数据数据

调用Session.stop方法停止输出元数据数据。

function stopMetadataOutput(session: camera.Session): void {session.stop().then(() => {console.info('Callback returned with session stopped.');}).catch((err: BusinessError) => {console.error(`Failed to session stop, error code: ${err.code}`); // 引用[^7^]});
}