audioEngine Class

Module: cc

cc.audioEngine is the singleton object, it provide simple audio APIs.

Index

Methods

• play Play audio.
• setLoop Set audio loop.
• isLoop Get audio cycle state.
• setVolume Set the volume of audio.
• getVolume The volume of the music max value is 1.0,the min value is 0.0 .
• setCurrentTime Set current time
• getCurrentTime Get current time
• getDuration Get audio duration
• getState Get audio state
• setFinishCallback Set Audio finish callback
• pause Pause playing audio.
• pauseAll Pause all playing audio
• resume Resume playing audio.
• resumeAll Resume all playing audio.
• stop Stop playing audio.
• stopAll Stop all playing audio.
• setMaxAudioInstance Set up an audio can generate a few examples.
• getMaxAudioInstance Getting audio can produce several examples.
• uncache Unload the preloaded audio from internal buffer.
• uncacheAll Unload all audio from internal buffer.
• preload Preload audio file.
• setMaxWebAudioSize Set a size, the unit is KB. Over this size is directly resolved into DOM nodes.

Details

Methods

play

Play audio.

Parameters

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

Examples

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

setLoop

Set audio loop.

Parameters

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

Examples

cc.audioEngine.setLoop(id, true);

isLoop

Get audio cycle state.

Parameters

• audioID Number audio id.

Examples

cc.audioEngine.isLoop(id);

setVolume

Set the volume of audio.

Parameters

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

Examples

cc.audioEngine.setVolume(id, 0.5);

getVolume

The volume of the music max value is 1.0,the min value is 0.0 .

Parameters

• audioID Number audio id.

Examples

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

setCurrentTime

Set current time

Parameters

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

Examples

cc.audioEngine.setCurrentTime(id, 2);

getCurrentTime

Get current time

Parameters

• audioID Number audio id.

Examples

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

getDuration

Get audio duration

Parameters

• audioID Number audio id.

Examples

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

getState

Get audio state

Parameters

• audioID Number audio id.

Examples

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

setFinishCallback

Set Audio finish callback

Parameters

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

Examples

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

pause

Pause playing audio.

Parameters

• audioID Number The return value of function play.

Examples

cc.audioEngine.pause(audioID);

pauseAll

Pause all playing audio

Examples

cc.audioEngine.pauseAll();

resume

Resume playing audio.

Parameters

• audioID Number The return value of function play.

Examples

cc.audioEngine.resume(audioID);

resumeAll

Resume all playing audio.

Examples

cc.audioEngine.resumeAll();

stop

Stop playing audio.

Parameters

• audioID Number The return value of function play.

Examples

cc.audioEngine.stop(audioID);

stopAll

Stop all playing audio.

Examples

cc.audioEngine.stopAll();

setMaxAudioInstance

Set up an audio can generate a few examples.

Parameters

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

Examples

cc.audioEngine.setMaxAudioInstance(20);

getMaxAudioInstance

Getting audio can produce several examples.

Examples

cc.audioEngine.getMaxAudioInstance();

uncache

Unload the preloaded audio from internal buffer.

Parameters

• filePath String

Examples

cc.audioEngine.uncache(filePath);

uncacheAll

Unload all audio from internal buffer.

Examples

cc.audioEngine.uncacheAll();

preload

Preload audio file.

Parameters

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

Examples

cc.audioEngine.preload(path);

setMaxWebAudioSize

Set a size, the unit is KB. Over this size is directly resolved into DOM nodes.

Parameters

• kb Number The file path of an audio.

Examples

cc.audioEngine.setMaxWebAudioSize(300);