Code Monkey home page Code Monkey logo

xaudio's Introduction

XAudioJS

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

XAudioJS

安装

使用 npm:

npm install xaudiojs-cli --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/halldwang/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]:halldwang/XAudioJS.git

# 拉取远程代码
git pull upstream master

# 提交修改
git add .
git commit

# 更新 fork 仓库
git push origin master

更多参考: Syncing a fork

维护者

@halldwang.

Changelog

https://github.com/halldwang/XAudioJS/commits/master.

License

XAudioJS is released under the MIT License.

xaudio's People

Contributors

arjenhill avatar halldwang avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.