HarmonyOS趣味相机实战第29篇AudioRenderer合成快门声、并发门闩与资源释放摘要快门声只有一百多毫秒却涉及音频流格式、PCM 字节序、播放器生命周期、重复点击、静音策略和相机回调时序。直接播放一个资源文件看似简单但会增加资源管理和首次解码延迟每次拍照新建 AudioRenderer 又必须保证任何异常路径都能停止并释放否则连续拍摄后可能出现声音叠加、音频对象泄漏或拍照按钮被播放任务拖慢。本文基于D:/APP/1quweixiangji新增的ShutterSoundService.ets复盘 44.1kHz 单声道 S16LE PCM 的程序化生成、双频点击音、衰减包络、playing并发门闩以及try/finally资源闭环。同时分析它与 CameraKit 拍照结果、ArkUI 闪屏反馈和用户开关之间的边界给出真机测试与后续优化方案。工程背景与源码定位文件作用entry/src/main/ets/service/ShutterSoundService.ets创建 AudioRenderer、合成并播放 PCMentry/src/main/ets/pages/Index.ets拍照成功后触发声音和视觉反馈entry/src/main/ets/service/CameraPreviewService.ets执行真实 PhotoOutput 拍照entry/src/main/ets/model/DecorationModels.ets相机结果与页面领域模型entry/src/main/module.json5模块配置与权限边界环境与音频参数参数当前值含义SDKHarmonyOS 6.0.2(22)工程目标版本APIohos.multimedia.audio音频渲染能力采样率44100 Hz每秒采样数声道单声道快门提示无需立体声样本格式S16LE16位有符号小端 PCM编码RAW直接写入原始采样时长0.16 秒短促点击反馈用途STREAM_USAGE_MUSIC当前音频流用途一、快门声应与真实拍照结果绑定页面调用相机后再触发反馈constcaptureState:CameraCaptureStateawaitCameraPreviewService.capturePhoto(this.captureQualityPreference(),false);if(this.shutterSoundEnabled){this.triggerShutterFeedback();}这一位置意味着反馈发生在拍照调用返回之后而不是用户按下按钮的瞬间。产品需要明确声音代表什么若代表“已接收点击”应在进入captureNow()时播放。若代表“系统已接受拍照请求”应在PhotoOutput.capture()成功后播放。若代表“真实照片已可用”应在photoAvailable确认后播放。趣味相机更适合绑定真实结果避免相机不可用时仍发出成功快门声。失败场景可以只更新状态文案不制造“已经拍到”的错觉。二、服务层隔离音频实现页面只调用ShutterSoundService.play();AudioRenderer 的创建、格式、缓冲区和释放都留在服务层。这样页面不需要知道 PCM 格式也不会在多个按钮里复制音频生命周期代码。服务接口返回Promisevoid页面当前不等待它privatetriggerShutterFeedback():void{this.shutterFeedbackVisibletrue;ShutterSoundService.play();setTimeout((){this.shutterFeedbackVisiblefalse;},650);}这是有意的非阻塞设计声音播放不能延迟结果预览。服务内部必须自行捕获异常否则未处理的 Promise 拒绝会污染页面运行日志。三、AudioRendererOptions必须与缓冲区一致项目配置constoptions:audio.AudioRendererOptions{streamInfo:{samplingRate:audio.AudioSamplingRate.SAMPLE_RATE_44100,channels:audio.AudioChannel.CHANNEL_1,sampleFormat:audio.AudioSampleFormat.SAMPLE_FORMAT_S16LE,encodingType:audio.AudioEncodingType.ENCODING_TYPE_RAW},rendererInfo:{usage:audio.StreamUsage.STREAM_USAGE_MUSIC,rendererFlags:0}};四个流参数必须与ArrayBuffer的真实布局一致。S16LE 表示每个采样占 2 字节、低位字节在前若用浮点值直接写入或按大端保存播放结果会变成噪声。四、采样数量决定时长常量constSAMPLE_RATE:number44100;constDURATION_SECONDS:number0.16;采样数constsampleCount:numberMath.floor(SAMPLE_RATE*DURATION_SECONDS);本例得到 7056 个采样。单声道 S16LE 每个采样 2 字节因此缓冲区大小是 14112 字节constbuffer:ArrayBuffernewArrayBuffer(sampleCount*2);如果改成双声道缓冲区布局和写入步长都必须同时变化不能只改channels。五、用DataView写入小端PCMconstview:DataViewnewDataView(buffer);for(letindex:number0;indexsampleCount;index){constvalue:numbercreateSample(index,sampleCount);view.setInt16(index*2,Math.floor(value*32767),true);}第三个参数true表示小端与 S16LE 对应。归一化波形先限制到[-1, 1]再乘以 32767 转成 16 位整数可避免溢出绕回造成爆音。六、衰减包络避免突然截断项目使用二次幂衰减constprogress:numberindex/sampleCount;constenvelope:numberMath.pow(1-progress,2.2);没有包络时正弦波在任意相位突然停止会形成不连续边缘听起来像尖锐爆点。envelope让振幅从强到弱逐渐归零适合短促机械点击。为了让起点也更平滑可加入极短 attackconstattackSamples:numberMath.floor(SAMPLE_RATE*0.003);constattack:numberMath.min(1,index/attackSamples);constenvelope:numberattack*Math.pow(1-progress,2.2);3ms 渐入足以降低硬切又不会让快门声显得迟钝。七、多频叠加构造机械质感consttime:numberindex/SAMPLE_RATE;constsecondTap:numberindexsampleCount*0.42?0.55:0;consttone:numberMath.sin(2*Math.PI*1750*time)*envelopeMath.sin(2*Math.PI*920*time)*envelope*0.45Math.sin(2*Math.PI*2300*time)*envelope*secondTap;1750Hz 提供清晰点击920Hz 增加厚度后半段 2300Hz 模拟第二次机械触点。它不是录音而是运行时生成的确定性波形避免携带外部音频文件。最后限制振幅constvalue:numberMath.max(-1,Math.min(1,tone*0.72));系数 0.72 留出混合余量。多个正弦波直接相加可能超过 1不裁剪会转换溢出。八、完整播放生命周期必须顺序执行rendererawaitaudio.createAudioRenderer(options);awaitrenderer.start();awaitrenderer.write(ShutterSoundService.createClickBuffer());awaitrenderer.drain();awaitrenderer.stop();各步骤职责步骤作用create申请音频渲染资源start进入可写播放状态write提交 PCM 缓冲区drain等待已写数据播放完stop停止当前流release释放系统资源若不等待drain()就 stop短音效可能被截断若只 stop 不 release连续拍照会不断创建未释放对象。九、finally保证异常路径释放letrenderer:audio.AudioRenderer|nullnull;try{rendererawaitaudio.createAudioRenderer(options);awaitrenderer.start();awaitrenderer.write(buffer);awaitrenderer.drain();awaitrenderer.stop();}catch(error){hilog.warn(DOMAIN,TAG,play shutter sound failed: %{public}s,JSON.stringify(error));}finally{if(renderer!null){try{awaitrenderer.release();}catch(releaseError){hilog.warn(DOMAIN,TAG,release renderer failed: %{public}s,JSON.stringify(releaseError));}}}即使 start、write、drain 或 stop 任一步失败finally 都会尝试释放。release 自身也可能失败因此需要独立 try/catch不能让清理异常遮盖原始错误。十、playing门闩阻止声音叠加privatestaticplaying:booleanfalse;staticasyncplay():Promisevoid{if(ShutterSoundService.playing){return;}ShutterSoundService.playingtrue;try{// play}finally{ShutterSoundService.playingfalse;}}门闩检查与赋值之间没有await在单线程事件循环中可以阻止并发调用同时进入。无论播放成功还是失败finally 都重置状态。这里采用“忽略后续请求”策略适合快门反馈。若音效必须逐个播放则应使用队列但连拍时排队会导致声音落后于画面不符合快门反馈语义。十一、音频失败不能让拍照失败声音是增强反馈不是拍照必要条件。服务捕获错误后返回页面仍然显示照片。正确的依赖方向是真实拍照成功 - 尝试声音 视觉反馈 - 展示结果 声音失败 - 记录诊断不回滚照片不要把await ShutterSoundService.play()放在照片保存事务中也不要因音频设备不可用把captureState.success改为 false。十二、视觉反馈与声音并行this.shutterFeedbackVisibletrue;ShutterSoundService.play();setTimeout((){this.shutterFeedbackVisiblefalse;},650);视觉反馈持续 650ms音效约 160ms两者不必等长。视觉层应避免遮住结果页按钮并在页面销毁时防止旧定时器写回状态。可以保存 timer ID 或 generationprivateshutterFeedbackGeneration:number0;privatetriggerShutterFeedback():void{constgeneration:numberthis.shutterFeedbackGeneration;this.shutterFeedbackVisibletrue;ShutterSoundService.play();setTimeout((){if(generationthis.shutterFeedbackGeneration){this.shutterFeedbackVisiblefalse;}},650);}新反馈不会被旧 timer 提前关闭。十三、用户开关要与平台规则分开页面通过shutterSoundEnabled控制应用自定义音效。需要注意某些地区或设备对相机快门提示有系统级规则应用自定义开关不能用来规避平台要求。上线前应验证目标设备的系统 CameraKit 行为和应用商店政策。开关只控制应用额外生成的 PCMif(this.shutterSoundEnabled){this.triggerShutterFeedback();}不要修改系统音量、静音模式或其他应用音频状态。十四、STREAM_USAGE需要按语义选择当前使用STREAM_USAGE_MUSIC兼容性直观但快门是短提示音。后续应根据目标 SDK 提供的 StreamUsage 枚举评估更符合提示/系统交互的用途。不同 usage 可能影响音量通道、焦点、静音策略和路由。选择时验证静音模式下是否符合产品预期。蓝牙耳机连接时声音路由。后台音乐是否被打断或 duck。通话中是否误播放。系统音量键控制哪个通道。不要仅凭模拟器结果决定音频 usage。十五、频繁创建Renderer的取舍每次播放都创建并释放优点是所有权简单、闲置时不占资源缺点是可能有首次延迟。两种策略策略优点风险每次创建资源闭环清晰创建延迟、频繁分配复用单实例低延迟状态机复杂、生命周期更长0.16秒低频拍照可优先选择每次创建。若性能数据证明延迟明显再在 Ability 前台预热并在后台/销毁时释放而不是凭感觉持久化 AudioRenderer。十六、测试PCM生成器createClickBuffer()是纯函数可验证it(creates 160ms mono s16le buffer,0,(){constbuffer:ArrayBufferShutterSoundService.createClickBufferForTest();expect(buffer.byteLength).assertEqual(14112);});还应测试所有采样值在 Int16 范围。首尾振幅没有异常爆点。相同输入生成相同字节。修改时长后大小按公式变化。双调用时第二次不会创建 renderer。create/start/write/drain/stop 任一步失败都调用 release。AudioRenderer 可通过接口包装注入 fake记录方法顺序。十七、真机验收矩阵场景期望单次真实拍照一次短促声音无截断相机不可用不发出成功快门声快速连点不叠加、不排队延迟关闭声音开关不播放自定义声音音量最小/静音遵循系统和产品策略蓝牙耳机连接路由行为明确后台音乐播放不产生不合理打断页面退出中播放renderer最终释放连续拍摄100次资源数和内存不持续增长十八、常见问题排查现象高概率原因排查点播放是噪声格式或字节序不匹配S16LE与setInt16小端声音结尾爆点波形突然截断衰减包络与drain连拍声音重叠缺少playing门闩play入口偶发无声renderer状态或路由异常start/write日志拍照结果显示变慢页面await了音频播放非阻塞触发连续拍照内存上涨release路径缺失finally十九、发布前验收清单PCM 格式、采样率、声道和写入布局一致。缓冲区长度由采样率与时长计算。波形有渐入/衰减并限制到[-1,1]。write 后等待 drain再 stop 和 release。所有异常路径都进入 finally。连续调用不会声音重叠或形成滞后队列。音频失败不影响真实照片结果。视觉反馈 timer 不会被旧任务误关闭。用户开关不改变系统静音或音量状态。真机验证音频路由、后台音乐和连续拍摄。总结程序化快门声的价值不只是省去一个音频文件而是让音频格式、时长和波形都可审查、可测试。AudioRenderer 负责播放 RAW PCMDataView 按 S16LE 写入采样包络解决硬截断playing门闩阻止重叠try/finally确保任何失败都释放系统资源。把声音定位为真实拍照后的非关键反馈并与视觉效果并行执行既能保持相机主链路响应也能在音频设备异常时安全降级。最后用真机覆盖静音、路由、后台音乐和长时间连拍才能把一声短点击做成稳定的工程能力。
