@antmedia/videojs-webrtc-plugin
v1.3.2
Published
streaming via WebRTC with Ant-MediaServer
Downloads
1,972
Readme
videojs-webrtc-plugin
Plugin for viewing streams located on the ant-media server. There is also a function to change the resolution of the stream
Table of Contents
Quick Start
To quickly install the videojs-webrtc-plugin
and run it locally on your server, follow the below steps.
Clone the repository on your local system.
git clone https://github.com/ant-media/videojs-webrtc-plugin.git
After cloning the repository, run the below commands to build and run the project locally.
npm install npm run build npm run start
After the project runs, it will run on any specific port (for example, port 10000), so you can access it on http://localhost:10000 or http://IP-address:10000 if running on any cloud server.
Once the plugin runs in browser, replace the websocket URL with your server's websocket URL in the WS stream link and load the stream. Check the streamUrl part for reference.
Installation
In order to integrate the plugin into your external project, use the below command to install the package.
npm install --save @antmedia/videojs-webrtc-plugin
Usage
To include videojs-webrtc-plugin on your website or web application, use any of the following methods.
Source Object
streamUrl
Ant-MediaServer stream address format:
ws://[ant-address]/[app]/[streamId].webrtc?token=[token(opt)]&subscriberId=[subscriberId(opt)]&subscriberCode=[TOTP-code(opt)]
For example:
ws://12.23.322.157:5080/LiveApp/stream1.webrtc
Addtional Parameters:-
token (optional)
- a one-time token generated for the stream (in case the stream is protected by the one-time token protection mechanismsubscriberId (optional)
- subscriber Id. Required if the stream is protected by a TOTP passwordsubscriberCode (optional)
- generated TOTP password. Required if the stream is protected by a TOTP password
iceServers
Array of Ice-servers (STUN, TURN) in JSON string format to establish a WebRTC connection.
For example:
'[ { "urls": "stun:stun1.l.google.com:19302" } ]'
<script>
Tag
This is the simplest case. Get the script in whatever way you prefer and include the plugin after you include video.js, so that the videojs
global is available.
<script src="//path/to/video.min.js"></script>
<script src="//path/to/videojs-webrtc-plugin.min.js"></script>
<div id="video_container">
<video id=my-video width=960 height=540 class="video-js vjs-default-skin" controls>
<source
src="ws://localhost:5080/LiveApp/stream1.webrtc" iceServers = '[ { "urls": "stun:stun1.l.google.com:19302" } ]'
>
</video>
</div>
<script>
var player = videojs('my-video');
</script>
Browserify/CommonJS
When using with Browserify, install videojs-webrtc-plugin via npm and require
the plugin as you would any other module.
var videojs = require('video.js');
// The actual plugin function is exported by this module, but it is also
// attached to the `Player.prototype`; so, there is no need to assign it
// to a variable.
require('videojs-webrtc-plugin');
var player = videojs('my-video');
player.src({
src: 'ws://localhost:5080/LiveApp/stream1.webrtc',
iceServers: '[ { "urls": "stun:stun1.l.google.com:19302" } ]'
});
RequireJS/AMD
When using with RequireJS (or another AMD library), get the script in whatever way you prefer and require
the plugin as you normally would:
require(['video.js', 'videojs-webrtc-plugin'], function(videojs) {
var player = videojs('my-video');
player.src({
src: 'ws://localhost:5080/LiveApp/stream1.webrtc',
iceServers: '[ { "urls": "stun:stun1.l.google.com:19302" } ]'
});
});
Handling error-callbacks
Ant-MediaServer has functionality to handle errors coming from the backend. To catch an error, you need to subscribe to the event "ant-error":
<script src="//path/to/video.min.js"></script>
<script src="//path/to/videojs-webrtc-plugin.min.js"></script>
<script>
var player = videojs('my-video');
player.src({
src: 'ws://localhost:5080/LiveApp/stream1.webrtc',
iceServers: '[ { "urls": "stun:stun1.l.google.com:19302" } ]'
});
player.on('ant-error', function(event, errors) {
console.log(errors);
});
</script>
License
MIT. Copyright (c) Ant Media
Issues
In case of any problem, please create issues at Ant-Media-Server Repository