IonDen / Ion.sound

JavaScript plugin for playing sounds on user actions and page events.

• Version: 3.0.7
• Project page and demos
• Download ZIP
• Support the plugin on GitHub sponsors

Description

• Ion.Sound — JavaScript-plugin for playing sounds based on Web Audio API.
• Plugin is working on most popular desktop and mobile browsers and can be used everywhere, from common web sites to browser games.
• For not so modern browsers plugin falls back to HTML5 audio.
• Audio-sprites support included.
• Ion.Sound freely distributed under terms of MIT licence.
• 25 free sounds included

Today websites are full of events (new mail, new chat-message, content update etc.). Often it is not enough to indicate this events only visually to get user attention. You need sounds! This library, made for playing small sounds, will help you with this task. Also, new version of Ion.Sound is capable to handle browser games audio. It has full control of loading, playing and removing audio files. And audio-sprites support of course.

Supported browsers

Desktop Windows, OS X, Linux:

• Google Chrome
• Mozilla Firefox
• Microsoft Internet Explorer 9.0+
• Opera 12.16+
• Safari 5.1+ (Safari on Windows requires QuickTime to play sounds)

Mobile:

• iOS Safari and others (with some restrictions)
• Android Google Chrome and others (with some restrictions also)
• WP8 Internet Explorer

Can i use Web Audio API and HTML5 Audio?

Demos

• Basic demo
• Advanced demo

Dependencies

• None

Usage

Import this library:

• ion.sound.min.js

Prepare sound-files (25 sounds are included) and put them in some folder (eg. "sounds"):

• my_cool_sound.mp3
• my_cool_sound.ogg
• my_cool_sound.aac

It is not enough to have only MP3-file, you should make OGG and AAC-file too, because not all browsers support MP3.
You can easily convert you MP3-s to OGG-s and AAC-s at Media.io or at CloudConvert.org.
AAC support was added to improve cross browser support of iOS 8.x devices (iPhone, iPad)

Install with npm

Use NPM to download latest version of a plugin and install it directly in to your project.

• npm install ion-sound

Install with Yarn

Use Yarn to download latest version of a plugin and install it directly in to your project.

• yarn add ion-sound

Initialisation

To initialise plugin call this method:

ion.sound({
    sounds: [
        {
            name: "my_cool_sound"
        },
        {
            name: "notify_sound",
            volume: 0.2
        },
        {
            name: "alert_sound",
            volume: 0.3,
            preload: false
        }
    ],
    volume: 0.5,
    path: "sounds/",
    preload: true
});

And play sound!

// Simple
ion.sound.play("my_cool_sound");

General settings

Sound object

And also individual: path, preload, multiplay, loop, volume, scope and callbacks

Plugin can be launched in jQuery namespace

• Use aliases to call any plugin methods: ion.sound(); -> $.ionSound();
• ion.sound.play("sound_name"); -> $.ionSound.play("sound_name");
• Etc.

Update history

Support Ion-series plugins development:

• Support the plugin on GitHub sponsors

• Donate direct to my Paypal account: https://www.paypal.me/IonDen