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