多摄同开(C/C++)

从API version 18开始支持多摄同开，即应用可同时开启前置和后置相机进行拍照和录像。

说明：

由于多摄同开需要前置/后置相机同时运行，所以对于相机功能有较大限制。当前版本仅支持以下七项基础功能，请勿对多摄同开开启的相机进行超出以下七种基础功能范围之外的查询、设置和使能。

1. 闪光灯。
2. 曝光。
3. 变焦。
4. 曝光补偿。
5. 对焦。
6. 防抖。
7. 色彩空间。

开发步骤

详细的API说明请参考Camera。

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

   #include <cstdint>
   #include <unistd.h>
   #include <string>
   #include <thread>
   #include <cstdio>
   #include <fcntl.h>
   #include <map>
   #include <string>
   #include <vector>
   #include <native_buffer/native_buffer.h>
   #include "iostream"
   #include "mutex"
   #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 "napi/native_api.h"
   #include "ohcamera/camera_manager.h"
   #include "common/log_common.h"
   

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

   target_link_libraries(entry PUBLIC
      libohcamera.so
      libace_napi.z.so
      libnative_buffer.so
      libhilog_ndk.z.so
      librawfile.z.so)
   

3. 通过OH_CameraManager_GetCameraDevice方法获取对应的前置相机和后置相机。

   void GetSupportedCameras(Camera_Manager *cameraManager)
   {
       Camera_Device *cameras;
       uint32_t size = 0;
       Camera_ErrorCode ret = OH_CameraManager_GetSupportedCameras(cameraManager, &cameras, &size);
       if (cameras == nullptr || &size == nullptr || ret != CAMERA_OK) {
           return;
       }
   
       // 获取后置相机。
       ret = OH_CameraManager_GetCameraDevice(cameraManager, Camera_Position::CAMERA_POSITION_BACK, Camera_Type::CAMERA_TYPE_DEFAULT, &cameras[0]);
   
       // 获取前置相机。
       ret = OH_CameraManager_GetCameraDevice(cameraManager, Camera_Position::CAMERA_POSITION_FRONT, Camera_Type::CAMERA_TYPE_DEFAULT, &cameras[1]);
   }
   

4. 获取对应的并发能力集。通过OH_CameraManager_GetCameraConcurrentInfos方法，获取Camera_ConcurrentInfo相机并发能力集对象数组，数组包含了前置和后置同时开启的相机在指定多摄同开模式下支持的相机模式和相机输出能力。

   void GetSupportedOutputCapability(Camera_Manager *cameraManager, Camera_Device *cameras)
   {
       Camera_ConcurrentInfo* cameraConcurrentInfo;
       uint32_t infoSize = 0;
       Camera_ErrorCode ret = OH_CameraManager_GetCameraConcurrentInfos(cameraManager, cameras, 2, &cameraConcurrentInfo, &infoSize);
       if (cameraConcurrentInfo == nullptr || cameraConcurrentInfo->outputCapabilities == nullptr
           || cameraConcurrentInfo->outputCapabilities->previewProfiles == nullptr || ret != CAMERA_OK) {
           return;
      }
   }
   

5. 对应并发能力集创建PreviewOutput对象。

   void CreatePreviewOutput(Camera_Manager *cameraManager, Camera_ConcurrentInfo* cameraConcurrentInfo, char* previewSurfaceId)
   {
       Camera_Profile *profile = cameraConcurrentInfo->outputCapabilities->previewProfiles[0];
       if (profile == nullptr) {
           return;
       }
       Camera_PreviewOutput *previewOutput;
       Camera_ErrorCode ret = OH_CameraManager_CreatePreviewOutput(cameraManager, profile, previewSurfaceId, &previewOutput);
       if (previewOutput == nullptr || ret != CAMERA_OK) {
           return;
       }
   }
   

6. 打开相机。通过OH_CameraInput_OpenConcurrentCameras以并发状态打开指定相机，在使用该接口前，请先查询接口是否支持并发能力集，并优先调用OH_CameraManager_GetCameraConcurrentInfos方法，获取多摄同开状态下的相机并发能力集。请勿在未查询并发能力集的情况下使用OH_CameraInput_OpenConcurrentCameras，否则会导致打开相机失败。

   void CameraInputOpen(Camera_Manager *cameraManager, Camera_Device *cameras)
   {
       Camera_Input *cameraInput;
       Camera_ErrorCode ret = OH_CameraManager_CreateCameraInput(cameraManager, &cameras[0], &cameraInput);
       if (cameraInput == nullptr || ret != CAMERA_OK) {
           return;
       }
       // 当前版本只支持CAMERA_CONCURRENT_TYPE_LIMITED_CAPABILITY模式并发打开。
       ret = OH_CameraInput_OpenConcurrentCameras(cameraInput, Camera_ConcurrentType::CAMERA_CONCURRENT_TYPE_LIMITED_CAPABILITY);
       if (ret != CAMERA_OK) {
           return;
       }
   }
   

7. 会话流程。配置对应的相机输入流Camera_Input和需要的相机输出流，此处以预览输出流Camera_PreviewOutput为例 。

   void SessionFlowFn(Camera_CaptureSession *captureSession, Camera_Input *cameraInput, Camera_PreviewOutput *previewOutput)
   {
       // 开始配置会话。
       Camera_ErrorCode ret = OH_CaptureSession_BeginConfig(captureSession);
   
       // 向会话中添加相机输入流。
       ret = OH_CaptureSession_AddInput(captureSession, cameraInput);
   
       // 向会话中添加预览输出流。
       ret = OH_CaptureSession_AddPreviewOutput(captureSession, previewOutput);
    
       // 提交配置信息。
       ret = OH_CaptureSession_CommitConfig(captureSession);
   
       // 开始会话。
       ret = OH_CaptureSession_Start(captureSession);
    
       return;
   }
   

8. 在多摄同开状态下，前/后置相机可配置的能力示例如下（当前版本仅支持本文开头部分所示的七项基础功能）。

   // 闪光灯能力。
   void HasFlashFn(uint32_t mode, Camera_CaptureSession *captureSession)
   {
       Camera_FlashMode flashMode = static_cast<Camera_FlashMode>(mode);
       // 检查闪光灯。
       bool hasFlash = false;
       Camera_ErrorCode ret = OH_CaptureSession_HasFlash(captureSession, &hasFlash);
       if (captureSession == nullptr || ret != CAMERA_OK || !hasFlash) {
           return;
       }
   
       // 检查闪光灯模式是否支持。
       bool isSupported = false;
      ret = OH_CaptureSession_IsFlashModeSupported(captureSession, flashMode, &isSupported);
       if (ret != CAMERA_OK || !isSupported) {
           return;
       }
   
       // 设置闪光灯模式。
       ret = OH_CaptureSession_SetFlashMode(captureSession, flashMode);
       if (ret != CAMERA_OK) {
           return;
       }
   
       // 获取当前设备的闪光灯模式。
       ret = OH_CaptureSession_GetFlashMode(captureSession, &flashMode);
    } 
   
   // 曝光。
   void IsExposureModeSupportedFn(uint32_t mode, Camera_CaptureSession *captureSession)
   {
       Camera_ExposureMode exposureMode = static_cast<Camera_ExposureMode>(mode);
       bool isExposureModeSupported = false;
       Camera_ErrorCode ret = OH_CaptureSession_IsExposureModeSupported(captureSession, exposureMode, &isExposureModeSupported);
       if (&isExposureModeSupported == nullptr || ret != CAMERA_OK) {
           return;
       }
       ret = OH_CaptureSession_SetExposureMode(captureSession, exposureMode);
       if (ret != CAMERA_OK) {
           return;
       }
       ret = OH_CaptureSession_GetExposureMode(captureSession, &exposureMode);
   }