相机管理 (C/C++)
============

在开发一个相机应用前，需要先通过调用相机接口来创建一个独立的相机设备。

#### 开发步骤

详细的API说明请参考[OH\_Camera](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera)。

1.  导入NDK接口。选择系统提供的NDK接口能力，导入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"
    
2.  在CMake脚本中链接相关动态库。
    
    target\_link\_libraries(entry PUBLIC
        libace\_napi.z.so
        libohcamera.so
        libhilog\_ndk.z.so
    )
    
3.  通过[OH\_Camera\_GetCameraManager()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-h#oh_camera_getcameramanager)方法，获取cameraManager对象。
    
    Camera\_ErrorCode CreateCameraManager(Camera\_Manager\*\* cameraManager)
    {
        // 创建CameraManager对象。
        Camera\_ErrorCode ret = OH\_Camera\_GetCameraManager(cameraManager);
        if (\*cameraManager == nullptr || ret != CAMERA\_OK) {
           OH\_LOG\_ERROR(LOG\_APP, "OH\_Camera\_GetCameraManager failed.");
        }
        return ret;
    }
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ec/v3/zuI-MKDPSYKI4EHKTqdH-w/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073515Z&HW-CC-Expire=86400&HW-CC-Sign=769A77BEED0AC9D0333A0B2C8ECACDD73B2384EF47039DEB0A749A5E13E544A7)
    
    如果获取对象失败，说明相机可能被占用或无法使用。如果被占用，须等到相机被释放后才能重新获取。
    
4.  通过[OH\_CameraManager\_GetSupportedCameras()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-manager-h#oh_cameramanager_getsupportedcameras)方法，获取当前设备支持的相机列表，列表中存储了设备支持的所有相机ID。若列表不为空，则说明列表中的每个ID都支持独立创建相机对象；否则，说明当前设备无可用相机，无法进行后续操作。
    
    Camera\_ErrorCode GetSupportedCameras(Camera\_Manager\* cameraManager, Camera\_Device\*\* cameras, uint32\_t &size)
    {
        // 获取相机列表。
        Camera\_ErrorCode ret = OH\_CameraManager\_GetSupportedCameras(cameraManager, cameras, &size);
        if (cameras == nullptr || size == 0 || ret != CAMERA\_OK) {
           OH\_LOG\_ERROR(LOG\_APP, "OH\_CameraManager\_GetSupportedCameras failed.");
        }
        // 在不使用cameras时，需要调用OH\_CameraManager\_DeleteSupportedCameras()方法释放相机列表并置空指针防止内存泄漏。
        for (uint32\_t index = 0; index < size; index++) {
           OH\_LOG\_INFO(LOG\_APP, "cameraId  =  %{public}s ", (\*cameras)\[index\].cameraId);              // 获取相机ID。
           OH\_LOG\_INFO(LOG\_APP, "cameraPosition  =  %{public}d ", (\*cameras)\[index\].cameraPosition);  // 获取相机位置。
           OH\_LOG\_INFO(LOG\_APP, "cameraType  =  %{public}d ", (\*cameras)\[index\].cameraType);          // 获取相机类型。
           OH\_LOG\_INFO(LOG\_APP, "connectionType  =  %{public}d ", (\*cameras)\[index\].connectionType);  // 获取相机连接类型。
        }
        return ret;
    }
    

#### 状态监听

在相机应用开发过程中，可以随时监听相机状态，包括新相机的出现、相机的移除、相机的可用状态。在回调函数中，通过相机ID、相机状态这两个参数进行监听，如当有新相机出现时，可以将新相机加入到应用的备用相机中。

通过[OH\_CameraManager\_RegisterCallback()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-manager-h#oh_cameramanager_registercallback)注册cameraStatus事件，通过回调返回监听结果，callback返回Camera\_StatusInfo参数，参数的具体内容可参考相机管理器回调接口实例[Camera\_StatusInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera-camera-statusinfo)。

void CameraStatusCallback(Camera\_Manager\* cameraManager, Camera\_StatusInfo\* status)
{
   OH\_LOG\_INFO(LOG\_APP, "CameraStatusCallback is called");
}
CameraManager\_Callbacks\* GetCameraManagerListener()
{
   static CameraManager\_Callbacks cameraManagerListener = {
      .onCameraStatus = CameraStatusCallback
   };
   return &cameraManagerListener;
}

Camera\_ErrorCode RegisterCameraStatusCallback(Camera\_Manager &cameraManager)
{
    Camera\_ErrorCode ret = OH\_CameraManager\_RegisterCallback(&cameraManager, GetCameraManagerListener());
    if (ret != CAMERA\_OK) {
       OH\_LOG\_ERROR(LOG\_APP, "OH\_CameraManager\_RegisterCallback failed.");
    }
    return ret;
}