2.4 ApusTAI 声音

文档版本：ApusTAI 1.0.27；更新日期：2026-10-06。

版本说明：本次同步文档版本与安装入口。保留的截图、视频及案例测试记录来自 ApusTAI 1.0.21；未逐项重测的结果按原记录说明，升级后请重新编译并复核。

适用版本：ApusTAI 1.0.27。

添加声音文件

打开工程，在顶部“工程”选项卡中点击“声音”，进入声音管理器。点击“添加声音”选择文件；当前版本的文件选择器支持 WAV 和 MP3。导入后可在列表中查看声音 ID、文件名和文件大小，并使用“播放声音”预听；“上移”“下移”用于调整列表顺序。

开机音乐与触摸伴音

需要开机音乐时，在声音管理器中点击“选择开机音乐”，选择文件并确认。管理器提示所选文件将保存为 welcome.mp3。然后点击顶部“工程 > 设置”，在右侧“工程属性”中启用“开机音乐”。保存工程后，用目标设备验证实际播放效果。

“工程属性 > 触摸伴音”提供“静音”“蜂鸣器”“音频”三种选项。选择“音频”时，应先准备工程所需的声音资源，并在目标设备上验证触摸反馈。

音频系统标签

在“工程 > 地址标签”中切换到“系统参数标签”，搜索 SysSnd，可以查看当前版本提供的音频标签：

标签	地址	用途
SysSndVol	LW0140	喇叭音量，范围 0～100
SysSndPlay	LW0141	播放音频 ID
SysSndState	LW0142	音频播放控制
SysSndPlayTime	LW0143	已播放时间，单位为秒
SysSndTotalTime	LW0144	音频总时长，单位为秒

使用控件或脚本控制音频前，应在当前工程中核对标签的读写权限，并按目标设备的固件资料确认音频 ID 编码和控制值。旧版示例中的码率限制、位编码以及固定触摸音文件名尚未在 ApusTAI 1.0.21 中核实，不宜直接沿用。

可复现案例：提示音与音量控制

下载 DocSoundTest.apustai，在 ApusTAI 1.0.21 中用“打开范例工程”导入。工程型号为 E043C4827（480 × 272），协议为 DCBUS；导入后先编译，再运行“虚拟屏调试”。

1. 在“工程 > 声音”中导入 Alarm01.wav。示例工程已包含该文件；更换声音时，要重新选择按钮的声音文件并编译。
2. 在页面上放置数值显示控件，读取系统标签 SysSndVol（LW0140），用于观察当前音量。
3. 放置“字设置”按钮，设置写入地址 LW0140、操作模式“写常量”、常量值 80、数据类型 UINT16、执行时机“松开时”。启用“播放声音”，选择 Alarm01.wav。另一个按钮以相同方式把 LW0140 写为 0，用于对照。
4. 在模拟器中先点击“播放提示音”，确认数值显示为 80；再点击“音量设为0”，确认显示为 0。示例按钮的图标分别表示有声与静音状态，便于识别操作。

上图编号：1 写入地址 LW0140；2 常量值 80（同组还需核对操作模式、数据类型和执行时机）；3 启用“播放声音”；4 选择声音文件 Alarm01.wav。

本例已在模拟器中验证两次写入后的 LW0140 读数，并确认编译产物包含音频资源。实际扬声器播放、音质、触摸伴音与实体屏上的音量行为尚未验证；部署时需在目标设备逐项试听。音量 0 与 80 只是本案例的测试值，不代表设备推荐音量。