当前位置：首页 > news >正文

鸿蒙（API 12 Beta3版）【分段式拍照】媒体相机开发指导(ArkTS)

news 2025/12/3 12:36:06

分段式拍照是相机的重要功能之一，即应用下发拍照任务后，系统将分多阶段上报不同质量的图片。

在第一阶段，系统快速上报低质量图，应用通过回调会收到一个PhotoAsset对象，通过该对象可调用媒体库接口，读取图片或落盘图片。
在第二阶段，分段式子服务会根据系统压力及定制化场景进行调度，将后处理好的原图回传给媒体库，替换低质量图。

通过分布式拍照，优化了系统的拍照响应时延，从而提升用户体验。

应用开发分段式拍照主要分为以下步骤：

通过PhotoOutput，监听photoAssetAvailable回调，获取[photoAccessHelper])的PhotoAsset对象。
通过PhotoAsset对象，调用媒体库相关接口，读取或落盘图片。

说明

分段式拍照能力是根据设备和模式决定的，不同的设备支持不同的模式，不同的模式下分段式能力也各有不同，所以应用在切换设备或模式后分段式能力可能会发生变化。
分段式拍照能力应用无需主动使能，相机框架会在配流期间判断设备和模式是否支持分段式，如果支持会使能分段式拍照。

开发步骤

导入依赖，需要导入相机框架、媒体库、图片相关领域依赖。

import { camera } from '@kit.CameraKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { common } from '@kit.AbilityKit';
import { photoAccessHelper } from '@kit.MediaLibraryKit';

确定拍照输出流。

通过[CameraOutputCapability]类中的photoProfiles属性，可获取当前设备支持的拍照输出流，通过[createPhotoOutput]方法创建拍照输出流。

function getPhotoOutput(cameraManager: camera.CameraManager, cameraOutputCapability: camera.CameraOutputCapability): camera.PhotoOutput | undefined {let photoProfilesArray: Array<camera.Profile> = cameraOutputCapability.photoProfiles;if (!photoProfilesArray) {console.error("createOutput photoProfilesArray == null || undefined");}let photoOutput: camera.PhotoOutput | undefined = undefined;try {photoOutput = cameraManager.createPhotoOutput(photoProfilesArray[0]);} catch (error) {let err = error as BusinessError;console.error(`Failed to createPhotoOutput. error: ${JSON.stringify(err)}`);}return photoOutput;
}

设置拍照photoAssetAvailable的回调。

注意

如果已经注册了photoAssetAvailable回调，并且在Session开始之后又注册了photoAvailable回调，会导致流被重启。

不建议开发者同时注册photoAvailable和photoAssetAvailable。

function photoAssetAvailableCallback(err: BusinessError, photoAsset: photoAccessHelper.PhotoAsset): void {if (err) {console.error(`photoAssetAvailable error: ${JSON.stringify(err)}.`);return;}console.info('photoOutPutCallBack photoAssetAvailable');// 开发者可通过photoAsset调用媒体库相关接口，自定义处理图片// 处理方式一：调用媒体库落盘接口保存一阶段低质量图，二阶段真图就绪后媒体库会主动帮应用替换落盘图片// 处理方式二：调用媒体库接口请求图片并注册低质量图或高质量图buffer回调，自定义使用
}function onPhotoOutputPhotoAssetAvailable(photoOutput: camera.PhotoOutput): void {photoOutput.on('photoAssetAvailable', photoAssetAvailableCallback);
}

媒体库落盘图片参考：[saveCameraPhoto]

媒体库请求图片参考：[requestimagedata] 和 [ondataprepare]

拍照时的会话配置及触发拍照的方式，与普通拍照相同，请参考之前文章[拍照]的步骤4-5。

状态监听

在相机应用开发过程中，可以随时监听拍照输出流状态，包括拍照流开始、拍照帧的开始与结束、拍照输出流的错误。

通过注册固定的captureStart回调函数获取监听拍照开始结果，photoOutput创建成功时即可监听，拍照第一次曝光时触发，该事件返回此次拍照的captureId。

function onPhotoOutputCaptureStart(photoOutput: camera.PhotoOutput): void {photoOutput.on('captureStartWithInfo', (err: BusinessError, captureStartInfo: camera.CaptureStartInfo) => {if (err !== undefined && err.code !== 0) {return;}console.info(`photo capture started, captureId : ${captureStartInfo.captureId}`);});
}

通过注册固定的captureEnd回调函数获取监听拍照结束结果，photoOutput创建成功时即可监听，该事件返回结果为拍照完全结束后的相关信息[CaptureEndInfo]。

function onPhotoOutputCaptureEnd(photoOutput: camera.PhotoOutput): void {photoOutput.on('captureEnd', (err: BusinessError, captureEndInfo: camera.CaptureEndInfo) => {if (err !== undefined && err.code !== 0) {return;}console.info(`photo capture end, captureId : ${captureEndInfo.captureId}`);console.info(`frameCount : ${captureEndInfo.frameCount}`);});
}

通过注册固定的error回调函数获取监听拍照输出流的错误结果。callback返回拍照输出接口使用错误时的对应错误码，错误码类型参见[CameraErrorCode]。

function onPhotoOutputError(photoOutput: camera.PhotoOutput): void {photoOutput.on('error', (error: BusinessError) => {console.error(`Photo output error code: ${error.code}`);});
}

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

在这里插入图片描述