sc-audio

sc-audio is a Web Audio library for prototyping and creating interactive audio applications both in the browser and Node.js (see isomorphic-web-audio-api).

The main philosophy behind sc-audio is to provide audio nodes that behave, as much as, possible, similarly to native audio nodes, so that they can be inserted seamlessly into regular Web Audio graphs.

Work in progress

Documentation

http://ircam-ismm.github.io/sc-audio

You can also run the examples in docs/examples using Node.js, by simply cloning the repository and run:

npm install
node docs/examples/BypassNode.js

Install

npm install --save @ircam/sc-audio

Example Use

import {
  AudioContext,
  AudioBufferSourceNode,
  ConvolverNode,
} from 'isomorphic-web-audio-api';
import {
  AudioBufferLoader,
  DistributorNode,
} from '@ircam/sc-audio';

// in browsers, you will need to resume on a user gesture
const audioContext = new AudioContext();
// load an audio buffer
const loader = new AudioBufferLoader(audioContext);
const ir = await loader.load('../assets/room-large.wav');
const buffer = await loader.load('../assets/drum-loop.wav');

// create the graph
const convolver = new ConvolverNode(audioContext, { buffer: ir });
convolver.connect(audioContext.destination);

const dryWet = new DistributorNode(audioContext);
// connect dry output (0) to destination
dryWet.connect(audioContext.destination, 0);
// connect wet output (1) to convolver
dryWet.connect(convolver, 1);

// pipe a source in the graph
const src = new AudioBufferSourceNode(audioContext, { buffer, loop: true });
src.connect(dryWet);
src.start();

// ramp from dry to wet in 4 seconds, then back to dry
dryWet.ratio.setValueAtTime(0, audioContext.currentTime);
dryWet.ratio.linearRampToValueAtTime(1, audioContext.currentTime + buffer.duration);
dryWet.ratio.exponentialRampToValueAtTime(0.001, audioContext.currentTime + buffer.duration * 2);

License

BSD-3-Clause