HarmonyOS7 相机拍照：Camera Kit 从预览到保存完整流程-北京尧图网络

文章目录前言Camera Kit 架构权限配置创建预览拍照实现保存到相册前后置切换踩坑记录写在最后前言相机开发可以说是移动端最复杂的功能之一。HarmonyOS7 把相机能力收敛到 Camera Kit 里架构比以前清晰了不少但流程还是长——创建管理器、选摄像头、建会话、配流、启动预览、拍照、保存……少一步都不行。我第一次写的时候漏了commitConfig预览死活出不来排查了两小时。今天把完整流程捋一遍每一步都有代码和讲解照着走不会翻车。Camera Kit 架构Camera Kit 分三层搞清层级关系才不会迷CameraManager ← 管理层创建/获取所有相机对象 ├── CameraInput ← 输入层选哪个摄像头前/后 ├── PreviewOutput ← 输出层-预览流画面实时显示 ├── PhotoOutput ← 输出层-拍照流拍照后的图片数据 └── PhotoSession ← 会话层把输入和输出串起来 ├── addInput() ├── addOutput() ├── commitConfig() └── start()简单理解CameraManager 是总管CameraInput 是眼睛PreviewOutput/PhotoOutput 是嘴巴Session 把它们绑一起才能工作。权限配置相机开发要两个权限module.json5里必须声明{requestPermissions:[{name:ohos.permission.CAMERA},{name:ohos.permission.WRITE_IMAGEVIDEO}]}CAMERA是拍照权限WRITE_IMAGEVIDEO是保存到相册的权限。都要动态申请静态声明不够import{abilityAccessCtrl,common}fromkit.AbilityKitasyncrequestPermissions():Promiseboolean{constatManagerabilityAccessCtrl.createAtManager()constcontextgetContext(this)ascommon.UIAbilityContextconstpermissions[ohos.permission.CAMERA,ohos.permission.WRITE_IMAGEVIDEO]constresultawaitatManager.requestPermissionsFromUser(context,permissions)returnresult.authResults.every((r:number)r0)}别忘了在onPageShow或按钮点击时调这个方法。用户第一次弹授权弹窗可能拒绝要做好拒绝后的提示处理。创建预览预览是相机开发的第一步也是最关键的一步——预览出不来后面全白搭。import{camera}fromkit.CameraKitprivatecameraManager:camera.CameraManager|nullnullprivatepreviewOutput:camera.PreviewOutput|nullnullprivatephotoOutput:camera.PhotoOutput|nullnullprivatesession:camera.PhotoSession|nullnullprivatesurfaceId:stringasyncinitCamera(surfaceId:string){this.surfaceIdsurfaceId// 1. 获取 CameraManagerconstcontextgetContext(this)ascommon.UIAbilityContextthis.cameraManagercamera.getCameraManager(context)// 2. 获取可用摄像头constcamerasthis.cameraManager.getSupportedCameras()if(cameras.length0){console.error(没有可用摄像头)return}constbackCameracameras[0]// 默认后置// 3. 创建 CameraInputconstcameraInputthis.cameraManager.createCameraInput(backCamera)cameraInput.open()// 4. 创建 PreviewOutputconstoutputCapabilitythis.cameraManager.getSupportedOutputCapability(backCamera)constpreviewProfileoutputCapability.previewProfiles[0]this.previewOutputthis.cameraManager.createPreviewOutput(previewProfile,surfaceId)// 5. 创建 PhotoOutputconstphotoProfileoutputCapability.photoProfiles[0]this.photoOutputthis.cameraManager.createPhotoOutput(photoProfile)// 6. 创建 Session 并配置this.sessionthis.cameraManager.createPhotoSession(cameraInput,this.previewOutput,this.photoOutput)awaitthis.session.commitConfig()awaitthis.session.start()}关键讲解surfaceId从 XComponent 组件获取用来承载预览画面。UI 层要放一个XComponentXComponent({id:cameraXComponent,type:XComponentType.SURFACE,libraryname:}).onLoad((){this.initCamera(this.xComponentController.getXComponentSurfaceId())})outputCapability拿到摄像头支持的配置取第一个就行。想精细控制可以遍历选合适的分辨率commitConfig()一定要调我就是忘了这步预览黑屏排查两小时。配置改了也得重新 commit拍照实现预览跑起来了拍照就简单了——三步走// 1. 先注册照片可用回调setupPhotoCallback(){if(!this.photoOutput)returnthis.photoOutput.on(photoAvailable,(errCode:BusinessError,photo:camera.Photo){if(errCode||!photo){console.error(拍照失败: errCode?.code)return}constimageObjphoto.main imageObj.getComponent(image.ComponentType.JPEG,(err,component){if(err||!component?.byteBuffer)returnthis.saveToGallery(component.byteBuffer)imageObj.release()// ← 这行绝对不能漏})})}// 2. 触发拍照takePhoto(){if(!this.photoOutput)returnconstsettings:camera.PhotoCaptureSetting{quality:camera.QualityLevel.QUALITY_LEVEL_HIGH,rotation:camera.ImageRotation.ROTATION_0,mirror:false}this.photoOutput.capture(settings)}关键 API 讲解photoOutput.on(photoAvailable, ...)拍照成功后的数据回调。必须在拍照前注册不然照片数据拿不到photo.main获取主图还有photo.thumbnail可以拿缩略图getComponent(image.ComponentType.JPEG)从 Image 对象提取 JPEG 数据返回ArrayBufferimageObj.release()释放资源不调会导致 BufferQueue 阻塞后续拍照全部失败。这是最高频的坑photoOutput.capture(settings)触发拍照。settings 可选不传也行保存到相册拿到图片 Buffer 后保存到系统相册import{photoAccessHelper}fromkit.MediaLibraryKitimport{fileIo}fromkit.CoreFileKitasyncsaveToGallery(buffer:ArrayBuffer){consthelperphotoAccessHelper.getPhotoAccessHelper(getContext(this))consturiawaithelper.createAsset(photoAccessHelper.PhotoType.IMAGE,jpg)constfilefileIo.openSync(uri,fileIo.OpenMode.READ_WRITE)fileIo.writeSync(file.fd,buffer)fileIo.closeSync(file.fd)console.info(保存成功: uri)}createAsset在相册创建一条空记录并返回 URI然后用fileIo把数据写进去。整个流程就是先开个房间号再把行李搬进去。前后置切换切换摄像头不是简单换个 CameraInput得重新建 SessionStateisBackCamera:booleantrueasyncswitchCamera(){if(!this.cameraManager)return// 先停当前会话awaitthis.session?.stop()constcamerasthis.cameraManager.getSupportedCameras()consttargetCamerathis.isBackCamera?cameras[1]:cameras[0]this.isBackCamera!this.isBackCameraconstcameraInputthis.cameraManager.createCameraInput(targetCamera)awaitcameraInput.open()// 重建 Sessionthis.sessionthis.cameraManager.createPhotoSession(cameraInput,this.previewOutput!,this.photoOutput!)awaitthis.session.commitConfig()awaitthis.session.start()}别想着只换 Input 不重建 Session——试过不行。Session 绑定了 Input得整体重建。踩坑记录坑表现解决没调commitConfig()预览黑屏Session 配置完必须 commit没调imageObj.release()第二次拍照失败回调里必须释放没动态申请权限直接闪退requestPermissionsFromUsersurfaceId为空预览不显示在 XComponentonLoad里获取后置摄像头不是 cameras[0]预览画面是前置通过cameraPosition筛选权限拒绝后直接调相机崩溃先判断授权结果写在最后Camera Kit 的流程确实长但每一步都有存在的理由。核心就是那张架构图——Manager → Input/Output → Session搞清这个逻辑链流程就不会乱。最坑的三个点我都踩过了commitConfig 别忘、release 别忘、权限别忘。拍照只是相机功能的一部分录像、闪光灯、对焦、变焦这些后面有机会再聊。下一篇换个轻松的话题——用加速度计做个摇一摇几行代码就搞定。

HarmonyOS7 相机拍照：Camera Kit 从预览到保存完整流程

相关推荐

MoocDownloader终极指南：3分钟掌握中国大学MOOC离线下载技巧

鹤壁婚宴烟酒怎么备不浪费又体面？

Steam Deck多系统引导终极指南：3分钟实现无缝系统切换的完整方案

更多资讯

林州特种工培训中心证怎么转异地值不值得考

工地太忙根本没时间复习考试？漯河考高压电工证流程多久拿证全解析

南阳特种工培训学校内部消息：证书过期了不知道怎么复审延期？别慌，这里有详细流程

电工证的最新要求你知道吗？外省证转过来值不值得考

高压电工证年龄规定你知道吗？学历不高也能拿证

工地太忙根本没时间复习考试？长阳电工证怎么考的良心建议来了

今日更新

高压电工证哪里可以挂多久拿证全攻略：实操考试心里没底怕挂科别慌

电工证的理论题目在哪考，外省证怎么转过来

工地太忙根本没时间复习考试，职业学校的电工证值不值得考？

本周精选

安监局电工证分数查询怎么查才能知道含金量高不高

新疆电工作业干活累吗良心建议助你避开考不过的坑

中牟县电工证怎么报名外省证能转吗

本月热门

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

读完文章，想聊聊您的网站？