Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/DIDAVA/eAudio
Extended HTML Audio Object
https://github.com/DIDAVA/eAudio
analyser analyzer audio audio-analysis audio-api audio-applications audio-effect audio-library audio-object audio-player audio-processing audio-visualizer equalizer fade-in fade-out fadein fadeout html5 javascript visualization
Last synced: 25 days ago
JSON representation
Extended HTML Audio Object
- Host: GitHub
- URL: https://github.com/DIDAVA/eAudio
- Owner: DIDAVA
- License: mit
- Created: 2019-12-08T20:05:55.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2020-04-27T06:51:32.000Z (over 4 years ago)
- Last Synced: 2024-08-03T16:09:54.295Z (4 months ago)
- Topics: analyser, analyzer, audio, audio-analysis, audio-api, audio-applications, audio-effect, audio-library, audio-object, audio-player, audio-processing, audio-visualizer, equalizer, fade-in, fade-out, fadein, fadeout, html5, javascript, visualization
- Language: JavaScript
- Homepage:
- Size: 33.2 KB
- Stars: 4
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-javascript-audio - eAudio - the "Extended HTML Audio Object" - adds an equalizier (Sound editing / Sound equalizers)
README
# eAudio
**Extended HTML Audio Object**
This project is supposed to keep standard html audio object and add missing features to it with the help of `Web Audio API`.
`AudioContext` is not supported in some old browsers such as `Microsoft Internet Explorer`. Please try this object with the latest modern browsers like `Chrome`, `Firefox` and `Safari`.
## Features
* 10 Band Equalizer
* FadeIn / FadeOut
* Audio Analyser
* PlayToggle
* Formatted Time
* Preset
## Basic Setup
`eAudio` setup and functionality is the same as standard html audio object:
```html
const audio = new eAudio('your_audio_file.mp3');
audio.controls = true;
document.querySelector('container').appendChild(audio);
```
For more details review the [basic example](https://github.com/DIDAVA/eAudio/blob/master/examples/basic.html).
## EQ
`eAudio` comes with 10 band equalizer. The frequency bands are adjusted on standard harmonic octaves (`31Hz`, `63Hz`, `125Hz`, `250Hz`, `500Hz`, `1kHz`, `2kHz`, `4kHz`, `8kHz`, `16kHz`). The gain for each band is limited between `+6db` and `-24db` to prevent output distortion and band converage. The default gain value for each band is `0`.
```javascript
audio.q31 = 0;
audio.q63 = 0;
audio.q125 = 0;
audio.q250 = 0;
audio.q500 = 0;
audio.q1000 = 0;
audio.q2000 = 0;
audio.q4000 = 0;
audio.q8000 = 0;
audio.q16000 = 0;
```
For more details review the [equalizer example](https://github.com/DIDAVA/eAudio/blob/master/examples/equalizer.html).
## FadeIn / FadeOut
Both fadein and fadeout are separated methods on the `eAudio` object. The fading time can be passed as an argument to the fader methods. If no argument is passed they will use their default value which is `3 seconds`. Please be informed that faders do not have callbacks and will not affect play and pause methods on audio object.
```javascript
audio.fadein(); // 3 seconds by default
audio.fadein(10); // 10 seconds
audio.fadeout(); // 3 seconds by default
audio.fadeout(10); // 10 seconds
```
## Analyser
`eAudio` supports two kind of analysers (`Frequency Analyse` and `Domain Analyse`). The output of the analyser is an array of numeric values between `0` and `256`. Analyser is customizable by two properties. `specLines` sets the number of output lines and `specSmooth` adjusts the smoothnes of the output lines. The analyser's output array is catchable during the time from two properties `specFreq` and `specDomain`.
#### specLines
Adjusts the resolution of analyser or in other words sets the output array length. You can set or get the length of the output array. Acceptable values are `16`,`32`,`64`,`128`,`256`,`512` and `1024`. The defaul value is `256`.
```javascript
const currentLines = audio.specLines; // Gets the current lines count
audio.specLines = 256; // Sets the output length to 256
```
#### specSmooth
Sets or gets the smoothness of the analyser output. The value must between `0` and `1`. The default value is `0.75`.
```javascript
const smoothness = audio.specSmooth; // Gets the current smoothness
audio.specSmooth = 0.75; // Sets the smoothness to 0.75
```
#### specFreq
Returns the frequency analysis array for the current moment. Each item in the array is an integer between `0` and `256`.
```javascript
const currentAnalysis = audio.specFreq; // Gets an array of integers for current moment
```
For more information and usage see the [spectrum example](https://github.com/DIDAVA/eAudio/blob/master/examples/freqspectrum.html).
#### specDomain
Returns the domain analysis array for the current moment. Each item in the array is an integer between `0` and `256`.
```javascript
const currentAnalysis = audio.specDomain; // Gets an array of integers for current moment
```
For more information and usage see the [domain example](https://github.com/DIDAVA/eAudio/blob/master/examples/freqdomain.html).
## PlayToggle
You can play/pause audio more easily by playToggle property:
```javascript
audio.playToggle = true; // Plays the audio
audio.playToggle = false; // Pauses the audio
// Toggle playback by clicking a button
document.querySelector('button').addEventListener('click', e => {
audio.playToggle = !audio.playToggle; // Toggles play/pause
});
```
## Formatted Time
This property stringifies the current audio time to `hh:mm:ss` format.
```html
00:00:00
const timer = document.querySelector('#timer');
setInterval( () => {
timer.innerText = audio.formattedTime;
}, 1000);
```
## Preset
This property can set or get the current `source`, `equalizer` and `volume` settings as an json string. It is useful to save your current settings to database or file and simply set all the settings very fast.
```javascript
const currentSettings = audio.preset; // Get the json settings string
audio.preset = currentSettings; // Set the settings back
```