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