开发手册

1. 音频管理

ApusTAI 支持 WAV、MP3，可配置开机音乐、触摸伴音和按钮声音，通过系统变量控制播放。

示例声音文件：

文件	时长	本例音频 ID	用途
prompt.wav	0.5 秒	0	按钮提示音
playback-demo.wav	12 秒	1	播放、暂停、停止及进度演示

两份 WAV 均为 22050 Hz、16 位、单声道。点击可试听，右键“链接另存为”可下载。音频 ID 以导入后的列表为准。

点击“工程 → 声音”打开声音管理器。

1.1 添加与试听

1. 点击“添加声音”，选择 WAV 或 MP3 文件。
2. 选中文件，点击“播放声音”试听。
3. 点击“确定”，编译时生成音频资源。

普通音频按列表 ID 引用，文件名可自定义。

1.2 排序与删除

选中文件，点击“上移”“下移”排序，或点击“删除声音”删除。顺序变化会影响音频 ID，需同步调整控件和脚本中的引用。

2. 声音应用

2.1 开机音乐

1. 在声音管理器中点击“选择开机音乐”，选择 MP3 文件。
2. 在“工程 → 设置”中启用“开机音乐”。
3. 编译并下载到屏幕。

开机音乐保存为 welcome.mp3，不占普通音频 ID。用于按钮播放时，需另行添加为普通音频。

2.2 触摸伴音

在“工程 → 设置”中选择“触摸伴音”：

选项	作用
静音	不启用触摸伴音
蜂鸣器	使用设备蜂鸣器反馈
音频	使用音频方式反馈

2.3 按钮声音

选中按钮，将“播放声音”设为“是”，在“声音文件”中选择 prompt.wav。

本例按钮同时将音量设为 80；使用当前音量时无需此动作。

3. 音频控制

打开“工程 → 地址标签 → 系统参数标签”，搜索 SysSnd。

标签	地址	说明
SysSndVol	LW0140	音量，范围 0～100
SysSndPlay	LW0141	待播放的普通音频 ID
SysSndState	LW0142	写入 1 播放、2 暂停、3 停止；读取 0 空闲、0x80 播放中
SysSndPlayTime	LW0143	已播放时间，单位秒，只读
SysSndTotalTime	LW0144	当前音频总时长，单位秒，只读

3.1 调节音量

添加滑块，按下表设置：

属性	设置
读取地址	$SysSndVol（LW0140）
写入地址	与读取地址相同
滑动调节	启用
范围限制	固定范围
下限值 / 上限值	0 / 100

数值控件读取 LW0140，小数位数设为 0，即可同步显示音量。进度条也可使用该地址，范围设为 0～100。

3.2 选择音频

使用字设置按钮向 LW0141 写入音频 ID：

属性	本例设置
写入地址	$SysSndPlay（LW0141）
操作模式	写入常量
常量值	1，对应 playback-demo.wav

3.3 播放与停止

添加三个字设置按钮，写入地址设为 $SysSndState（LW0142），操作模式设为“写入常量”：

按钮	常量值	作用
播放	1	开始播放所选音频
暂停	2	暂停当前播放
停止	3	停止当前播放

先选择音频 ID，再点击“播放”。切换音频前先停止当前播放。

LW0142 写入值为控制命令，读取 0 表示空闲、0x80 表示播放中。

3.4 播放进度

添加两个数值控件，分别读取 LW0143、LW0144，小数位数设为 0，以秒显示已播放时间和总时长。

进度条设置：

属性	设置
读取地址	LW0143
范围限制	可变范围
最小值地址	LW1020，预留并保持为 0
最大值地址	LW0144

总时长为 0 时，不计算百分比。

4. 运行预览

右侧调节音量和播放提示音，左侧控制 12 秒演示音频。

1. 将音量调到合适数值，点击“选择演示音频（ID 1）”。
2. 点击“播放”，总时长显示 12 秒，已播放时间和进度条同步增加。
3. 点击“暂停”，已播放时间保持不变；再次点击“播放”继续。
4. 点击“停止”，模拟器中的计时和进度归零。

GIF 无音轨，试听请使用本节开头的 WAV 链接。扬声器、蜂鸣器和开机播放效果需在目标屏上确认。