往期鸿蒙全套实战文章必看:
会话管理(ArkTS)
相机使用预览、拍照、录像、元数据功能前,均需要创建相机会话。
在会话中,可以完成以下功能:
-
配置相机的输入流和输出流。相机在拍摄前,必须完成输入输出流的配置。
配置输入流即添加设备输入,对用户而言,相当于选择设备的某一摄像头拍摄;配置输出流,即选择数据将以什么形式输出。当应用需要实现拍照时,输出流应配置为预览流和拍照流,预览流的数据将显示在XComponent组件上,拍照流的数据将通过ImageReceiver接口的能力保存到相册中。
-
添加闪光灯、调整焦距等配置。
-
会话切换控制。应用可以通过移除和添加输出流的方式,切换相机模式。如当前会话的输出流为拍照流,应用可以将拍照流移除,然后添加视频流作为输出流,即完成了拍照到录像的切换。
完成会话配置后,应用提交和开启会话,可以开始调用相机相关功能。
开发步骤
-
导入相关接口,导入方法如下。
import { camera } from '@kit.CameraKit'; import { BusinessError } from '@kit.BasicServicesKit';
-
调用cameraManager类中的createSession方法创建一个会话。
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为例,即当前模式支持拍照和预览。
调用PhotoSession类中的commitConfig和start方法提交相关配置,并启动会话。
async function startSession(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)}`); } 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)}`); } }