鸿蒙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^]
  });
}