netAudio
play setProgress stop expungeCache
概述
本模块已停止更新,建议使用
netAudio 封装了对网络音频流播放的接口,使用本模块可以实现对服务器端音频流资源的播放、暂停、继续、停止、设置播放位置等相关操作。目前暂不支持缓存到本地。在iOS上如需支持后台播放功能请参考应用配置说明文档里关于BackgroundMode的配置
play
播放网络音频
play({params}, callback(ret, err))
path:
- 类型:字符串
- 描述:网络音频资源地址
callback(ret, err)
ret:
- 类型:JSON 对象
- 内部字段:
示例代码
netAudio.play({
path: 'http://7xisq1.com1.z0.glb.clouddn.com/apicloud/0d0b81b8bd5ab81bda9ca54267eb9b98.mp3'
}, function(ret, err) {
if (ret) {
alert(JSON.stringify(ret));
} else {
alert(JSON.stringify(err));
});
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
setVolume
设置音量
setVolume({params})
params
- 类型:数字
- 默认值:0
示例代码
var netAudio = api.require('netAudio');
netAudio.setVolume({
volume: 0.6
});
iOS系统,Android系统
可提供的1.0.0及更高版本
setProgress
设置播放位置
setProgress({params})
params
progress:
- 类型:数字
- 描述:(可选项)播放位置百分比,取值范围:0-100
- 默认值:0
示例代码
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
pause
暂停播放
pause()
示例代码
var netAudio = api.require('netAudio');
netAudio.pause();
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
stop
stop()
netAudio.stop();
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
addEventListener
监听被其它 app 打断事件,暂仅支持 iOS 平台
addEventListener(callback(ret))
callback(ret)
ret:
- 类型:JSON 对象
- 内部字段:
示例代码
var audio = api.require('netAudio');
audio.addEventListener(function(ret) {
if (ret) {
alert(JSON.stringify(ret));
}
});
可用性
iOS 系统
可提供的1.0.0及更高版本
expungeCache
播放网络音频时,清除本地缓存
注意:本接口仅支持 iOS 平台,android平台上会自动清除
expungeCache()
示例代码
可提供的1.0.4及更高版本