pcm-player/README.md

PCM Player

A minimalist javascript audio player for PCM streaming data for the browsers.

How to use?

var player = new PCMPlayer(option);

Available options are:

encoding - possible values 8bitInt / 16bitInt / 32bitInt / 32bitFloat default: 16bitInt

channels - no of channels in PCM data

sampleRate - sample rate of the PCM data

flushingTime - flushing interval of PCM data to be played in milisecond. Default 1000ms

Decoder fire an event decode whenever it completes decoding. Usually it decodes several opus packet at a time for better performance although it need to be provided single opus packet into decode method.

Complete example:

var player = new PCMPlayer({
    encoding: '16bitInt',
    channels: 2,
    sampleRate: 8000,
    flushingTime: 2000
});

// Now feed PCM data into player getting from websocket or ajax whatever the transport you are using.
player.feed(pcm_data);

Available Methods

Name	Parameter	Remark
feed	raw PCM data	Usually get from ajax or websocket
volume	decimal value 0 to 1	For controlling volume of the player
destroy	-	Destroy the player instance and release the resources

Compatibility

it is supported on:

• Chrome for Android 34+
• Chrome for Desktop 34+
• Firefox for Android 41+
• Firefox for Desktop 42+
• IE11+ for Windows 8.1+
• Edge for Windows 10+
• Opera for Desktop
• Safari for Mac 8+
• Safari for iOS 8+

How to run example?

An example with simple node server script is available that include some raw pcm data that will be served by websocket and at the client end, it will be played through PCM player. For running the example, first run the node server by following command: (I am assuming you are on project directory i.e pcm-player)

cd example/server

node server.js

then, visit example/index.html page through any webserver.

If you don't have any web server, you can do following:

(I am assuming you are on project directory i.e pcm-player)

npm install http-server -g

then run following command

http-server

Finally visit example page using URL http://192.168.0.105:8081/example/index.html OR URL suggested by http-server