KunSpace
返回作品
AcouTest 声测大师
AndroidAudioSoundbar调试工具ADB

AcouTest 声测大师

Windows 端 Android 音频综合测试工具:麦克风/雷达/喇叭/多声道、Loopback+Ref、扫频与气密性、HAL 录音、Logcat、100 条唤醒率批量测试、遥控器与截图等,面向 Soundbar 等产品装机与验收。

2025年6月1日源码

项目简介

声测大师(AcouTest) 是一款用于 Android 设备音频测试与调试 的综合桌面工具。通过 USB 或网络 ADB 连接设备后,可在电脑端完成播放、录音、日志抓取、遥控器模拟、截图等操作,覆盖 硬件装机验收 → 声学测试 → 唤醒率回归 全流程。

源码与完整说明见 GitHub — AcouTest

AcouTest 主界面:设备选择与麦克风测试

小提示:硬件装机时建议先确认 麦克风、雷达、喇叭 功能正常,再配合本工具做通道、扫频、唤醒率等测试。

界面结构

  • 顶部:设备选择下拉框、「刷新」、「网络连接」、设备状态(已选择 / 未连接)
  • 主区域(大标签 → 子标签):
大标签 子功能
硬件测试 麦克风测试、雷达检查、喇叭测试、多声道测试
声学测试 扫频测试、气密性测试、震音测试
音频调试 Loopback 和 Ref 测试、HAL 录音、Logcat 日志、唤醒监测、系统指令
常用功能 遥控器、本地播放、截图、OpenClaw、账号登录
烧大象 key U 盘烧 key、SN 烧 key(内部功能,按需开启)

使用前先在顶部 选择设备;列表为空时点击 刷新,并确保设备已授权 ADB 调试。

主要功能与操作

Loopback 和 Ref 通道测试

用途:播放多声道音频(如 7.1),同时录制多通道,验证音频回路与参考信号。

典型命令(工具会按界面参数生成类似命令):

# 播放
tinyplay /sdcard/Nums_7dot1_16_48000.wav -d 0
# 录制(示例:10 通道)
tinycap /sdcard/test_10ch.wav -d 6 -c 10 -r 16000 -p 480

操作:音频调试 → Loopback 和 Ref 测试 → 设置录制设备 ID、通道数、采样率、播放设备、保存路径 → 开始通道测试 → 播放结束后 停止录制(文件自动拉取到本机)。

结果:默认 output/loopback/;可用 Audacity 查看波形。下图为 4 mic + 6 ref 正常数据参考:

Loopback 4mic+6ref 正常波形


麦克风测试

用途:录制麦克风输入并保存 WAV,验证 2 mic / 4 mic 等录音链路。

# 2 mic
tinycap /sdcard/test_2mic.wav -D 0 -d 3 -c 2 -r 16000
# 4 mic
tinycap /sdcard/test_4mic.wav -D 0 -d 3 -c 4 -r 16000

操作:硬件测试 → 麦克风测试 → 选择麦数、PCM 设备(-D)、设备 ID(-d)、采样率 → 开始麦克风测试停止录制 → 可 查看录音波形

结果:默认 output/mic_test/(如 test_4mic.wav)。下图为正常 4 mic 波形:

正常 4 mic 波形


多声道 / 喇叭 / 扫频 / 气密 / 震音

功能 入口 要点
多声道测试 硬件测试 → 多声道测试 7.1 / 2.1 / 2.0;默认 audio/channel/ 下测试文件;可读取 alsaPORT 播放设备
喇叭测试 硬件测试 → 喇叭测试 默认 audio/speaker/speaker_default.wav 或自定义音频
扫频测试 声学测试 → 扫频测试 大象扫频或自定义;支持批量;结果 output/sweep_recordings/
气密性测试 声学测试 → 气密性测试 堵 mic / 不堵 mic 两阶段录制 + 频谱对比
震音测试 声学测试 → 震音测试 播放指定 WAV,人工判断通过 / 不通过

HAL 录音 · Logcat · 系统指令

  • HAL 录音:音频调试 → HAL 录音;管理录音属性、设置设备端目录(默认 data/vendor/audiohal),录完拉取到 output/hal_dump/output/hal_custom/
  • Logcat 日志:左侧管理需放开的属性 → 放开打印 / 停止打印;右侧设置过滤器与保存路径 → 开始抓取。过滤器示例:AudioFlinger:V AudioPolicyManager:V*:W(仅警告及以上)
  • 系统指令:预设或自定义 ADB / shell 指令,支持新增、删除、运行选中

唤醒监测(含 100 条唤醒率测试)

用途:监测设备唤醒日志(如 B 款 Detected hotword / A 款 LIBAS_HOTWORD_DETECTION_RECEIVED),并支持 100 条唤醒率批量测试

仅监测唤醒次数:USB / 网络 ADB 连接 → 唤醒监测 → 开始监测 / 停止监测,在「最近唤醒日志」查看命中。

100 条唤醒率测试(需额外准备):

  1. 播放方式:笔记本通过 蓝牙音箱 播放 100 条唤醒词 WAV;被测设备运行 AudioPlayercom.player.demo)播放 APK 内音频;设备麦克风同时采集两路声音触发唤醒
  2. 文件准备(程序根目录 wakeup_count/):
    • art_100.txt:100 个 WAV 文件名列表
    • selected_100/:对应唤醒词 WAV
    • AudioPlayer.apk:未安装时点击测试会自动安装
  3. 参数:系统音量区间(0–25)、每档播放条数、播放间隔、音效模式(如 1,2,5 对应 Movie / Music / Normal 等)
  4. 结果:按音效 × 音量档统计唤醒率;可 保存唤醒率结果 到文件

雷达检查

用途:检查雷达 TTY 节点是否存在,并通过 logcat 监控 updateGain 等关键值判断雷达是否响应。

操作

  1. TTY 设备检查:硬件测试 → 雷达检查 → 检查 TTY 设备;出现 ttyACM0 等节点表示存在雷达节点

雷达 TTY 设备检查

  1. 日志监控:设置过滤关键词(默认 updateGain)→ 开始监控 → 用手靠近 / 远离雷达区域,观察数值变化 → 停止监控

雷达 logcat 监控 updateGain 变化

  1. AIEQ Sweet Spot:参考界面内 AIEQ 操作指南(如长按遥控器静音键进入 AI 设置),再结合上述检查

遥控器 · 截图

  • 遥控器:常用功能 → 遥控器;适配遥控器 重新配对;发送 ↑↓←→、OK、Vol±、返回、设置等按键
  • 截图:常用功能 → 截图功能 → 截取屏幕;默认 output/screenshots/

测试结果保存位置

功能 默认目录
Loopback / Ref output/loopback/
麦克风测试 output/mic_test/
扫频测试 output/sweep_recordings/
气密性测试 output/airtightness/
HAL 录音 output/hal_dump/output/hal_custom/
Logcat output/logcat/
截图 output/screenshots/

各功能界面均可修改为自定义目录。

快速上手

  1. 双击运行 AcouTest 主程序(如 AcouTest.v2.0.0.exe,以发布包为准)
  2. USB 连接 Android 设备 → 顶部 选择设备(无设备则 刷新 + 确认 ADB 授权)
  3. 按需求进入对应大标签与子标签,按界面说明操作
  4. 自动化场景可通过 OpenClaw HTTP API(默认 127.0.0.1:8765)带 Token 调用刷新设备、开麦测、抓 log 等动作

使用要求

  • 系统:Windows
  • 环境:已安装 ADB,adb devices 可见设备
  • 设备:开启 USB 调试并授权本机;HAL 录音、部分系统指令可能需要 root 或相应权限
  • 测试文件:音频 / 扫频文件放在 audio/channel/audio/speaker/audio/sound/audio/elephant/ 等目录,或通过界面浏览选择

工具链

常与以下项目联动:

技术栈

Python 桌面工具 · ADB · Android 音频 / HAL · tinycap / tinyplay · 与设备端 AudioPlayer APK 联动

AcouTest 声测大师 — KunSpace · KunSpace