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分钟实现无缝系统切换的完整方案

更多资讯

Python命令行参数解析：argparse模块详解与实战

Spring Bean注入：原理、实践与最佳选择

R2 SQL边缘计算聚合分析技术解析与应用

React Native鸿蒙跨平台开发实战：用户中心优化

复试训练方法论：从目标拆解到能力跃迁

TensorRT插件开发：原理、实现与性能优化

今日更新

Linux 内核 ARM 虚拟内存布局全解析：从 4GB 地址空间划分到源码级验证

AIGC降重工具测评与教育应用指南

数据容灾核心指标与实战方案解析

本周精选

超人会飞不算本事：系统稳定依赖清晰规则与边界设计

超人VS蜘蛛侠：拆解超级IP的影响力与传播方法论

基于CNN的调制信号识别：MATLAB实现时频图分类实战

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

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