预览(C/C++)
预览是启动相机后看见的画面,通常在拍照和录像前执行。
开发步骤
详细的API说明请参考Camera API参考。
-
导入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); }