• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 元数据(C/C++)
2
3元数据（Metadata）是对相机返回的图像信息数据的描述和上下文，针对图像信息，提供的更详细的数据，如照片或视频中，识别人像的取景框坐标等信息。
4
5Metadata主要是通过一个TAG（Key），去找对应的Data，用于传递参数和配置信息，减少内存拷贝操作。
6
7## 开发步骤
8
9详细的API说明请参考[Camera API参考](../../reference/apis-camera-kit/_o_h___camera.md)。
10
111. 导入NDK接口，导入方法如下。
12
13   ```c++
14   // 导入NDK接口头文件。
15   #include "hilog/log.h"
16   #include "ohcamera/camera.h"
17   #include "ohcamera/camera_input.h"
18   #include "ohcamera/capture_session.h"
19   #include "ohcamera/photo_output.h"
20   #include "ohcamera/preview_output.h"
21   #include "ohcamera/video_output.h"
22   #include "ohcamera/camera_manager.h"
23   ```
24
252. 在CMake脚本中链接相关动态库。
26
27   ```txt
28   target_link_libraries(entry PUBLIC
29       libace_napi.z.so
30       libohcamera.so
31       libhilog_ndk.z.so
32   )
33   ```
34
353. 调用OH_CameraManager_GetSupportedCameraOutputCapability()方法，获取当前设备支持的元数据类型metaDataObjectType，并通过OH_CameraManager_CreateMetadataOutput()方法创建元数据输出流。
36
37   ```c++
38   Camera_MetadataOutput* CreateMetadataOutput(Camera_Manager* cameraManager,
39       Camera_OutputCapability* cameraOutputCapability)
40   {
41       Camera_MetadataOutput* metadataOutput = nullptr;
42       if (cameraOutputCapability->supportedMetadataObjectTypes == nullptr) {
43           return metadataOutput;
44       }
45       Camera_MetadataObjectType* metaDataObjectType = nullptr;
46       bool isSupported = false;
47       for (int index = 0; index < cameraOutputCapability->metadataProfilesSize; index++) {
48           if (cameraOutputCapability->supportedMetadataObjectTypes[index] != nullptr &&
49               *cameraOutputCapability->supportedMetadataObjectTypes[index] == FACE_DETECTION) {
50               metaDataObjectType = *cameraOutputCapability->supportedMetadataObjectTypes;
51               isSupported = true;
52               break;
53           }
54       }
55       if (!isSupported || metaDataObjectType == nullptr) {
56           OH_LOG_ERROR(LOG_APP, "FACE_DETECTION is not supported.");
57           return metadataOutput;
58       }
59
60       Camera_ErrorCode ret = OH_CameraManager_CreateMetadataOutput(cameraManager, metaDataObjectType, &metadataOutput);
61       if (metadataOutput == nullptr || ret != CAMERA_OK) {
62           OH_LOG_ERROR(LOG_APP, "CreateMetadataOutput failed.");
63       }
64       return metadataOutput;
65   }
66   ```
67
684. 调用start()方法输出metadata数据，接口调用失败时，会返回相应错误码。
69
70   ```c++
71   Camera_ErrorCode StartMetadataOutput(Camera_MetadataOutput* metadataOutput)
72   {
73       Camera_ErrorCode ret = OH_MetadataOutput_Start(metadataOutput);
74       if (ret != CAMERA_OK) {
75           OH_LOG_ERROR(LOG_APP, "OH_MetadataOutput_Start failed.");
76       }
77       return ret;
78   }
79   ```
80
815. 调用stop()方法停止输出metadata数据，接口调用失败会返回相应错误码。
82
83   ```c++
84   Camera_ErrorCode StopMetadataOutput(Camera_MetadataOutput* metadataOutput)
85   {
86       Camera_ErrorCode ret = OH_MetadataOutput_Stop(metadataOutput);
87       if (ret != CAMERA_OK) {
88           OH_LOG_ERROR(LOG_APP, "OH_MetadataOutput_Stop failed.");
89       }
90       return ret;
91   }
92   ```
93
94## 状态监听
95
96在相机应用开发过程中，可以随时监听metadata数据以及输出流的状态。
97
98- 通过注册监听获取metadata对象，监听事件固定为metadataObjectsAvailable。检测到有效metadata数据时，callback返回相应的metadata数据信息，metadataOutput创建成功时可监听。
99  ```c++
100  void OnMetadataObjectAvailable(Camera_MetadataOutput* metadataOutput,
101      Camera_MetadataObject* metadataObject, uint32_t size)
102  {
103      OH_LOG_INFO(LOG_APP, "size = %{public}d", size);
104  }
105  ```
106
107  > **说明：**
108  >
109  > 当前的元数据类型仅支持人脸检测（FACE_DETECTION）功能。元数据信息对象为识别到的人脸区域的矩形信息（Rect），包含矩形区域的左上角x坐标、y坐标和矩形的宽高数据。
110
111- 通过注册回调函数，获取监听metadata流的错误结果，callback返回metadata输出接口使用错误时返回的错误码，错误码类型参见[Camera_ErrorCode](../../reference/apis-camera-kit/_o_h___camera.md#camera_errorcode-1)。
112
113  ```c++
114  void OnMetadataOutputError(Camera_MetadataOutput* metadataOutput, Camera_ErrorCode errorCode)
115  {
116      OH_LOG_INFO(LOG_APP, "OnMetadataOutput errorCode = %{public}d", errorCode);
117  }
118  ```
119  ```c++
120  MetadataOutput_Callbacks* GetMetadataOutputListener(void)
121  {
122      static MetadataOutput_Callbacks metadataOutputListener = {
123          .onMetadataObjectAvailable = OnMetadataObjectAvailable,
124          .onError = OnMetadataOutputError
125      };
126      return &metadataOutputListener;
127  }
128  Camera_ErrorCode RegisterMetadataOutputCallback(Camera_MetadataOutput* metadataOutput)
129  {
130      Camera_ErrorCode ret = OH_MetadataOutput_RegisterCallback(metadataOutput, GetMetadataOutputListener());
131      if (ret != CAMERA_OK) {
132          OH_LOG_ERROR(LOG_APP, "OH_MetadataOutput_RegisterCallback failed.");
133      }
134      return ret;
135  }
136  ```