audio-playerx

Core audio player in the browser

Installation

npm install audio-playerx

or

yarn add audio-playerx

Usage

audio-playerx support two modes.

HTMLAudioElement

import Playerx, { PLAYER_STATE, PLAYER_MODE } from "audio-playerx";
 
// initialization
const player = new Playerx({
  mode: PLAYER_MODE.Audio,
  onStateChange(value) {
    console.log(value);
  }
});
 
// play your audio
player.play(resource: string);
 
// pause
player.pause();
 
// play continue
player.play();

Web Audio API

import Playerx, { PLAYER_STATE, PLAYER_MODE } from "audio-playerx";
 
// initialization
const player = new Playerx({
  mode: PLAYER_MODE.AudioContext,
  onStateChange(value) {
    console.log(value);
  }
});
 
// play your audio
player.play(buffer: ArrayBuffer);
 
// stop
player.stop();
 
// close player
player.close();

API

AudioPlayer

import { AudioPlayer } from "audio-playerx";
 
new AudioPlayer();
 
// is equal to
 
new Playerx({ mode: PLAYER_MODE.Audio });

• Support play, pause and resume

Constructor

new ({ onStateChange?: onStateChange } = {}): AudioPlayer;

onStateChange is a callback, called when the player state changes.

type onStateChange: (value: PLAYER_STATE) => any;

Methods

play: (resource: string | undefined) => Promise<PLAYER_STATE | undefined>

audio play and resume.

When the parameter 'resource' is passed, it will start playing from the beginning, otherwise it is used to continue playing the paused audio.

pause: () => void

ACTXPlayer

import { ACTXPlayer } from "audio-playerx";
 
new ACTXPlayer();
 
// is equal to
 
new Playerx({ mode: PLAYER_MODE.AudioContext });

• Only supports play, stop
• doesn't support pause, resume

Constructor

new ({ onStateChange?: onStateChange } = {}): AudioPlayer;

onStateChange is a callback, called when the player state changes.

type onStateChange: (value: PLAYER_STATE) => any;

Methods

play: (buffer: ArrayBuffer) => Promise<PLAYER_STATE | undefined>,

stop: () => void

close: () => void

PLAYER_MODE

player mode enum

{
  Audio: 0,
  AudioContext: 1,
}

PLAYER_STATE

player state enum

{
  READY: 0,
  LOADING: 1,
  PLAYING: 2,
  PAUSED: 3,
  FAILED: 4,
  DESTROYED: 5,
}