/pcm-player

PCM real-time player . play pcm data/stream in browser through ajax/websocket or others. 网页播放PCM数据。

Primary LanguageJavaScriptMIT LicenseMIT

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