audioEngine 类型

模块: cc

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

索引

方法

Details

方法

play

播放音频

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:92
参数列表
  • 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

设置音频是否循环。

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:125
参数列表
示例
cc.audioEngine.setLoop(id, true);
isLoop

获取音频的循环状态。

meta description
返回 Boolean
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:141
参数列表
示例
cc.audioEngine.isLoop(id);
setVolume

设置音量(0.0 ~ 1.0)。

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:157
参数列表
  • 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)。

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:179
参数列表
示例
var volume = cc.audioEngine.getVolume(id);
setCurrentTime

设置当前的音频时间。

meta description
返回 Boolean
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:195
参数列表
示例
cc.audioEngine.setCurrentTime(id, 2);
getCurrentTime

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

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:220
参数列表
示例
var time = cc.audioEngine.getCurrentTime(id);
getDuration

获取音频总时长。

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:236
参数列表
示例
var time = cc.audioEngine.getDuration(id);
getState

获取音频状态。

meta description
返回 audioEngine.AudioState
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:252
参数列表
示例
var state = cc.audioEngine.getState(id);
setFinishCallback

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

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:268
参数列表
示例
cc.audioEngine.setFinishCallback(id, function () {});
pause

暂停正在播放音频。

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:287
参数列表
  • audioID Number The return value of function play.
示例
cc.audioEngine.pause(audioID);
pauseAll

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

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:304
示例
cc.audioEngine.pauseAll();
resume

恢复播放指定的音频。

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:322
参数列表
  • audioID Number The return value of function play.
示例
cc.audioEngine.resume(audioID);
resumeAll

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

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:341
示例
cc.audioEngine.resumeAll();
stop

停止播放指定音频。

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:357
参数列表
  • audioID Number The return value of function play.
示例
cc.audioEngine.stop(audioID);
stopAll

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

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:374
示例
cc.audioEngine.stopAll();
setMaxAudioInstance

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

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:391
参数列表
  • num Number a number of instances to be created from within an audio
示例
cc.audioEngine.setMaxAudioInstance(20);
getMaxAudioInstance

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

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:403
示例
cc.audioEngine.getMaxAudioInstance();
uncache

卸载预加载的音频。

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:415
参数列表
示例
cc.audioEngine.uncache(filePath);
uncacheAll

卸载所有音频。

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:437
示例
cc.audioEngine.uncacheAll();
preload

预加载一个音频

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:464
参数列表
  • filePath String The file path of an audio.
  • callback Function The callback of an audio.
示例
cc.audioEngine.preload(path);
setMaxWebAudioSize

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

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/audio/CCAudioEngine.js:481
参数列表
  • kb Number The file path of an audio.
示例
cc.audioEngine.setMaxWebAudioSize(300);

条与 "" 相匹配的结果

    没有与 "" 匹配的结果