audioEngine 类型

模块: cc

cc.audioengine是单例对象。
主要用来播放音频，播放的时候会返回一个 audioID，之后都可以通过这个 audioID 来操作这个音频对象。
不使用的时候，请使用 cc.audioEngine.uncache(filePath); 进行资源释放
注意：
在 Android 系统浏览器上，不同浏览器，不同版本的效果不尽相同。
比如说：大多数浏览器都需要用户物理交互才可以开始播放音效，有一些不支持 WebAudio，
有一些不支持多音轨播放。总之如果对音乐依赖比较强，请做尽可能多的测试。

索引

方法

• play 播放音频
• setLoop 设置音频是否循环。
• isLoop 获取音频的循环状态。
• setVolume 设置音量（0.0 ~ 1.0）。
• getVolume 获取音量（0.0 ~ 1.0）。
• setCurrentTime 设置当前的音频时间。
• getCurrentTime 获取当前的音频播放时间。
• getDuration 获取音频总时长。
• getState 获取音频状态。
• setFinishCallback 设置一个音频结束后的回调
• pause 暂停正在播放音频。
• pauseAll 暂停现在正在播放的所有音频。
• resume 恢复播放指定的音频。
• resumeAll 恢复播放所有之前暂停的所有音频。
• stop 停止播放指定音频。
• stopAll 停止正在播放的所有音频。
• setMaxAudioInstance 设置一个音频可以设置几个实例
• getMaxAudioInstance 获取一个音频可以设置几个实例
• uncache 卸载预加载的音频。
• uncacheAll 卸载所有音频。
• preload 预加载一个音频
• setMaxWebAudioSize 设置一个以 KB 为单位的尺寸，大于这个尺寸的音频在加载的时候会强制使用 dom 方式加载

Details

方法

play

播放音频

参数列表

• filePath String The path of the audio file without filename extension.
• loop Boolean Whether the music loop or not.
• volume Number Volume size.

示例

var audioID = cc.audioEngine.play(path, false, 0.5);

setLoop

设置音频是否循环。

参数列表

• audioID Number audio id.
• loop Boolean Whether cycle.

示例

cc.audioEngine.setLoop(id, true);

isLoop

获取音频的循环状态。

参数列表

• audioID Number audio id.

示例

cc.audioEngine.isLoop(id);

setVolume

设置音量（0.0 ~ 1.0）。

参数列表

• audioID Number audio id.
• volume Number Volume must be in 0.0~1.0 .

示例

cc.audioEngine.setVolume(id, 0.5);

getVolume

获取音量（0.0 ~ 1.0）。

参数列表

• audioID Number audio id.

示例

var volume = cc.audioEngine.getVolume(id);

setCurrentTime

设置当前的音频时间。

参数列表

• audioID Number audio id.
• sec Number current time.

示例

cc.audioEngine.setCurrentTime(id, 2);

getCurrentTime

获取当前的音频播放时间。

参数列表

• audioID Number audio id.

示例

var time = cc.audioEngine.getCurrentTime(id);

getDuration

获取音频总时长。

参数列表

• audioID Number audio id.

示例

var time = cc.audioEngine.getDuration(id);

getState

获取音频状态。

参数列表

• audioID Number audio id.

示例

var state = cc.audioEngine.getState(id);

setFinishCallback

设置一个音频结束后的回调

参数列表

• audioID Number audio id.
• callback Function loaded callback.

示例

cc.audioEngine.setFinishCallback(id, function () {});

pause

暂停正在播放音频。

参数列表

• audioID Number The return value of function play.

示例

cc.audioEngine.pause(audioID);

pauseAll

暂停现在正在播放的所有音频。

示例

cc.audioEngine.pauseAll();

resume

恢复播放指定的音频。

参数列表

• audioID Number The return value of function play.

示例

cc.audioEngine.resume(audioID);

resumeAll

恢复播放所有之前暂停的所有音频。

示例

cc.audioEngine.resumeAll();

stop

停止播放指定音频。

参数列表

• audioID Number The return value of function play.

示例

cc.audioEngine.stop(audioID);

stopAll

停止正在播放的所有音频。

示例

cc.audioEngine.stopAll();

setMaxAudioInstance

设置一个音频可以设置几个实例

参数列表

• num Number a number of instances to be created from within an audio

示例

cc.audioEngine.setMaxAudioInstance(20);

getMaxAudioInstance

获取一个音频可以设置几个实例

示例

cc.audioEngine.getMaxAudioInstance();

uncache

卸载预加载的音频。

参数列表

• filePath String

示例

cc.audioEngine.uncache(filePath);

uncacheAll

卸载所有音频。

示例

cc.audioEngine.uncacheAll();

preload

预加载一个音频

参数列表

• filePath String The file path of an audio.
• callback Function The callback of an audio.

示例

cc.audioEngine.preload(path);

setMaxWebAudioSize

设置一个以 KB 为单位的尺寸，大于这个尺寸的音频在加载的时候会强制使用 dom 方式加载

参数列表

• kb Number The file path of an audio.

示例

cc.audioEngine.setMaxWebAudioSize(300);