OpenHarmony Camera开发指导（四）：相机会话管理（ArkTS）

概述

相机在使用预览、拍照、录像、获取元数据等功能前，都需要先创建相机会话。
相机会话Session的功能如下：

• 配置相机的输入流和输出流。
  配置输入流即添加设备输入，通俗来讲即选择某一个摄像头进行拍照录像；配置输出流，即选择数据的输出形式，如预览、拍照。以实现拍照功能为例，输出流应配置为预览流和拍照流，预览流的数据将显示在XComponent组件上，拍照流的数据将通过ImageReceiver接口的能力保存到相册中。
• 添加闪光灯、设置曝光模式、调整焦距等配置。
• 会话切换控制。应用可以通过添加和删除输出流的方式，切换相机模式。如当前会话的输出流为拍照流，应用可以将拍照流移除，然后添加视频流作为输出流，即完成了拍照到录像的切换。

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

开发步骤

创建会话

调用cameraManager类中的createSession方法创建一个会话。

import { camera } from '@kit.CameraKit';
import { BusinessError } from '@kit.BasicServicesKit';

function getSession(cameraManager: camera.CameraManager): camera.Session | undefined {
  let session: camera.Session | undefined = undefined;
  try {
    session = cameraManager.createSession(camera.SceneMode.NORMAL_PHOTO) as camera.PhotoSession;
  } catch (error) {
    let err = error as BusinessError;
    console.error(`Failed to create the session instance. error: ${JSON.stringify(err)}`);
  }
  return session;
}

配置会话

调用PhotoSession类中的beginConfig方法配置会话。

function beginConfig(photoSession: camera.PhotoSession): void {
  try {
    photoSession.beginConfig();
  } catch (error) {
    let err = error as BusinessError;
    console.error(`Failed to beginConfig. error: ${JSON.stringify(err)}`);
  }
}

添加输入输出流

通过addInput和addOutput向会话中添加相机的输入流和输出流。以添加预览流previewOutput和拍照流photoOutput为例，即当前模式支持预览和拍照。

async function addStream(photoSession: camera.PhotoSession, cameraInput: camera.CameraInput, previewOutput: camera.PreviewOutput, photoOutput: camera.PhotoOutput): Promise<void> {
  try {
    photoSession.addInput(cameraInput);
  } catch (error) {
    let err = error as BusinessError;
    console.error(`Failed to addInput. error: ${JSON.stringify(err)}`);
  }
  try {
    photoSession.addOutput(previewOutput);
  } catch (error) {
    let err = error as BusinessError;
    console.error(`Failed to add previewOutput. error: ${JSON.stringify(err)}`);
  }
  try {
    photoSession.addOutput(photoOutput);
  } catch (error) {
    let err = error as BusinessError;
    console.error(`Failed to add photoOutput. error: ${JSON.stringify(err)}`);
  }
  ...
}

提交配置，启动会话

调用PhotoSession类中的commitConfig方法提交会话配置，并启动会话。

async function startSession(photoSession: camera.PhotoSession): Promise<void> {
  try {
    await photoSession.commitConfig();
  } catch (error) {
    let err = error as BusinessError;
    console.error(`Failed to commitConfig. error: ${JSON.stringify(err)}`);
  }

  try {
    await photoSession.start();
  } catch (error) {
    let err = error as BusinessError;
    console.error(`Failed to start. error: ${JSON.stringify(err)}`);
  }
}

会话切换控制

会话切换控制。调用PhotoSession类中的stop方法可以停止当前会话，调用removeOutput和addOutput方法可以完成会话切换控制。以移除拍照流photoOutput，添加视频流videoOutput为例，完成了拍照到录像的切换。

async function switchOutput(photoSession: camera.PhotoSession, videoOutput: camera.VideoOutput, photoOutput: camera.PhotoOutput): Promise<void> {
  try {
    await photoSession.stop();
  } catch (error) {
    let err = error as BusinessError;
    console.error(`Failed to stop. error: ${JSON.stringify(err)}`);
  }

  try {
    photoSession.beginConfig();
  } catch (error) {
    let err = error as BusinessError;
    console.error(`Failed to beginConfig. error: ${JSON.stringify(err)}`);
  }
  // 从会话中移除拍照输出流
  try {
    photoSession.removeOutput(photoOutput);
  } catch (error) {
    let err = error as BusinessError;
    console.error(`Failed to remove photoOutput. error: ${JSON.stringify(err)}`);
  }
  // 向会话中添加视频输出流
  try {
    photoSession.addOutput(videoOutput);
  } catch (error) {
    let err = error as BusinessError;
    console.error(`Failed to add videoOutput. error: ${JSON.stringify(err)}`);
  }
}

API参考

createSession

createSession<T extends Session>(mode: SceneMode): T

创建指定SceneMode的Session实例，同步返回结果
注：API11(4.1版本)之前统一创建CaptureSession实例操作，API 11后修改为创建Session实例，根据不同的SceneMode可派生为PhotoSession、VideoSession等。

Session

// 开始配置会话
beginConfig(): void

// 提交配置信息
commitConfig(): Promise<void>

// 判断当前cameraInput是否可以添加到session中。当前函数需要在beginConfig和commitConfig之间调用
canAddInput(cameraInput: CameraInput): boolean

// 把CameraInput添加到会话
addInput(cameraInput: CameraInput): void

// 移除CameraInput
removeInput(cameraInput: CameraInput): void

// 判断当前cameraOutput是否可以添加到session中。当前函数需要在addInput和commitConfig之间调用
canAddOutput(cameraOutput: CameraOutput): boolean

// 把CameraOutput添加到会话
addOutput(cameraOutput: CameraOutput): void

// 从会话中移除CameraOutput
removeOutput(cameraOutput: CameraOutput): void

// 开启会话
start(): Promise<void>  

// 停止会话
stop(): Promise<void>

//释放会话资源
release(): Promise<void>