• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 会话管理
2
3相机使用预览、拍照、录像、元数据功能前，均需要创建相机会话。
4
5在会话中，可以完成以下功能：
6
7- 配置相机的输入流和输出流。相机在拍摄前，必须完成输入输出流的配置。
8  配置输入流即添加设备输入，对用户而言，相当于选择设备的某一摄像头拍摄；配置输出流，即选择数据将以什么形式输出。当应用需要实现拍照时，输出流应配置为预览流和拍照流，预览流的数据将显示在XComponent组件上，拍照流的数据将通过ImageReceiver接口的能力保存到相册中。
9
10- 添加闪光灯、调整焦距等配置。具体支持的配置及接口说明请参考[Camera API参考](../reference/apis/js-apis-camera.md)。
11
12- 会话切换控制。应用可以通过移除和添加输出流的方式，切换相机模式。如当前会话的输出流为拍照流，应用可以将拍照流移除，然后添加视频流作为输出流，即完成了拍照到录像的切换。
13
14完成会话配置后，应用提交和开启会话，可以开始调用相机相关功能。
15
16## 开发步骤
17
181. 调用cameraManager类中的createCaptureSession()方法创建一个会话。
19
20   ```ts
21   let captureSession;
22   try {
23       captureSession = cameraManager.createCaptureSession();
24   } catch (error) {
25       console.error('Failed to create the CaptureSession instance. errorCode = ' + error.code);
26   }
27   ```
28
292. 调用captureSession类中的beginConfig()方法配置会话。
30
31   ```ts
32   try {
33       captureSession.beginConfig();
34   } catch (error) {
35       console.error('Failed to beginConfig. errorCode = ' + error.code);
36   }
37   ```
38
393. 使能。向会话中添加相机的输入流和输出流，调用captureSession.addInput()添加相机的输入流；调用captureSession.addOutput()添加相机的输出流。以下示例代码以添加预览流previewOutput和拍照流photoOutput为例，即当前模式支持拍照和预览。
40
41     调用captureSession类中的commitConfig()和start()方法提交相关配置，并启动会话。
42
43   ```ts
44   try {
45       captureSession.addInput(cameraInput);
46   } catch (error) {
47       console.error('Failed to addInput. errorCode = ' + error.code);
48   }
49   try {
50       captureSession.addOutput(previewOutput);
51   } catch (error) {
52       console.error('Failed to addOutput(previewOutput). errorCode = ' + error.code);
53   }
54   try {
55       captureSession.addOutput(photoOutput);
56   } catch (error) {
57       console.error('Failed to addOutput(photoOutput). errorCode = ' + error.code);
58   }
59   await captureSession.commitConfig() ;
60   await captureSession.start().then(() => {
61       console.info('Promise returned to indicate the session start success.');
62   })
63   ```
64
654. 会话控制。调用captureSession类中的stop()方法可以停止当前会话。调用removeOutput()和addOutput()方法可以完成会话切换控制。以下示例代码以移除拍照流photoOutput，添加视频流videoOutput为例，完成了拍照到录像的切换。
66
67   ```ts
68   await captureSession.stop();
69   try {
70       captureSession.beginConfig();
71   } catch (error) {
72       console.error('Failed to beginConfig. errorCode = ' + error.code);
73   }
74   // 从会话中移除拍照输出流
75   try {
76       captureSession.removeOutput(photoOutput);
77   } catch (error) {
78       console.error('Failed to removeOutput(photoOutput). errorCode = ' + error.code);
79   }
80   // 向会话中添加视频输出流
81   try {
82       captureSession.addOutput(videoOutput);
83   } catch (error) {
84       console.error('Failed to addOutput(videoOutput). errorCode = ' + error.code);
85   }
86   ```
87