Xaudiox

Xaudiox 是一款功能强大方便易用的 H5 背景音乐播放器

安装

使用 npm：

npm install xaudiox --save

html：

<script src="XAudioJS.min.js"></script>

入门

const audio = new XAudioJS();

const config = {
  src: 'music.mp3',
  loop: false,
  autoplay: true,
  preload: 'auto',
  ready: () => {
    console.log('加载完毕');
  }
};

audio.init(config);

参数

| 名称 | 默认值 | 描述 | | :--: | :----: | :--: | | src | 空 | 视频播放地址| | autoplay | false | 设置true，则音频在就绪后马上播放。| | preload | 'auto' | 音频自动播放。autoplay 属性优先于 preload 假如用户想自动播放音频，那么很明显浏览器需要下载音频。另外同时设置autoplay 和 preload属性在规范里是允许的。| | loop | false | 设置true，音频循环播放。|

API

• audio.play(): 播放音频
• audio.pause(): 暂停音频
• audio.stop(): 停止音频
• audio.volume() or audio.setVolume(0.1): 设置音量 1.0 是最高音量（默认）0.5 是一半音量 / 0.0 是静音
• audio.currentTime() or audio.setCurrentTime(1): 设置或返回音频播放的当前位置（以秒计）
• audio.duration() or audio.getDuration(): 回当前音频长度，以秒计。
• audio.audio() or audio.getAudio(): 访问 Audio 对象，同getElementById() 来访问 audio 元素。
• audio.getSrc(): 返回src地址。
• audio.stats() or audio.getStats(): 返回音频播放状态(Boolean)。
• audio.destroy(): 销毁当前播放实例。
• audio.playNew(src): 播放新音频(src:String)。

开发

依赖 nodejs, 请使用 terminal/iTerm 安装环境

构建项目

git clone https://github.com/xucz/xaudiojs.git

...
npm install
npm run start
npm run build

运行项目

npm run start
// 访问 http://localhost:8080

贡献

如果你想参与这个项目的共同创作，修改或添加内容，可以先 Fork 项目仓库，然后将修改的内容提交 Pull requests ；或者创建 Issues。

Fork 后的仓库如何同步本仓库？

# 添加 upstream 源，只需执行一次
git remote add upstream [email protected]:xucz/xaudiojs.git

# 拉取远程代码
git pull upstream master

# 提交修改
git add .
git commit

# 更新 fork 仓库
git push origin master

License

XAudiox is released under the MIT License.