Dida.js

An audio stream blender for the browser.

Install

Install with npm

$ npm install dida.js

Or install with yarn

$ yarn add dida.js

import Dida from 'dida.js';

Or umd builds are also available

<script src="path/to/dida.js"></script>

Will expose the global variable to window.Dida.

Usage

const dida = new Dida({
  // Default volume
  volume: 0.7,

  // Whether to cache the played audio data
  cache: true,

  // Audio segment size
  chunk: 64 * 1024,

  // Maximum time difference between audio and video synchronization
  maxTimeDiff: 200,

  // Whether to automatically terminate the audio stream
  autoEnd: true,

  // Automatically terminate the audio stream
  autoEndTime: 5000,

  // Activate audio after trying to touch the screen on the mobile
  touchResume: true,

  // Time stamp calibration can be returned when preparing to play the next audio segment
  onNext: t => t,

  // When loading into an audio stream
  onLoad: () => null,

  // Stop playing
  onStop: () => null,

  // When starting to play
  onPlay: () => null,

  // When terminating loading
  onEnd: () => null,

  // When destroyed
  onDestroy: () => null,

  // When audio segmentation decoding is completed
  onDecodeDone: () => null,

  // When decoding is wrong
  onDecodeError: () => null,

  // When the volume changes
  onVolumeChange: () => null,

  // When freeing memory
  onFreeMemory: () => null,
});

Api

// getter and setter of the volume from 0 to 1;
dida.volume;

// Load a Uint8Array and a corresponding timestamp
dida.load(uint8, timestamp);

// Manually terminate loading
dida.end();

// Play by the specified timestamp
dida.play(timestamp);

// Stop play
dida.stop();

License

MIT © Harvey Zack