前面四篇讲了录音、系统音频、效果链、AVSession。做的播放器上线之后，用户反馈来了：有的说播放没声音，有的说听歌卡顿，有的说有杂音。这些音频问题特别难排查——复现率不高，设备不一样表现不一样，日志还不一定打得到。

这篇是系列最后一篇，不讲新功能，讲怎么排查这些音频播放问题。从无声、卡顿到杂音，把我们踩过的坑和排查方法都记下来。

一、播放无声：最常见也最诡异的问题

用户说"点了播放按钮没声音"，这种问题最常见。我们排查下来，原因主要有这几个：

1. 音频焦点没拿到：别的应用正在播放，我们的播放器启动了但被系统静音了。要请求音频焦点，请求成功了才能出声。

2. 设备路由不对：音频输出跑到蓝牙耳机去了，但用户没戴耳机。或者反过来，蓝牙耳机断连了，音频还往蓝牙路由送。

3. 音量是 0：媒体音量被调到最低了。要在播放前检查一下音量，或者至少提示用户。

4. 数据流不对：AudioRenderer 的 streamType 设成了 STREAM_RING，结果跟着铃声音量走，铃声音量是 0 就没声音。要根据场景选对流类型。

排查无声问题的思路：先确认 AudioRenderer 是不是真的在写数据，数据写进去了还是没声音，那就是路由或者焦点的问题。打日志看 getAudioScene() 和 getActiveVolumeType() 的值。

二、播放卡顿：缓冲和性能的问题

播放卡顿分两种：一种是断断续续的，一种是偶尔卡一下。原因不一样。

1. 缓冲不够：网络流播放的时候，预缓冲时间太短，网络一波动就卡。把缓冲区调大一点，缓冲到 3-5 秒再开始播，会稳很多。

2. 解码性能不够：高码率的音频在低端机上解码吃力，每一帧都算不过来。可以做降级处理——低端机播低码率版本。

3. 主线程被占：播放回调在子线程，但 UI 更新或者其他逻辑占了 CPU，导致音频线程调度不及时。要确保音频相关的线程优先级足够高。

4. I/O 瓶颈：从文件读数据太慢，磁盘 I/O 跟不上。本地文件播放一般不会，但如果是从网络读，就要做好预读和缓存。

三、杂音和爆音：最烦人的问题

杂音问题最难定位，因为可能是任何一环的问题。我们遇到过几种：

1. 采样率不匹配：音频文件是 44.1kHz，但 AudioRenderer 配成了 48kHz，就会出现变速变调或者杂音。一定要按文件实际采样率配置输出。

2. 缓冲区大小不对：缓冲区太小，写数据不及时，就会有爆音。用推荐的 bufferSize，不要自己瞎设。

3. 效果链加的问题：前面讲的实时效果链，如果参数调得不好，会出现削波失真。检查一下输出电平有没有超过 0dB。

4. 硬件底噪：有些设备本身就有底噪，和应用没关系。这种问题我们解决不了，只能提示用户换个设备或者调大音量。

四、关键排查工具和方法

排查音频问题，光靠打日志不够，还要用工具：

1. DevEco Studio 的 Audio Profiler：能看到音频流的实时数据、缓冲区状态、采样率。卡顿的时候看一下缓冲区是不是空了。

2. 系统音频调试工具：看当前活跃的音频流有几个、分别是什么类型、路由到哪个设备。无声的时候先看这个。

3. 日志过滤：用 audio 关键字过滤系统日志，看有没有 ERROR 级别的报错。很多问题系统日志里都有提示。

4. 复现步骤：用户反馈问题的时候，一定要问清楚：什么设备、什么系统版本、播放什么音频、什么时候卡、有没有连蓝牙。条件不一样，问题原因可能完全不同。

五、上线前的检查清单

每次发版之前，我们都会跑一遍音频相关的检查项：

1. 不同设备测试：至少在高中低三档设备上测一遍。低端机的解码性能和内存都不一样。

2. 蓝牙切换测试：播放过程中连蓝牙、断蓝牙，看音频能不能正常切换路由。

3. 来电中断测试：播放过程中来电话，挂断之后能不能自动恢复播放。

4. 前后台切换：切到后台再切回来，播放状态是不是正常，会不会突然出声或者停了。

5. 音量按键测试：按音量键，调的是不是媒体音量，不是铃声音量。

6. 资源泄漏检查：反复进出播放页面 20 次，看内存是不是稳定。AudioRenderer 和 AVSession 都要及时 release。

音频问题就是这样——写的时候功能都能跑，真上线了各种边界情况都冒出来。排查多了就知道，大部分问题不是代码写错了，而是没有处理好边界情况：焦点、路由、中断、资源释放。这些细节做好了，播放体验才稳。

这个系列五篇就到这里。从录音到系统音频，从实时效果到 AVSession，最后讲问题排查，把 HarmonyOS 音频开发的主要环节都覆盖了。音频开发这个方向，看起来都是 API 调用，但真要做到稳定好用，每个细节都得抠。