wAudio.js
wAudio.js是HTML5音频对象的替换,该对象使用了幕后的Web音频。
它复制了HTML5音频API,但透明地使用Web音频API实现功能,从而允许使用更简单的音频API使用Web音频。这使得易于迁移使用音频到Web音频的HTML5项目,以便在移动设备上使用。
特征
- 使用音频对象API进行Web音频
- 通过检查Waudio对象的存在来检测Web音频支持
- 自动缓存要求提高性能
- 使用
playMutedSound()方法或mobileAutoEnable属性轻松在Safari上播放音频播放 - 没有外部依赖性,只有纯JavaScript
- 极小-4KB缩小!!
浏览器兼容性
在以下浏览器/版本中测试:
- Google Chrome 7.0+
- Internet Explorer 9.0+
- Firefox 4.0+
- Safari 5.1.4+
- 移动Safari 6.0+(在用户输入后,使用
playMutedSound()或mobileAutoEnable) - 歌剧12.0+
- Microsoft Edge
文档
内容
- 快速开始
- 例子
- 支持的API
- 选项
- 方法
- 事件处理
- 全局选项
- 全局方法
- 移动播放
- 执照
快速开始
- 克隆回购:
git clone https://gith*u*b.*com/adityaravishankar/wAudio\\.js.git
在浏览器中:
wAudio.js\”></script>
<script>
var sound = new wAudio(\”sound.mp3\”);
var sound2 = new wAudio();
sound2.src = \”sound2.mp3\”;
</script>\”>
< script src =\" /path/to/ wAudio.js \" > </ script > < script > var sound = new wAudio ( \"sound.mp3\" ) ; var sound2 = new wAudio ( ) ; sound2 . src = \"sound2.mp3\" ; </ script >
例子
最基本的,播放mp3:
var sound = new wAudio ( \"sound.mp3\" ) ; sound . play ( ) ;
更多播放选项:
var sound = new wAudio ( ) ; sound . src = \"sound.mp3\" ; sound . volume = 0.6 ; sound . autoplay = true ;
听事件:
var sound = new wAudio ( \"sound.ogg\" ) ; sound . addEventListener ( \"canplaythrough\" , function ( ) { console . log ( \"Sound loaded. Playing ...\" ) ; sound . play ( ) ; } ) ;
支持的API
选项
SRC String
指定要播放的音频文件的URL。
CurrentRC String readonly
返回所选媒体资源的绝对URL。
当前时间Number
在几秒钟内指示当前的播放时间。设置此值可以将媒体带入新的时间。
卷Number 1.0
播放音量在0.0 (静音)至1.0 (最响亮)的范围内。
自动播放Boolean false
加载声音时,设置为true以自动启动播放。
柔和的Boolean false
设置为true以加载音频静音。
暂停的Boolean false readonly
指示媒体元素是否暂停。
方法
玩()
开始播放音频。
暂停()
暂停音频的播放。
停止()
停止音频的播放,将currentTime重置为0 。
事件处理
事件处理代码模拟DOM事件,但不使用实际的DOM事件对象。目前仅支持三个事件: canplay , canplaythrough并ended 。
- canplay , canplaythrough :一旦加载了音频数据并可以开始播放音频数据。
-
结束:一旦音频播放到最后。将
loop设置为true时不会发射。
AddEventListener(类型,侦听器)
注册事件类型的指定侦听器
-
类型:要收听的事件的
String名称(canplay,canplaythrough,ended)。 -
侦听器:触发事件时要调用
Function函数。
Remove EventListener(类型,侦听器)
删除以前用addEventListener进行恢复的事件侦听器。
-
类型:正在聆听的事件的
String名称(canplay,canplaythrough,ended)。 -
侦听器:触发事件时调用的
Function函数。
dispatchevent(类型)
派遣事件,以适当的顺序调用受影响的聆听。
-
类型:要开火的事件的
String名称(canplay,canplaythrough,ended)。
全局选项
MobileAutoenable Boolean false
自动尝试在移动设备上启用音频。
全局方法
PlaymutedSound()
播放一小段音频,没有音量。对于激活移动设备上的音频播放很有用。
移动播放
默认情况下,iOS上的音频被锁定,直到在用户交互中播放声音为止,然后正常播放页面会话的其余部分(Apple Documentation)。
您可以在触摸事件中调用playMutedSound()方法以解锁音频播放。
// Activate sound inside a touch event wAudio . playMutedSound ( ) ;
另外,您可以将mobileAutoEnable Flag设置为true ,因此Waudio试图通过在第一个touchend事件中播放柔和的声音自动解锁移动音频。
// Automatically activate sound on the first touch/tap event wAudio . mobileAutoEnable = true ;
执照
版权(C)2017 Aditya Ravi Shankar
根据MIT许可发布。
