AppCan插件使用文档之uexAudio.docx

AppCan插件使用文档之uexAudiouexAudio对象是手机本地的音频对象，可用来播放音乐和音效，并且能够进行录音等操作。使用示例：以下示例代码说明了如何使用uexAudio对象的方法。AppCan API uexAudiowindow.uexOnload = function(type)if(!type)uexAudio.onPlayFinished=function(inCurrentTimes)console.log(当前歌曲播放第+inCurrentTimes+1+次);function $(id)return document.getElementById(id);/打开音乐播放function audioOpen()var url = $(audio_url).value;uexAudio.open(url);/播放，并设置播放次数function audioPlay()uexAudio.play(2);/连续播放2次/暂停播放function audioPause()uexAudio.pause();/停止播放，启动uexAudio.play会重新播放function audioStop()uexAudio.stop()/调高音量function audioVolumeUp()uexAudio.volumeUp();/调低音量function audioVolumeDown()uexAudio.volumeDown();/打开系统播放界面function audioOpenPlayer()/设置播放音乐数组var arr_ = res:/1.mp3,res:/2.mp3,res:/3.mp3;/传入数组，并设置从数组第一个开始播放uexAudio.openPlayer(arr_,0);/*音效处理方法*/var sondPoolId = 0;/全局变量，用于保存打开音效池的返回id，初始化为0/打开音效池function audioOpenSoundPool()uexAudio.cbOpenSoundPool=function(opId,dataType,data)if(dataType=2)sondPoolId = data;/播放音效池中的音效function audioPlayFromSoundPool()if(sondPoolId!=0)uexAudio.playFromSoundPool(sondPoolId);/停止播放音效function audioStopFromSoundPool()if(sondPoolId!=0)uexAudio.stopFromSoundPool(sondPoolId);sondPoolId = 0;/向音效池添加音效var soundId = 100;function audioAddSound()soundId+;var tmp = res:/1.amr;uexAudio.addSound(soundId,tmp);/关闭音效池function audioCloseSoundPool()uexAudio.closeSoundPool();/*录音处理方法*/打开系统录音界面function audioRecord()uexAudio.cbRecord=function(opId,dataType,data)if(dataType=0)console.log(录音文件路径为：+data);uexAudio.record(0);/设置录音格式为amr/开始后台录音function audioStartBackgroundRecord()uexAudio.startBackgroundRecord(0);/设置录音格式为amr/停止后台录音function audioStopBackgroundRecord()uexAudio.cbBackgroundRecord=function(opId,dataType,data)if(dataType=0)console.log(录音文件路径为：+data);uexAudio.stopBackgroundRecord();音乐播放打开系统音乐播放界面音效播放录音Methods：1、 open(url)打开音乐文件。Parameters：url：音乐文件路径，可通过uexFileMgr.explorer进行选择。2、 play(loopTimes)播放音乐。Parameters：loopTimes：指定的循环次数。-1代表无限循环播放，0代表只播放一次，loopTimes=0代表的循环播放的次数，每次播放完成后都会调用uexAudio.onPlayFinished，该回调函数返回当前播放完成的次数。3、 pause()暂停播放音乐，调用uexAudio.play方法会继续播放音乐。4、 stop()停止播放音乐，调用uexAudio.play方法会重新播放音乐。5、 volumeUp()调高音量。6、 volumeDown()调低音量。7、 openPlayer(inUrlStrs,activeIndex)打开音乐播放界面，传入需要播放的音乐列表。Parameters：inUrlStrs：音乐文件路径数组。activeIndex：默认开始播放的音乐文件在inUrlStrs中的索引【可不填，默认为0】。数组索引值从0开始，若等于或大于数组长度，则表示越界，此时索引为0。8、 openSoundPool()打开声音池。9、 cbOpenSoundPool(opId,dataType,data)打开声音池的回调方法。Parameters：opId：操作ID，在此函数中不起作用，可忽略。dataType：成功时返回数据的数据类型为uex.cInt(值为2)。data：返回的int型的数据（一个音效只能返回一个ID值，ID值是系统返回的，供播放使用）。10、 playFromSoundPool(inSoundID)播放音效。Parameters：inSoundID：打开音效文件回调返回的id。11、 stopFromSoundPool(inSoundID)停止播放音效。Parameters：inSoundID：打开音效文件回调返回的id。12、 addSound(soundId,inPath)向声音池中添加音效文件。IOS支持wav，amr，aif，caf格式，声音文件的长度不超过30秒。Android支持wav，midi，amr，最好不超过100K。Parameters：soundId：传入的声音文件唯一标识。inPath：文件路径集合,支持的文件路径协议:wgt:/,wgts:/,/ ,file:/,http:/.。13、 closeSoundPool()清空声音池。14、 onPlayFinished(inCurrentTimes)通知音乐播放完成,并返回当前播放次数。Parameters：inCurrentTimes：当前播放次数，当用户选择循环播放的时候，该参数表示当前是第几次播放。该值从0开始。15、 record(soundType)调用系统录音界面，需要注意的是，录音文件保存在沙盒中，为了减少文件过多造成占用内存过多，在应用中只会临时存一份录音文件，再次录音会覆盖之前的录音文件。Parameters：soundType：指定录音类型，”0”表示AMR格式，”1”表示ios平台的caf格式。(android平台忽略此函数，只支持AMR格式)。16、 cbRecord(opId,dataType,data)调用系统录音界面的回调方法。Parameters：opId：操作ID，在此函数中不起作用，可忽略。dataType：返回数据的数据类型为uex.cText(值为0)。data：返回的录音文件的绝对路径。17、 startBackgroundRecord(soundType)开始后台录音。Parameters：soundType：指定录音类型，”0”表示AMR格式，”1”表示ios平台的caf格式。(android平台忽略此函数，只支持AMR