鸿蒙（API 12 Beta3版）【预览(C/C++)】媒体相机开发指导

移动开发技术栈

于 2024-08-19 14:23:22 发布

阅读量381

点赞数 19

分类专栏：鸿蒙开发文章标签： harmonyos c语言 openharmony 媒体音视频鸿蒙系统 c++

本文链接：https://blog.csdn.net/m0_70748845/article/details/141324353

版权

鸿蒙开发专栏收录该内容

409 篇文章 10 订阅

订阅专栏

预览是启动相机后看见的画面，通常在拍照和录像前执行。

开发步骤

导入NDK接口，接口中提供了相机相关的属性和方法，导入方法如下。

 // 导入NDK接口头文件
 #include "hilog/log.h"
 #include "ohcamera/camera.h"
 #include "ohcamera/camera_input.h"
 #include "ohcamera/capture_session.h"
 #include "ohcamera/photo_output.h"
 #include "ohcamera/preview_output.h"
 #include "ohcamera/video_output.h"
 #include "ohcamera/camera_manager.h"

在CMake脚本中链接相关动态库。

target_link_libraries(entry PUBLIC libohcamera.so libhilog_ndk.z.so)

获取SurfaceId。

XComponent组件为预览流提供的SurfaceId，而XComponent的能力由UI提供，相关介绍可参考[XComponent组件参考]
根据传入的SurfaceId，通过OH_CameraManager_GetSupportedCameraOutputCapability()方法获取当前设备支持的预览能力。通过OH_CameraManager_CreatePreviewOutput()方法创建预览输出流，其中，OH_CameraManager_CreatePreviewOutput()方法中的参数分别是cameraManager指针，previewProfiles数组中的第一项，步骤三中获取的surfaceId，以及返回的previewOutput指针。

  NDKCamera::NDKCamera(char *str)
  {
    Camera_Manager *cameraManager = nullptr;
    Camera_Device* cameras = nullptr;
    Camera_OutputCapability* cameraOutputCapability = nullptr;
    Camera_PreviewOutput* previewOutput = nullptr;
    const Camera_Profile* previewProfile = nullptr;
    uint32_t size = 0;
    uint32_t cameraDeviceIndex = 0;
    char* previewSurfaceId = str;
    Camera_ErrorCode ret = OH_Camera_GetCameraManager(&cameraManager);
    if (cameraManager == nullptr || ret != CAMERA_OK) {
      OH_LOG_ERROR(LOG_APP, "OH_Camera_GetCameraManager failed.");
    }
    ret = OH_CameraManager_GetSupportedCameras(cameraManager, &cameras, &size);
    if (cameras == nullptr || size < 0 || ret != CAMERA_OK) {
      OH_LOG_ERROR(LOG_APP, "OH_CameraManager_GetSupportedCameras failed.");
    }
    ret = OH_CameraManager_GetSupportedCameraOutputCapability(cameraManager, &cameras[cameraDeviceIndex],
                                                                    &cameraOutputCapability);
    if (cameraOutputCapability == nullptr || ret != CAMERA_OK) {
      OH_LOG_ERROR(LOG_APP, "OH_CameraManager_GetSupportedCameraOutputCapability failed.");
    }
    if (cameraOutputCapability->previewProfilesSize < 0) {
      OH_LOG_ERROR(LOG_APP, "previewProfilesSize == null");
    }
    previewProfile = cameraOutputCapability->previewProfiles[0];
    ret = OH_CameraManager_CreatePreviewOutput(cameraManager, previewProfile, previewSurfaceId, &previewOutput);
    if (previewProfile == nullptr || previewOutput == nullptr || ret != CAMERA_OK) {
      OH_LOG_ERROR(LOG_APP, "OH_CameraManager_CreatePreviewOutput failed.");
    }
  }

使能。当session完成CommitConfig后通过调用start()方法输出预览流，接口调用失败会返回相应错误码，错误码类型参见[Camera_ErrorCode]

 ret = OH_PreviewOutput_Start(previewOutput);
 if (ret != CAMERA_OK) {
     OH_LOG_ERROR(LOG_APP, "OH_PreviewOutput_Start failed.");
 }

通过stop()方法停止预览流，接口调用失败会返回相应错误码，错误码类型参见[Camera_ErrorCode]

 ret = OH_PreviewOutput_Stop(previewOutput);
 if (ret != CAMERA_OK) {
     OH_LOG_ERROR(LOG_APP, "OH_PreviewOutput_Stop failed.");
 }

状态监听

在相机应用开发过程中，可以随时监听预览输出流状态，包括预览流启动、预览流结束、预览流输出错误。

通过注册固定的frameStart回调函数获取监听预览启动结果，previewOutput创建成功时即可监听，预览第一次曝光时触发，有该事件返回结果则认为预览流已启动。

  ret = OH_PreviewOutput_RegisterCallback(previewOutput, GetPreviewOutputListener());
  if (ret != CAMERA_OK) {
      OH_LOG_ERROR(LOG_APP, "OH_PreviewOutput_RegisterCallback failed.");
  }

  void PreviewOutputOnFrameStart(Camera_PreviewOutput* previewOutput)
  {
      OH_LOG_INFO(LOG_APP, "PreviewOutputOnFrameStart");
  }
  PreviewOutput_Callbacks* GetPreviewOutputListener(void)
  {
      static PreviewOutput_Callbacks previewOutputListener = {
          .onFrameStart = PreviewOutputOnFrameStart,
          .onFrameEnd = PreviewOutputOnFrameEnd,
          .onError = PreviewOutputOnError
      };
      return &previewOutputListener;
  }

通过注册固定的frameEnd回调函数获取监听预览结束结果，previewOutput创建成功时即可监听，预览完成最后一帧时触发，有该事件返回结果则认为预览流已结束。

  void PreviewOutputOnFrameEnd(Camera_PreviewOutput* previewOutput, int32_t frameCount)
  {
      OH_LOG_INFO(LOG_APP, "PreviewOutput frameCount = %{public}d", frameCount);
  }

通过注册固定的error回调函数获取监听预览输出错误结果，callback返回预览输出接口使用错误时对应的错误码，错误码类型参见[Camera_ErrorCode]

  void PreviewOutputOnError(Camera_PreviewOutput* previewOutput, Camera_ErrorCode errorCode)
  {
      OH_LOG_INFO(LOG_APP, "PreviewOutput errorCode = %{public}d", errorCode);
  }

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

在这里插入图片描述