OpenHarmony Camera开发指导(四):相机会话管理(ArkTS)

概述

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

相机会话Session的功能如下:

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

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

开发步骤

创建会话

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

typescript 复制代码
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方法配置会话。

typescript 复制代码
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为例,即当前模式支持预览和拍照。

typescript 复制代码
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方法提交会话配置,并启动会话。

typescript 复制代码
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为例,完成了拍照到录像的切换。

typescript 复制代码
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

typescript 复制代码
createSession<T extends Session>(mode: SceneMode): T

创建指定SceneMode的Session实例,同步返回结果

注:API11(4.1版本)之前统一创建CaptureSession实例操作,API 11后修改为创建Session实例,根据不同的SceneMode可派生为PhotoSession、VideoSession等。

Session

typescript 复制代码
// 开始配置会话
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>
相关推荐
爱笑的眼睛119 小时前
深入剖析 HarmonyOS ArkUI 声明式开发:状态管理艺术与最佳实践
华为·harmonyos
安卓开发者10 小时前
鸿蒙NEXT交互机制解析:从输入设备到手势响应的全面指南
microsoft·交互·harmonyos
奶糖不太甜。12 小时前
鸿蒙分布式数据同步失败全解
分布式·华为·harmonyos·数据同步
fakerth17 小时前
【OpenHarmony文件管理子系统】文件访问接口mod_fileio解析
操作系统·openharmony
fakerth21 小时前
【OpenHarmony文件管理子系统】文件访问接口mod_file解析
操作系统·openharmony
小小小小小星2 天前
鸿蒙权限相关问题之应用访问网络、文件等功能时崩溃或无响应,日志提示'权限被拒绝'
harmonyos
leon_teacher2 天前
ArkUI核心功能组件使用
android·java·开发语言·javascript·harmonyos·鸿蒙
lisir92 天前
鸿蒙手势实战解析+手势冲突解决策略总结
harmonyos
安卓开发者2 天前
鸿蒙Next图形绘制指南:从基础几何图形到复杂UI设计
ui·华为·harmonyos
开发小能手嗨啊2 天前
鸿蒙开发进阶(HarmonyOS)
harmonyos·鸿蒙·鸿蒙开发·开发教程·纯血鸿蒙·南向开发·北向开发