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