PCMPlayer

A minimalist javascript audio player for PCM streaming data for the browsers.
浏览器端简单的PCM数据流播放器

How to use?（使用说明）

var player = new PCMPlayer(options);

Available options are:
可配置项如下:

| Name | Parameter |Default | Type |Remark| | ----- |:-----:| -----:|-----:|-----:| |inputCodec| Int8 / Int16 / Int32 / Float32 |Int16|string|编码格式| |channels| |1|number |声道数| |sampleRate| |8000| number|采样率| |flushTime| |1000|number| flushing interval of PCM data to be played in milisecond（PCM数据缓冲多久进行播放）| |fftSize| |2048|number| a power of 2 between 2^5 and 2^15|

Complete example（使用示例）:

Install（安装）

install by CDN or npm

CDN

<script src="https://unpkg.com/pcm-player"></script>

ES6

npm i pcm-player

// in your js/ts file
import PCMPlayer from 'pcm-player'

use（使用）

var player = new PCMPlayer({
    inputCodec: 'Int16',
    channels: 2,
    sampleRate: 8000,
    flushTime: 2000
});

// Now feed PCM data into player getting from websocket or ajax whatever the transport you are using.Accept ArrayBuffer or TypedArray
// 接收PCM格式的原始数据，ArrayBuffer 类型或者 TypedArray 类型
player.feed(pcm_data);

Available Methods（方法）

| Name | Parameter | Remark | | ------------- |:-------------:| -----:| | feed | raw PCM data | Usually get from ajax or websocket | volume | decimal value 0 to +∞ () | For controlling volume of the player, default is 1 | | destroy | - | Destroy the player instance and release the resources | | pause |-|pause playing| | continue|-|resume playing|

Available Attributes（属性）

| Name | Remark | | ------------- | -----:| | audioCtx | current AudioContext | gainNode | AudioContext gainNode | analyserNode | AudioContext AnalyserNode

Available Event（事件）

|Name|Parameter|Remark| |----|---------|-| |onstatechange|(node, event, type)|node: AudioContext, event: Event, type: AudioContextState| |onended|(node, event)|node: AudioBufferSourceNode, event: Event|

How to run example?（体验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.

1. open server directory （进入到server目录）

   cd example/server

2. run a local server （把本地的服务端跑起来，会起一个websocket服务，用来发送数据）

   node server.js

3. then, just open example/index.html page.（直接双击example里面的index.html）

Thoubleshooting（常见问题）

Safari only allow to play large than 22050Hz voice.
Safari浏览器播放的音频数据，采样率不能低于22050Hz。

更多webaudio经验可以在此查看：websocket pcm webaudio 经验

online demo（在线demo)

pcm-player demo

Thanks to（鸣谢）

Inspired by pcm-player