jnaudiostream v1.0.2

jnaudiostream

HTML5 audio streamer library for live streaming microphone and receiving, based off sfmediastream. The transmitted data is compressed (depend on the browser media encoder) before being sent to node server, and the latency is configurable.

Install with CDN link

You can download minified js from this repository or use the CDN link

<script
    type="text/javascript"
    src="https://cdn.jsdelivr.net/npm/jnaudiostream@latest"
></script>

Install with NPM

npm i jnaudiostream

Use the library

// ES Modules
import { AudioRecorder, AudioStreamer } from "jnaudiostream";

// CommonJS
const { AudioRecorder, AudioStreamer } = require("jnaudiostream");

const recorder = new AudioRecorder(...);
const streamer = new AudioStreamer(...);

This is for web bundler like Webpack or Browserify, and can't be used as a library for Node.js. If you want to use this recorder/effect/plugin for Node.js, the I think it may be possible by using headless browser like Puppeteer.

How to use

AudioRecorder

This class is used for streaming the microphone to the server.

Properties

// Example for accessing the properties
recorder.debug = true;

Method

Event Listener

onReady

Callback when the library is ready for recording

recorder.onReady = function (packet) {
    console.log("Header size: " + packet.data.size);
    mySocket.emit("bufferHeader", packet);
};

onBuffer

Callback when data buffer is ready to be played

recorder.onBuffer = function (packet) {
    console.log("Data", packet);
    mySocket.emit("stream", packet);
};

Example

const recorder = new AudioRecorder(
    {
        /* audio:{
        sampleRate: 44100,
        channelCount: 1,
        echoCancellation: false,
    } */
    },
    1000
); // 1sec

recorder.onRecordingReady = function (packet) {
    console.log("Recording started!");
    console.log("Header size: " + packet.data.size + "bytes");

    // Every new streamer must receive this header packet
    mySocket.emit("bufferHeader", packet);
};

recorder.onBufferProcess = function (packet) {
    console.log("Buffer sent: " + packet[0].size + "bytes");
    mySocket.emit("stream", packet);
};

recorder.startRecording();

setTimeout(function () {
    recorder.stopRecording();
}, 5000);

AudioStreamer

This class is used for buffering and playing microphone stream from the server.

// The minimum duration for audio is ~100ms
var audioStreamer = new AudioStreamer(1000); // 1sec

Properties

// Example for accessing the properties
audioStreamer.debug = true;

Method

Example

var audioStreamer = new AudioStreamer(1000); // 1sec
audioStreamer.playStream();

// First thing that must be received
mySocket.on("bufferHeader", function (packet) {
    audioStreamer.setBufferHeader(packet);
});

mySocket.on("stream", function (packet) {
    console.log("Buffer received: " + packet[0].byteLength + "bytes");
    audioStreamer.receiveBuffer(packet);
});

Contribution

If you want to help jnaudiostream please fork this project and edit on your repository, then make a pull request to here.

Compile from source

After you downloaded this repo you need to install the devDependencies.

$ npm i
$ tsc -w

After you make some changes on /src it will automatically compile into /dist/. Make sure you cleared your cache before doing experiments.

License

jnaudiostream is under the MIT license.

But don't forget to add a link to this repository.