文章目录前言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 别忘、权限别忘。拍照只是相机功能的一部分录像、闪光灯、对焦、变焦这些后面有机会再聊。下一篇换个轻松的话题——用加速度计做个摇一摇几行代码就搞定。