1# 相机管理 (C/C++)
2
3在开发一个相机应用前，需要先通过调用相机接口来创建一个独立的相机设备。
4
5## 开发步骤
6
7详细的API说明请参考[Camera API参考](../../reference/apis-camera-kit/_o_h___camera.md)。
8
91. 导入NDK接口。选择系统提供的NDK接口能力，导入NDK接口的方法如下。
10
11   ```c++
12    // 导入NDK接口头文件
13    #include "hilog/log.h"
14    #include "ohcamera/camera.h"
15    #include "ohcamera/camera_input.h"
16    #include "ohcamera/capture_session.h"
17    #include "ohcamera/photo_output.h"
18    #include "ohcamera/preview_output.h"
19    #include "ohcamera/video_output.h"
20    #include "ohcamera/camera_manager.h"
21   ```
22
232. 在CMake脚本中链接相关动态库。
24
25   ```txt
26    target_link_libraries(entry PUBLIC libohcamera.so libhilog_ndk.z.so)
27   ```
28
293. 通过[OH_Camera_GetCameraManager()](../../reference/apis-camera-kit/_o_h___camera.md#oh_camera_getcameramanager)方法，获取cameraManager对象。
30
31   ```c++
32   Camera_Manager *cameraManager = nullptr;
33   Camera_Input* cameraInput = nullptr;
34   Camera_Device* cameras = nullptr;
35   uint32_t size = 0;
36   uint32_t cameraDeviceIndex = 0;
37   // 创建CameraManager对象
38   Camera_ErrorCode ret = OH_Camera_GetCameraManager(&cameraManager);
39   if (cameraManager == nullptr || ret != CAMERA_OK) {
40      OH_LOG_ERROR(LOG_APP, "OH_Camera_GetCameraManager failed.");
41   }
42   ```
43
44   > **说明：**
45   >
46   > 如果获取对象失败，说明相机可能被占用或无法使用。如果被占用，须等到相机被释放后才能重新获取。
47
484. 通过[OH_CameraManager_GetSupportedCameras()](../../reference/apis-camera-kit/_o_h___camera.md#oh_cameramanager_getsupportedcameras)方法，获取当前设备支持的相机列表，列表中存储了设备支持的所有相机ID。若列表不为空，则说明列表中的每个ID都支持独立创建相机对象；否则，说明当前设备无可用相机，不可继续后续操作。
49
50   ```c++
51   // 获取相机列表
52   ret = OH_CameraManager_GetSupportedCameras(cameraManager, &cameras, &size);
53   if (cameras == nullptr || size < 0 || ret != CAMERA_OK) {
54      OH_LOG_ERROR(LOG_APP, "OH_CameraManager_GetSupportedCameras failed.");
55   }
56   for (int index = 0; index < size; index++) {
57      OH_LOG_INFO(LOG_APP, "cameraId  =  %{public}s ", cameras[index].cameraId);              // 获取相机ID
58      OH_LOG_INFO(LOG_APP, "cameraPosition  =  %{public}d ", cameras[index].cameraPosition);  // 获取相机位置
59      OH_LOG_INFO(LOG_APP, "cameraType  =  %{public}d ", cameras[index].cameraType);          // 获取相机类型
60      OH_LOG_INFO(LOG_APP, "connectionType  =  %{public}d ", cameras[index].connectionType);  // 获取相机连接类型
61   }
62   ```
63
64
65## 状态监听
66
67在相机应用开发过程中，可以随时监听相机状态，包括新相机的出现、相机的移除、相机的可用状态。在回调函数中，通过相机ID、相机状态这两个参数进行监听，如当有新相机出现时，可以将新相机加入到应用的备用相机中。
68
69  通过注册cameraStatus事件，通过回调返回监听结果，callback返回Camera_StatusInfo参数，参数的具体内容可参考相机管理器回调接口实例[Camera_StatusInfo](../../reference/apis-camera-kit/_camera___status_info.md)。
70
71   ```c++
72   ret = OH_CameraManager_RegisterCallback(cameraManager, GetCameraManagerListener());
73   if (ret != CAMERA_OK) {
74      OH_LOG_ERROR(LOG_APP, "OH_CameraManager_RegisterCallback failed.");
75   }
76   ```
77   ```c++
78   void CameraManagerStatusCallback(Camera_Manager* cameraManager, Camera_StatusInfo* status)
79   {
80      OH_LOG_INFO(LOG_APP, "CameraManagerStatusCallback is called");
81   }
82   CameraManager_Callbacks* GetCameraManagerListener()
83   {
84      static CameraManager_Callbacks cameraManagerListener = {
85         .onCameraStatus = CameraManagerStatusCallback
86      };
87      return &cameraManagerListener;
88   }
89   ```