README.md

Ant Media Server WebRTC SDK

WebSocket interface in publishing and playing WebRTC streams on Ant Media Server using Javascript.

For more information, visit antmedia.io

Installation

Using npm:

$ npm install @antmedia/webrtc_adaptor

Using yarn:

$ yarn add @antmedia/webrtc_adaptor

Requirements

Before start using Ant Media Server WebRTC SDK, you need a distribution of the Ant Media Server running on a server or local machine. Quick Start - Ant Media Server

Usage

In your project, run:

npm i @antmedia/webrtc_adaptor --save-dev

Then inside your javascript file:

Initialize the WebRTCAdaptor

  // ...
import { WebRTCAdaptor } from '@antmedia/webrtc_adaptor';

const webRTCAdaptor = new WebRTCAdaptor({
    websocket_url: "wss://your-domain.tld:5443/WebRTCAppEE/websocket",
    mediaConstraints: {
        video: true,
        audio: true,
    },
    peerconnection_config: {
        'iceServers': [{'urls': 'stun:stun1.l.google.com:19302'}]
    },
    sdp_constraints: {
        OfferToReceiveAudio : false,
        OfferToReceiveVideo : false,
    },
    localVideoId: "id-of-video-element", // <video id="id-of-video-element" autoplay muted></video>
    bandwidth: int|string, // default is 900 kbps, string can be 'unlimited'
    dataChannelEnabled: true|false, // enable or disable data channel
    callback: (info, obj) => {}, // check info callbacks bellow
    callbackError: function(error, message) {}, // check error callbacks bellow
});
//...

In another part of your script:

Publish

// You can start streaming by calling the publish method
webRTCAdaptor.publish(streamId);

Play

// You can start streaming by calling the publish method
webRTCAdaptor.play(streamId);

Samples

Visit The Samples List and look at their sources codes

Documentation

Javascript SDK Documentation

Live Demo

You can check our live demo.

Issues

Create issues on the Ant-Media-Server