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>
相关推荐
Bruce_Liuxiaowei6 小时前
HarmonyOS NEXT~鸿蒙操作系统功耗优化特性深度解析
华为·harmonyos
SuperHeroWu76 小时前
【HarmonyOS 5】鸿蒙中的UIAbility详解(二)
华为·harmonyos·数据传递·uiability·启动模式·生命周期监听·监听设备环境信息
OBOO鸥柏商用液晶显示厂家8 小时前
OBOO鸥柏丨2025年鸿蒙生态+国产操作系统触摸屏查询一体机核心股
华为·harmonyos
实在智能RPA18 小时前
实在Agent成业界首批全面适配鸿蒙、麒麟、统信信创系统的智能体
人工智能·华为·harmonyos·agent智能体·实在agent
码农搬砖_202020 小时前
尝鲜纯血鸿蒙,华为国际版本暂时不支持升级。如mateX6 国际版?为什么不支持?什么时候支持?
华为·harmonyos
枫叶丹421 小时前
【HarmonyOS Next之旅】DevEco Studio使用指南(二十八) -> 开发云对象
华为·harmonyos·deveco studio·harmonyos next
鸿蒙布道师1 天前
HarmonyOS 5 应用开发导读:从入门到实践
android·ios·华为·harmonyos·鸿蒙系统·huawei
Python自动化办公社区1 天前
《全面解析鸿蒙相关概念:鸿蒙、开源鸿蒙、鸿蒙 Next 有何区别》
华为·开源·harmonyos
lqj_本人1 天前
鸿蒙OS&UniApp 制作倒计时与提醒功能#三方框架 #Uniapp
华为·uni-app·harmonyos
lqj_本人2 天前
鸿蒙OS&UniApp 实现自定义的侧边栏菜单组件#三方框架 #Uniapp
华为·uni-app·harmonyos