会话管理(C/C++)
===========

相机使用预览、拍照、录像、元数据功能前，均需要创建相机会话。

在会话中，可以完成以下功能：

*   配置相机的输入流和输出流。相机在拍摄前，必须完成输入输出流的配置。
    
    配置输入流即添加设备输入，对用户而言，相当于选择设备的某一相机拍摄；配置输出流，即选择数据将以什么形式输出。当应用需要实现拍照时，输出流应配置为预览流和拍照流，预览流的数据将显示在XComponent组件上，拍照流的数据将通过ImageReceiver接口的能力保存到相册中。
    
*   添加闪光灯、调整焦距等配置。具体支持的配置及接口说明请参考[OH\_Camera](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-oh-camera)。
    
*   会话切换控制。应用可以通过移除和添加输出流的方式，切换相机模式。如当前会话的输出流为拍照流，应用可以将拍照流移除，然后添加视频流作为输出流，即完成了拍照到录像的切换。
    

完成会话配置后，应用提交和开启会话，可以开始调用相机相关功能。

#### 开发步骤

1.  导入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\_CameraManager\_CreateCaptureSession()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-camera-manager-h#oh_cameramanager_createcapturesession)方法创建一个会话。
    
    Camera\_CaptureSession\* CreateCaptureSession(Camera\_Manager\* cameraManager)
    {
        Camera\_CaptureSession\* captureSession = nullptr;
        if (cameraManager == nullptr) {
            OH\_LOG\_ERROR(LOG\_APP, "cameraManager is nullptr.");
            return captureSession;
        }
        Camera\_ErrorCode ret = OH\_CameraManager\_CreateCaptureSession(cameraManager, &captureSession);
        if (captureSession == nullptr || ret != CAMERA\_OK) {
            OH\_LOG\_ERROR(LOG\_APP, "OH\_CameraManager\_CreateCaptureSession failed.");
        }
        return captureSession;
    }
    
4.  调用[OH\_CaptureSession\_SetSessionMode()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-capture-session-h#oh_capturesession_setsessionmode)方法配置会话模式。
    
    Camera\_ErrorCode SetSessionMode(Camera\_CaptureSession\* captureSession)
    {
        Camera\_ErrorCode ret = OH\_CaptureSession\_SetSessionMode(captureSession, NORMAL\_VIDEO);
        if (ret != CAMERA\_OK) {
            OH\_LOG\_ERROR(LOG\_APP, "OH\_CaptureSession\_SetSessionMode failed.");
        }
        return ret;
    }
    
5.  调用[OH\_CaptureSession\_BeginConfig()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-capture-session-h#oh_capturesession_beginconfig)方法配置会话。
    
    Camera\_ErrorCode BeginConfig(Camera\_CaptureSession\* captureSession)
    {
        Camera\_ErrorCode ret = OH\_CaptureSession\_BeginConfig(captureSession);
        if (ret != CAMERA\_OK) {
            OH\_LOG\_ERROR(LOG\_APP, "OH\_CaptureSession\_BeginConfig failed.");
        }
        return ret;
    }
    
6.  使能。向会话中添加相机的输入流和输出流，调用[OH\_CaptureSession\_AddInput()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-capture-session-h#oh_capturesession_addinput)添加相机的输入流；调用[OH\_CaptureSession\_AddPreviewOutput()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-capture-session-h#oh_capturesession_addpreviewoutput)和[OH\_CaptureSession\_AddPhotoOutput()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-capture-session-h#oh_capturesession_addphotooutput)添加相机的输出流。以下示例代码以添加预览流previewOutput和拍照流photoOutput为例，即当前模式支持拍照和预览。
    
    调用[OH\_CaptureSession\_CommitConfig()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-capture-session-h#oh_capturesession_commitconfig)和[OH\_CaptureSession\_Start()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-capture-session-h#oh_capturesession_start)方法提交相关配置，并启动会话。
    
    Camera\_ErrorCode StartSession(Camera\_CaptureSession\* captureSession, Camera\_Input\* cameraInput,
        Camera\_PreviewOutput\* previewOutput, Camera\_PhotoOutput\* photoOutput)
    {
        // 向会话中添加相机输入流。
        Camera\_ErrorCode ret = OH\_CaptureSession\_AddInput(captureSession, cameraInput);
        if (ret != CAMERA\_OK) {
            OH\_LOG\_ERROR(LOG\_APP, "OH\_CaptureSession\_AddInput failed.");
            return ret;
        }
    
        // 向会话中添加预览输出流。
        ret = OH\_CaptureSession\_AddPreviewOutput(captureSession, previewOutput);
        if (ret != CAMERA\_OK) {
            OH\_LOG\_ERROR(LOG\_APP, "OH\_CaptureSession\_AddPreviewOutput failed.");
            return ret;
        }
    
        // 向会话中添加拍照输出流。
        ret = OH\_CaptureSession\_AddPhotoOutput(captureSession, photoOutput);
        if (ret != CAMERA\_OK) {
            OH\_LOG\_ERROR(LOG\_APP, "OH\_CaptureSession\_AddPhotoOutput failed.");
            return ret;
        }
    
        // 提交会话配置。
        ret = OH\_CaptureSession\_CommitConfig(captureSession);
        if (ret != CAMERA\_OK) {
            OH\_LOG\_ERROR(LOG\_APP, "OH\_CaptureSession\_CommitConfig failed.");
            return ret;
        }
    
        // 启动会话。
        ret = OH\_CaptureSession\_Start(captureSession);
        if (ret != CAMERA\_OK) {
            OH\_LOG\_ERROR(LOG\_APP, "OH\_CaptureSession\_Start failed.");
        }
        return ret;
    }
    
7.  会话控制。调用[OH\_CaptureSession\_Stop()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-capture-session-h#oh_capturesession_stop)方法可以停止当前会话。调用[OH\_CaptureSession\_RemovePhotoOutput()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-capture-session-h#oh_capturesession_removephotooutput)和[OH\_CaptureSession\_AddVideoOutput()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-capture-session-h#oh_capturesession_addvideooutput)方法可以完成会话切换控制。以下示例代码以移除拍照流photoOutput，添加视频流videoOutput为例，完成了拍照到录像的切换。
    
    Camera\_ErrorCode ReloadSession(Camera\_CaptureSession\* captureSession, Camera\_PhotoOutput\* photoOutput,
        Camera\_VideoOutput\* videoOutput)
    {
        Camera\_ErrorCode ret = OH\_CaptureSession\_Stop(captureSession);
        if (ret == CAMERA\_OK) {
            OH\_LOG\_INFO(LOG\_APP, "OH\_CaptureSession\_Stop success ");
        } else {
            OH\_LOG\_ERROR(LOG\_APP, "OH\_CaptureSession\_Stop failed. %d ", ret);
        }
        ret = OH\_CaptureSession\_BeginConfig(captureSession);
        if (ret != CAMERA\_OK) {
            OH\_LOG\_ERROR(LOG\_APP, "OH\_CaptureSession\_BeginConfig failed.");
            return ret;
        }
        // 从会话中移除拍照输出流。
        ret = OH\_CaptureSession\_RemovePhotoOutput(captureSession, photoOutput);
        if (ret == CAMERA\_OK) {
            OH\_LOG\_INFO(LOG\_APP, "OH\_CaptureSession\_RemovePhotoOutput success ");
        } else {
            OH\_LOG\_ERROR(LOG\_APP, "OH\_CaptureSession\_RemovePhotoOutput failed. %d ", ret);
        }
        // 释放photoOutput。
        ret = OH\_PhotoOutput\_Release(photoOutput);
        if (ret == CAMERA\_OK) {
            OH\_LOG\_INFO(LOG\_APP, "OH\_PhotoOutput\_Release success ");
        } else {
            OH\_LOG\_ERROR(LOG\_APP, "OH\_PhotoOutput\_Release failed. %d ", ret);
        }
        // 向会话中添加视频输出流。
        ret = OH\_CaptureSession\_AddVideoOutput(captureSession, videoOutput);
        if (ret == CAMERA\_OK) {
            OH\_LOG\_INFO(LOG\_APP, "OH\_CaptureSession\_AddVideoOutput success ");
        } else {
            OH\_LOG\_ERROR(LOG\_APP, "OH\_CaptureSession\_AddVideoOutput failed. %d ", ret);
            return ret;
        }
        // 提交会话配置。
        ret = OH\_CaptureSession\_CommitConfig(captureSession);
        if (ret != CAMERA\_OK) {
            OH\_LOG\_ERROR(LOG\_APP, "OH\_CaptureSession\_CommitConfig failed.");
            return ret;
        }
    
        // 启动会话。
        ret = OH\_CaptureSession\_Start(captureSession);
        if (ret != CAMERA\_OK) {
            OH\_LOG\_ERROR(LOG\_APP, "OH\_CaptureSession\_Start failed.");
        }
        return ret;
    }