17、测试与调试：使用dumpsys media.audio_flinger查看效果状态、logcat过滤音频效果日志、常见问题定位

做音频效果开发，最头疼的是什么？

不是写代码，是出了问题不知道问题在哪。

我见过太多同事，花了一周写效果代码，调试却花了三周。说白了，调试能力才是区分初级和资深工程师的分水岭。今天我就把我在音频效果调试上踩过的坑、总结的经验，一次性讲清楚。

17.1 用 dumpsys 查看 AudioFlinger 内部状态

dumpsys media.audio_flinger 是 Android 音频系统最强大的调试工具，没有之一。它能把 AudioFlinger 内部的所有状态 dump 出来，包括效果链、混音器、线程信息等。

我个人习惯，每次写完效果代码，第一件事就是跑一遍这个命令，看看效果有没有正确挂载。

17.1.1 基本用法

adb shell dumpsys media.audio_flinger

输出内容非常多，通常有几万行。我们需要重点关注的是 Effect Chains 部分。

17.1.2 过滤效果链信息

输出太长了怎么办？用 grep 过滤：

adb shell dumpsys media.audio_flinger | grep -A 20 "Effect Chain"

这样就能看到每个音频流上挂载的效果链。输出大概长这样：

Effect Chain:
    Session: 12
    Effect ID: 0xb4000072
    Type: b707c6e0-5c5b-11e6-8b7e-0002a5d5c51b  // 这是效果 UUID
    Enabled: true
    Config: ...
    State: ACTIVE

这里有个关键点：State 字段。如果显示 ACTIVE，说明效果正在运行。如果是 IDLE 或 STOPPED，那就要查查为什么没激活了。

17.1.3 查看具体效果的参数

有时候效果挂上了，但参数不对。可以用这个命令查看效果的详细配置：

adb shell dumpsys media.audio_flinger | grep -A 50 "Effect ID: 0xb4000072"

这里能看到效果的 Config 段，里面包含了所有参数值。我曾经遇到过一次，效果参数传进去全是 0，查了半天发现是上层传参时类型转换错了。

17.2 logcat 过滤音频效果日志

dumpsys 看的是静态状态，logcat 看的是动态行为。两者配合使用，基本能解决 90% 的问题。

17.2.1 关键 TAG

音频效果相关的 log TAG 主要有这几个：

TAG	说明	优先级
AudioFlinger	AudioFlinger 主日志，效果创建/销毁都在这里	高
Effect	效果引擎日志，处理过程中的信息	高
EffectHal	HAL 层效果日志，底层实现细节	中
audio_hw_primary	硬件抽象层日志，跟硬件相关的问题	低

17.2.2 常用过滤命令

我一般这样过滤：

adb logcat -s AudioFlinger:V Effect:V EffectHal:V

如果想看更详细的信息，可以加上时间戳和进程号：

adb logcat -v time -s AudioFlinger:V Effect:V | grep "effect"

17.2.3 实战案例：效果没声音

有一次，我写了一个均衡器效果，挂上去之后完全没声音。logcat 里没有任何错误，dumpsys 也显示效果是 ACTIVE 状态。

我排查了很久，最后把 logcat 级别调到 VERBOSE，才发现问题：

D/Effect   : process() called with 0 frames
D/Effect   : Skipping process: no input data

原来是音频数据根本没送到效果处理函数里。追下去发现，是效果链的输入 buffer 配置错了，导致 AudioFlinger 认为这个效果不需要处理数据。

嗯，这个坑我印象特别深。从那以后，我遇到效果没声音，第一件事就是看 process() 有没有被调用，调用了多少次。

17.3 常见问题定位

做音频效果开发，有些问题几乎每个人都会遇到。我把它们总结成了一张图：

17.3.1 效果未生效

这是最常见的问题。我总结了几步排查法：

1. 先看 dumpsys：效果有没有出现在 Effect Chain 里？State 是不是 ACTIVE？
2. 再看 logcat：有没有 "Failed to create" 之类的错误？
3. 检查 UUID：效果库的 UUID 和代码里注册的是否一致？我见过有人把 UUID 写错了一个字符，查了两天。
4. 检查库文件：.so 文件有没有推到正确的位置？权限对不对？

17.3.2 效果有杂音或爆音

这个问题通常跟数据格式有关。我遇到过的情况：

• buffer 大小不匹配：效果处理的 buffer 大小和 AudioFlinger 给的不一致，导致数据错位。
• 采样率不匹配：效果内部假设的采样率和实际的不一样。比如效果写死了 44100，但系统用的是 48000。
• 浮点溢出：处理过程中数值超出了 [-1.0, 1.0] 范围，产生削波失真。

怎么排查？我一般会在效果处理函数里加一些调试打印，把输入输出的最大值、最小值打出来。如果发现输出值超过 1.0，那就是溢出了。

17.3.3 性能问题导致卡顿

音频效果对实时性要求很高。如果处理时间超过了 buffer 时长，就会出现卡顿、断音。

我的排查方法：

• 用 systrace 看效果处理线程的 CPU 占用
• 检查效果处理函数里有没有耗时的操作，比如内存分配、文件 I/O
• 看看有没有不必要的锁竞争

我记得有一次，一个降噪效果在低端设备上卡得不行。查了半天，发现是算法里用了一个 std::vector 的 resize 操作，每次处理都重新分配内存。改成预分配后，问题就解决了。

17.4 调试工具链总结

最后，我把常用的调试工具整理成了一张表：

工具	用途	使用场景
dumpsys media.audio_flinger	查看 AudioFlinger 内部状态	效果是否挂载、状态是否正确
logcat	查看运行时日志	效果创建、处理过程中的错误
systrace	性能分析	卡顿、延迟问题
strace	系统调用跟踪	文件访问、权限问题

说白了，调试音频效果没有捷径。就是多看、多试、多总结。你想想看，我上面讲的这些坑，哪一个不是踩出来的？

嗯，今天就先讲到这里。这些工具和方法，你平时多练练，慢慢就会形成自己的调试套路了。

---