系统函数

音频控制

4 个函数

播放音乐

Audio.play(path: string, loop: integer, 执行方式: integer): integer

播放本地音频，可选择同步等待或异步播放。 线程规则：同步模式只等待当前 Lua 脚本线程，不会阻塞 Android 界面主线程；异步模式启动成功后立即继续执行下一行。 播放规则：每次只能播放一个文件，再次调用会停止上一份。 停止规则：Audio.stop() 或脚本停止都会结束当前音频；同步循环会一直等待，异步循环不会阻塞脚本。

参数3 项
序号名称类型参数说明
1 path 字 音频文件绝对路径。示例：/sdcard/音乐.mp3
2 loop 整 播放方式：0 播放一次，1 循环播放。
3 执行方式 整 0 同步等待当前脚本线程，1 异步播放并立即继续；默认 0。同步不是 Android 界面主线程。
返回值返回值可以不接收
序号名称类型返回说明
1 执行状态 整 同步播放完成或被停止返回0；异步模式成功启动返回0；文件无效、格式不支持或启动失败返回-1。

停止音乐

Audio.stop(): integer

停止当前正在播放或循环播放的音频；同步播放时会让 Audio.play() 所在的脚本线程继续执行。

参数无参数
返回值返回值可以不接收
序号名称类型返回说明
1 执行状态 整 成功停止返回0，当前没有音频时返回-1。

获取音量

Audio.volume(type: string): (integer, integer)

获取指定音量类型的当前值和最大值。设置音量时应使用这里返回的最大值作为上限。

参数1 项
序号名称类型参数说明
1 type 字 音量类型：media 媒体、notification 通知、alarm 闹钟；可直接使用快捷选择。
返回值返回值可以不接收
序号名称类型返回说明
1 当前音量 整 当前音量数值；查询失败返回0。
2 最大音量 整 该类型允许的最大音量；查询失败返回0。

设置音量

Audio.setVolume(type: string, value: integer): integer

设置指定类型的系统音量。数值范围是 0 到 Audio.volume() 返回的最大音量。

参数2 项
序号名称类型参数说明
1 type 字 音量类型：media 媒体、notification 通知、alarm 闹钟；可直接使用快捷选择。
2 value 整 目标音量，范围为 0 到 Audio.volume() 返回的最大音量。
返回值返回值可以不接收
序号名称类型返回说明
1 执行状态 整 设置成功返回0，类型无效、数值越界或设置失败返回-1。