miniaudio在Android 15上的音频设备管理问题分析与解决方案

问题背景

miniaudio是一个轻量级的音频库，广泛应用于游戏和多媒体应用中。近期在Android 15平台上，开发者报告了音频系统在设备切换和长时间运行后出现的崩溃和静音问题。这些问题主要出现在设备重新路由（如蓝牙耳机连接/断开）和系统长时间挂起后恢复的场景中。

核心问题分析

1. AAudio流双重关闭导致的崩溃

在Android 15上，当音频设备发生变更（如连接蓝牙耳机）时，miniaudio会尝试重新初始化音频流。在这个过程中，存在一个竞态条件：

• 设备断开连接时，工作线程调用ma_close_stream__aaudio()
• 同时，UI线程也可能调用ma_device_uninit__aaudio()中的关闭流操作
• 这导致AAudio流被多次关闭，引发"Pure virtual function called"崩溃

2. 兼容性工作区导致的初始化失败

miniaudio中针对旧版Android的兼容性工作区代码在某些情况下会导致音频流初始化失败：

if (!pConfig->aaudio.enableCompatibilityWorkarounds || ma_android_sdk_version() > 30)

这段逻辑在Android 15上会跳过必要的缓冲区设置，导致后续的音频流初始化失败，最终表现为应用无声。

3. 状态等待与线程同步问题

在设备重新初始化过程中，miniaudio会等待AAudio流状态变为STARTED。然而：

• 等待操作没有考虑设备可能被其他线程关闭的情况
• 超时设置较长（5秒），增加了竞态条件发生的窗口期
• 缺乏错误状态通知机制，应用无法获知初始化失败

解决方案

1. 流关闭操作的线程安全保护

通过添加NULL指针检查和同步机制，确保流不会被多次关闭：

if (pStream != NULL) {
    return ma_result_from_aaudio(((MA_PFN_AAudioStream_close)pContext->aaudio.AAudioStream_close)(pStream));
}
return MA_SUCCESS;

2. 优化兼容性工作区逻辑

针对Android不同版本调整工作区策略：

• 对于API 31+设备，移除不必要的缓冲区设置限制
• 保留对旧版本的特殊处理，但通过编译选项控制
• 增加配置选项让开发者可以手动控制工作区行为

3. 增强状态管理和错误处理

改进设备状态机管理：

• 添加重试机制处理临时性初始化失败
• 缩短状态等待超时时间
• 增加错误通知回调，让应用能感知关键错误
• 完善日志记录，便于问题诊断

实施建议

对于使用miniaudio的Android开发者，建议：

1. 更新到包含修复的最新版本miniaudio
2. 在应用层实现音频状态监控和恢复逻辑
3. 针对长时间运行的音频应用，增加适当的生命周期管理
4. 在关键音频路径添加日志，便于问题追踪

总结

Android音频系统的复杂性，特别是设备切换和电源管理相关的行为，给音频库的实现带来了挑战。miniaudio通过上述改进，显著提升了在Android 15平台上的稳定性和可靠性。开发者应当理解这些改进背后的设计考虑，并在自己的应用中实施相应的容错和恢复策略，以提供最佳的用户体验。

未来随着Android音频系统的演进，miniaudio团队将继续监控平台行为变化，及时调整实现策略，确保库在不同Android版本上的兼容性和性能表现。