1# 性能提升方案(仅对系统应用开放)(ArkTS)
2
3在开发相机应用时，需要先参考开发准备[申请相关权限](camera-preparation.md)。
4
5相机启动性能受限于底层器件上电、流程Pipeline初始化等耗时操作影响，本文档将为开发者提供更进一步的指导，提升相机启动速度以及拍照返回缩略图速度。相关能力与底层器件相关，请开发者在使用前需确认是否支持相关特性。
6
7​相关特性分别在打开相机设备过程、配流过程以及拍照过程中。本文档针对三个场景分别进行介绍。
8
9## 延时配流
10
11经典的相机启动过程经过“相机设备打开”、“配置数据流”、“启动数据流”等流程，而配流启流之前需要得到XComponent组件的surfaceId。
12
13延时配流方案是把配流启流与surface解耦，在组件尚未给应用surface之前，可以先进行配流启流，只需要在启流结束之前提供surface，可以提升启动速度，防止影响其他启动优化方案的落地。
14
15![deferred-surface-scene](figures/deferred-surface-scene.png)
16
17优化前：配流动作依赖surface对象，surface对象依赖于UI加载完成。也就是在UI加载完成后，才可以创建Session、配置输入输出流、启动Session，由相机HDI进行配流。
18
19优化后：配流动作不依赖surface对象，界面加载和配流并行执行。完成参数准备后，即可开始创建Session。
20
21### 接口说明
22
23详细的API参考说明，请参考[Camera API文档](../../reference/apis-camera-kit/js-apis-camera.md)。
24
25| 接口 | 说明 |
26| ---- | ---- |
27| createDeferredPreviewOutput(profile: Profile): Promise\<PreviewOutput> | 创建延迟预览输出对象，在配流时替代普通的预览输出对象加入数据流。 |
28| addDeferredSurface(surfaceId: string): Promise\<void> | 配置延迟预览的Surface，可以在[session.commitConfig](../../reference/apis-camera-kit/js-apis-camera.md#commitconfig11)配流和[session.start](../../reference/apis-camera-kit/js-apis-camera.md#start11)启流之后运行。 |
29
30### 开发示例
31
32接口调用流程建议如下图所示：
33
34![](figures/deferred-surface-sequence-diagram.png)
35
36Context获取方式请参考：[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息)。
37
38```ts
39import { camera } from '@kit.CameraKit';
40import { common } from '@kit.AbilityKit';
41
42async function preview(baseContext: common.BaseContext, cameraInfo: camera.CameraDevice, previewProfile: camera.Profile, photoProfile: camera.Profile, previewSurfaceId: string): Promise<void> {
43  const cameraManager: camera.CameraManager = camera.getCameraManager(baseContext);
44  const cameraInput: camera.CameraInput = cameraManager.createCameraInput(cameraInfo);
45  const previewOutput: camera.PreviewOutput = cameraManager.createDeferredPreviewOutput(previewProfile);
46  const photoOutput: camera.PhotoOutput = cameraManager.createPhotoOutput(photoProfile);
47  const session: camera.PhotoSession = cameraManager.createSession(camera.SceneMode.NORMAL_PHOTO) as camera.PhotoSession;
48  session.beginConfig();
49  session.addInput(cameraInput);
50  session.addOutput(previewOutput);
51  session.addOutput(photoOutput);
52  await session.commitConfig();
53  await session.start();
54  previewOutput.addDeferredSurface(previewSurfaceId);
55}
56```
57
58## 快速缩略图
59
60相机拍照性能依赖算法处理的速度，算法链越复杂、效果就越好，但同时处理时间就越长。
61
62通过相机快速缩略图，相机拍照可单独输出拇指缩略图，在真图没有上报之前，可以提前上报一张缩略图给应用去做显示，提升shot2see用户感知拍照速度。
63
64这样从拍照流程上进行优化，既可以满足后处理算法处理的要求，又不会阻塞前台的拍照速度。
65
66### 接口说明
67
68详细的API参考说明，请参考[Camera API文档](../../reference/apis-camera-kit/js-apis-camera.md)。
69
70| 接口 | 说明 |
71| ---- | ---- |
72| isQuickThumbnailSupported() : boolean | 是否支持快速缩略图。 |
73| enableQuickThumbnail(enabled:bool): void | 使能/去使能快速缩略图。 |
74| on(type: 'quickThumbnail', callback: AsyncCallback\<image.PixelMap>): void | 相机缩略图监听回调。 |
75
76> **说明：**
77>
78> - [isQuickThumbnailSupported](../../reference/apis-camera-kit/js-apis-camera-sys.md#isquickthumbnailsupported)及[enableQuickThumbnail](../../reference/apis-camera-kit/js-apis-camera-sys.md#enablequickthumbnail)接口的调用需要在[addOutput](../../reference/apis-camera-kit/js-apis-camera.md#addoutput11)、[addInput](../../reference/apis-camera-kit/js-apis-camera.md#addinput11)后，[commitConfig](../../reference/apis-camera-kit/js-apis-camera.md#commitconfig11)之前。
79> - on接口需要在[enableQuickThumbnail(true)](../../reference/apis-camera-kit/js-apis-camera-sys.md#enablequickthumbnail)之后生效。
80
81### 开发示例
82
83接口调用流程建议如下图所示：
84
85![](figures/quick-thumbnail-sequence-diagram.png)
86
87Context获取方式请参考：[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息)。
88```ts
89import { camera } from '@kit.CameraKit';
90import { BusinessError } from '@kit.BasicServicesKit';
91import { image } from '@kit.ImageKit';
92import { common } from '@kit.AbilityKit';
93
94async function enableQuickThumbnail(baseContext: common.BaseContext, photoProfile: camera.Profile): Promise<void> {
95  let cameraManager: camera.CameraManager = camera.getCameraManager(baseContext);
96  let cameras: Array<camera.CameraDevice> = cameraManager.getSupportedCameras();
97  // 创建PhotoSession实例
98  let photoSession: camera.PhotoSession = cameraManager.createSession(camera.SceneMode.NORMAL_PHOTO) as camera.PhotoSession;
99  // 开始配置会话
100  photoSession.beginConfig();
101  // 把CameraInput加入到会话
102  let cameraInput: camera.CameraInput = cameraManager.createCameraInput(cameras[0]);
103  cameraInput.open();
104  photoSession.addInput(cameraInput);
105  // 把PhotoOutPut加入到会话
106  let photoOutPut: camera.PhotoOutput = cameraManager.createPhotoOutput(photoProfile);
107  photoSession.addOutput(photoOutPut);
108  let isSupported: boolean = photoOutPut.isQuickThumbnailSupported();
109  if (isSupported) {
110    // 使能快速缩略图
111    photoOutPut.enableQuickThumbnail(true);
112    photoOutPut.on('quickThumbnail', (err: BusinessError, pixelMap: image.PixelMap) => {
113      if (err || pixelMap === undefined) {
114        console.error('photoOutPut on thumbnail failed');
115        return;
116      }
117      // 显示或保存pixelmap
118      showOrSavePicture(pixelMap);
119    });
120  }
121}
122
123function showOrSavePicture(pixelMap: image.PixelMap): void {
124  //do something
125}
126```
127
128## 预热启动
129
130普通情况下相机应用的启动是用户通过点击桌面相机图标触发的。桌面应用感知用户点击相机图标，然后通知应用管理器启动对应的相机应用（进程），这个过程是耗时较长。进入相机应用后，开始进入相机启动流程。经典的相机启动过程会经过，“相机设备打开”，“配置数据流”，“启动数据流等”，这个过程也较为耗时。
131
132​相机启动方案是把“相机设备打开”这个动作提前到相机应用启动之前，即在用户点击相机图标，
133还没等相机应用启动的时候，触发相机设备打开的动作，从而缩短相机应用内启动相机的流程，加速相机启动。使用预热启动前后的相机应用流程对比如下：
134
135![prelaunch-scene](figures/prelaunch-scene.png)
136
137### 接口说明
138
139详细的API参考说明，请参考[Camera API文档](../../reference/apis-camera-kit/js-apis-camera.md)。
140
141| 接口 | 说明 |
142| ---- | ---- |
143| isPrelaunchSupported(camera: CameraDevice) : boolean |  判断指定cameraDevice是否支持预热启动。 |
144| setPrelaunchConfig(prelaunchConfig: PrelaunchConfig) : void | 配置相机预热参数。 |
145| prelaunch() : void | 用户点击系统相机图标，拉起相机应用的同时调用，下发预热请求，使能相机预热启动。 |
146
147### 开发示例
148
149接口调用流程建议如下图所示：
150
151![](figures/prelaunch-sequence-diagram.png)
152
153Context获取方式请参考：[获取UIAbility的上下文信息](../../application-models/uiability-usage.md#获取uiability的上下文信息)。
154
155- **桌面应用**
156
157  ```ts
158  import { camera } from '@kit.CameraKit';
159  import { BusinessError } from '@kit.BasicServicesKit';
160  import { common } from '@kit.AbilityKit';
161
162  function preLaunch(baseContext: common.BaseContext): void {
163    let cameraManager: camera.CameraManager = camera.getCameraManager(baseContext);
164    try {
165      cameraManager.prelaunch();
166    } catch (error) {
167      let err = error as BusinessError;
168      console.error(`catch error: Code: ${err.code}, message: ${err.message}`);
169    }
170  }
171  ```
172
173- **相机应用**
174
175  使用该功能前，应用需要**申请权限**：ohos.permission.CAMERA
176
177  具体申请方式及校验方式，请参考[向用户申请授权](../../security/AccessToken/request-user-authorization.md)。
178
179  ```ts
180  import { camera } from '@kit.CameraKit';
181  import { BusinessError } from '@kit.BasicServicesKit';
182  import { common } from '@kit.AbilityKit';
183
184  function setPreLaunchConfig(baseContext: common.BaseContext): void {
185    let cameraManager: camera.CameraManager = camera.getCameraManager(baseContext);
186    let cameras: Array<camera.CameraDevice> = [];
187    try {
188      cameras = cameraManager.getSupportedCameras();
189    } catch (error) {
190      let err = error as BusinessError;
191      console.error(`getSupportedCameras catch error: Code: ${err.code}, message: ${err.message}`);
192    }
193    if (cameras.length <= 0) {
194      return;
195    }
196    if(cameraManager.isPrelaunchSupported(cameras[0])) {
197      try {
198        cameraManager.setPrelaunchConfig({cameraDevice: cameras[0]});
199      } catch (error) {
200        let err = error as BusinessError;
201        console.error(`setPrelaunchConfig catch error: Code: ${err.code}, message: ${err.message}`);
202      }
203    }
204  }
205  ```
206