📦 pixijs / sound

WebAudio API playback library, with filters. Modern audio playback for modern browsers.

461 stars 68 forks 👁 461 watching ⚖️ MIT License
javascript-librarypixipixijswebaudiowebaudio-apiwebaudio-api-playback
📥 Clone https://github.com/pixijs/sound.git
HTTPS git clone https://github.com/pixijs/sound.git
SSH git clone git@github.com:pixijs/sound.git
CLI gh repo clone pixijs/sound
Matt Karl Matt Karl 6.0.1 af88b50 1 years ago 📝 History
📁 .github
📁 .vscode
📁 examples
📁 src
📁 test
📄 .gitignore
📄 .npmrc
📄 LICENSE
📄 README.md
📄 README.md

PixiJS Sound

WebAudio API playback library, with filters. Modern audio playback for modern browsers.

![Node.js CI](https://github.com/pixijs/sound/actions?query=workflow%3A%22Node.js+CI%22) ![npm version](https://badge.fury.io/js/%40pixi%2Fsound)

Features

  • Pausing and resuming
  • Independent volume control
  • Support blocking or layered sounds (multiple instances)
  • Support for PIXI.Assets system
  • Dynamic filters:
* ReverbFilter * DistortionFilter * EqualizerFilter * StereoFilter * TelephoneFilter

Known Compatibility

  • Chrome 58+
  • Firefox 52+
  • Safari 11+
  • iOS 11+

Usage

Installation is available by NPM:

npm i @pixi/sound --save

To import into your project, for instance, when using Webpack, Parcel, Rollup, or another bundler:

import { sound } from '@pixi/sound';

sound.add('my-sound', 'path/to/file.mp3'); sound.play('my-sound');

Browser Usage

If you're using a <script> element to import @pixi/sound into your project, then the SoundLibrary object is PIXI.sound global.

<!-- PixiJS must be imported before @pixi/sound -->
<script src="https://unpkg.com/pixi.js/dist/browser/pixi.min.js"></script>

<!-- found here, if not using CDN "./node_modules/@pixi/sound/dist/pixi-sound.js" --> <script src="https://unpkg.com/@pixi/sound/dist/pixi-sound.js"></script>

<script> PIXI.sound.add('my-sound', 'path/to/file.mp3'); PIXI.sound.play('my-sound'); </script>

Versions Compatibility

| PixiJS | PixiJS Sound | |---|---| | v5.x - v6.x | v4.x | | v7.x | v5.x | | v8.x | v6.x |

Resources

License

MIT License.