AppCan插件API功能扩展之uexAudioWord文档下载推荐.docx
《AppCan插件API功能扩展之uexAudioWord文档下载推荐.docx》由会员分享,可在线阅读,更多相关《AppCan插件API功能扩展之uexAudioWord文档下载推荐.docx(17页珍藏版)》请在冰豆网上搜索。
∙setPlayMode设置播放模式
∙2.2、回调方法
∙cbRecord打开录音界面的回调方法
∙cbBackgroundRecord停止后台录音的回调方法
∙cbOpenSoundPool打开音效池的回调方法
∙onPlayFinished播放完成后的监听方法
3、更新历史
∙iOS
∙Android
1、简介
音频播放插件
1.1、说明
播放背景音乐和效果音乐,本插件只支持播放本地音乐。
1.2、UI展示
1.3、开源源码:
插件测试用例与源码下载:
点击
插件中心至插件详情页(插件测试用例与插件源码已经提供)
2、API概览
2.1、方法
open打开音频文件
uexAudio.open(path)
说明:
后台播放,iOS支持MP3、WAV、CAF、AMR格式,Android支持MP3、WAV、AMR、MIDI格式。
参数:
参数名称
参数类型
是否必选
说明
path
String
是
音频文件路径,路径协议详见CONSTANT中PathTypes音频文件路径,路径协议详见CONSTANT中PathTypes
平台支持:
Android2.2+
iOS6.0+
版本支持:
3.0.0+
示例:
1.uexAudio.open(url);
play播放
uexAudio.play(repeats)
播放音频
repeats
Number
重复次数,-1:
无限循环,0:
不循环
1.uexAudio.play(0);
pause暂停
uexAudio.pause()
暂停
无
1.uexAudio.pause();
replay重播
uexAudio.replay()
重播
1.uexAudio.replay();
stop停止
uexAudio.stop()
停止
1.uexAudio.stop()
volumeUp音量+
uexAudio.volumeUp()
音量+
1.uexAudio.volumeUp()
volumeDown音量-
uexAudio.volumeDown()
音量-
1.uexAudio.volumeDown()
openPlayer打开音乐播放器
uexAudio.openPlayer(paths,index)
打开音乐播放器
paths
要播放的所有音频路径,路径协议详见CONSTANT中PathTypes,以逗号分隔
index
索引
1.varpaths=newArray("
res:
//1.mp3"
"
//2.mp3"
);
2.uexAudio.openPlayer(paths,"
0"
closePlayer关闭播放器
uexAudio.closePlayer()
关闭播放器
1.uexAudio.closePlayer();
startBackgroundRecord开始后台录音
uexAudio.startBackgroundRecord(mode,fileName)
开始后台录音
mode
要录音格式,0:
AMR格式,1:
CAF格式,2:
MP3格式。
Android只支持AMR格式,MP3格式。
fileName
文件名称,默认以当前时间作为文件名
1.uexAudio.startBackgroundRecord(1,document.getElementById('
RecordName'
).value);
stopBackgroundRecord停止后台录音
uexAudio.stopBackgroundRecord()
停止后台录音回调方法cbBackgroundRecord
1.uexAudio.stopBackgroundRecord();
record打开录音界面
uexAudio.record(mode,fileName)
打开录音界面回调方法cbRecord
录音格式,0:
1.uexAudio.record(1,"
20153343443"
)
openSoundPool打开音效池
uexAudio.openSoundPool()
打开音效池回调方法cbOpenSoundPool
1.uexAudio.openSoundPool();
addSound向音效池添加音效
uexAudio.addSound(soundID,path)
iOS支持WAV、AMR、AIF、CAF格式。
Android支持WAV、MIDI、AMR格式。
soundID
唯一标识符
音效文件路径,路径协议详见CONSTANT中PathTypes
1.uexAudio.addSound("
2"
playFromSoundPool播放音效
uexAudio.playFromSoundPool(id)
播放音效
id
1.uexAudio.playFromSoundPool("
stopFromSoundPool停止音效
uexAudio.stopFromSoundPool(id)
停止音效
1.uexAudio.stopFromSoundPool("
closeSoundPool关闭音效池
uexAudio.closeSoundPool()
关闭音效池
1.uexAudio.closeSoundPool();
setPlayMode设置播放模式
uexAudio.setPlayMode(jsonStr)
设置声音播放模式
jsonStr
1.varparams={
2.playMode:
'
0'
3.}
各字段含义如下:
playMode
播放模式:
0为正常扩音器模式;
1为听筒模式;
Android3.0.6+
1.varparam={
1'
3.};
4.param=JSON.stringify(param);
5.uexAudio.setPlayMode(param);
2.2、回调方法
cbRecord打开录音界面的回调方法
uexAudio.cbRecord(opId,dataType,data)
opId
操作ID,在此函数中不起作用,可忽略
dataType
数据类型,详见CONSTENT中Callback方法数据类型
data
文件路径
1.functioncbRecord(opId,dataType,data){
2.alert(data);
4.window.uexOnload=function(){
5.uexAudio.cbRecord=cbRecord;
6.}
cbBackgroundRecord停止后台录音的回调方法
uexAudio.cbBackgroundRecord(opId,dataType,data)
1.functioncbBackgroundRecord(opId,dataType,data){
5.uexAudio.cbBackgroundRecord=cbBackgroundRecord;
cbOpenSoundPool打开音效池的回调方法
uexAudio.cbOpenSoundPool(opId,dataType,data)
1.functioncbOpenSoundPool(opId,dataType,data){
5.uexAudio.cbOpenSoundPool=cbOpenSoundPool;
onPlayFinished播放完成后的监听方法
uexAudio.onPlayFinished(loopTime)
loopTime
已播放次数
1.functiononPlayFinished(loopTime){
2.alert(loopTime);
5.uexAudio.onPlayFinished=onPlayFinished;
3、更新历史
iOS
API版本:
uexAudio-3.0.12
最近更新时间:
2015-12-26
历史发布版本
更新内容
3.0.12
改用bundle调用图片资源;
添加IDE支持
3.0.11
支持后台播放音频,需配置相关权限
3.0.10
提高了进行MP3录音的音质,修复了本地录音生成的MP3文件用http网络播放不能正常使用的bug
3.0.9
更新lame库
3.0.8
修复在iOS8.2/8.3下可能会引起程序崩溃的bug
3.0.7
使用音频界面录制音频支持mp3格式
3.0.6
修复第二次录制MP3时录制CAF的BUG
3.0.5
修复播放网络音频没有回调的问题
3.0.4
修复播放网络音频无法循环播放的问题
3.0.3
uexAudio更新libopencore-amrnb.a,libopencore-amrwb.a,libmp3lame.a,支持arm64
3.0.2
uexAudio插件录音文件名称与文档统一
3.0.1
后台录音添加录音格式MP3
3.0.0
音乐播放插件
Android
uexAudio-3.0.6
2015-12-07
添加听筒模式接口,修复小米手机音量设置无效的问题
修复uexAudio.record方法不支持录音文件存储为.mp3格式的问题
修复多次点击播放音效不能关闭的问题
修复录音文件名不正确
修复录制失败问题
背景录音添加录音格式MP3