WebRTC-streamer

This is a try to stream video sources through WebRTC using simple mechanism.

It embeds a HTTP server that implements API and serve a simple HTML page that use them through AJAX.

The WebRTC signaling is implemented throught HTTP requests:

/call : send offer and get answer
/hangup : close a call
/addIceCandidate : add a candidate
/getIceCandidate : get the list of candidates

The list of HTTP API is available using /help.

Nowdays there is 2 builds on Travis CI :

for x86_64 on Ubuntu trusty
for arm crosscompiling with gcc-linaro-arm-linux-gnueabihf-raspbian-x64 (this build is running on Raspberry Pi and NanoPi NEO)

Dependencies :

It is based on :

Build

Build WebRTC with H264 support

mkdir ../webrtc
pushd ../webrtc
fetch webrtc
gn gen out/Release --args='is_debug=false rtc_use_h264=true ffmpeg_branding="Chrome" rtc_include_tests=false'
ninja -C out/Release
popd

Build live555 to enable RTSP support(optional)

wget http://www.live555.com/liveMedia/public/live555-latest.tar.gz -O - | tar xzf -
pushd live
./genMakefiles linux
sudo make install
popd

Build WebRTC Streamer

make WEBRTCROOT=<path to WebRTC> WEBRTCBUILD=<Release or Debug> PREFIX=/usr/local

where WEBRTCROOT and WEBRTCBUILD indicate how to point to WebRTC :

$WEBRTCROOT/src should contains source
$WEBRTCROOT/src/out/$WEBRTCBUILD should contains libraries and where PREFIX point to live555 installation (default is /usr/local)

Usage

./webrtc-streamer [-H http port] [-S embeded stun address] -[v[v]]  [url1]...[urln]
./webrtc-streamer [-H http port] [-s externel stun address] -[v[v]] [url1]...[urln]
    	-v[v[v]]           : verbosity
     	-H [hostname:]port : HTTP server binding (default 0.0.0.0:8000)
     	-S stun_address    : start embeded STUN server bind to address (default 127.0.0.1:3478)
     	-s[stun_address]   : use an external STUN server (default stun.l.google.com:19302)
     	[url]              : url to register in the source list

Example

webrtc-streamer rtsp://217.17.220.110/axis-media/media.amp \
			rtsp://85.255.175.241/h264 \
			rtsp://85.255.175.244/h264 \
			rtsp://184.72.239.149/vod/mp4:BigBuckBunny_175k.mov

Live Demo

You can access to the WebRTC stream coming from an RTSP url using webrtcstream.html page with the RTSP url as argument, something like:

https://webrtc-streamer.herokuapp.com/webrtcstream.html?rtsp://217.17.220.110/axis-media/media.amp

Embed in a HTML page:

Instead of using the internal HTTP server, it is easy to display a WebRTC stream in a HTML page served by an external HTTP server. The URL of the webrtc-streamer to use should be given creating the WebRtcStreamer instance :

var webRtcServer      = new WebRtcStreamer(<video tag>, <url of webrtc-streamer>);

A short sample using webrtc-streamer running locally on port 8000 :

<html>
<head>
<script src="ajax.js" ></script>
<script src="webrtcstreamer.js" ></script>
<script>        
    var webRtcServer      = new WebRtcStreamer("video",location.protocol+"//"+window.location.hostname+":8000");
    window.onload         = function() { webRtcServer.connect("rtsp://pi2.local:8554/unicast") }
    window.onbeforeunload = function() { webRtcServer.disconnect() }
</script>
</head>
<body> 
    <video id="video" />
</body>
</html>

Connect to Janus Gateway Video Room

A simple way to publish WebRTC stream to a Janus Gateway Video Room is to use the JanusVideoRoom interface

    var janus = new JanusVideoRoom(<janus url>)

A short sample to publish WebRTC streams to Janus Video Room could be :

<html>
<head>
<script src="ajax.js" ></script>
<script src="janusvideoroom.js" ></script>
<script>        
	var janus = new JanusVideoRoom("https://janus.conf.meetecho.com/janus");
	janus.join(1234, "rtsp://pi2.local:8554/unicast","pi2");
	janus.join(1234, "rtsp://217.17.220.110/axis-media/media.amp","media");	    
</script>
</head>
</html>

Live Demo

This way the communication between Janus API and WebRTC Streamer API is implemented in Javascript running in browser. Same logic could be implemented using NodeJS, or whatever langague allowing to call HTTP requests.

Docker image

You can start the application using the docker image :

    docker run -p 8000:8000 -it mpromonet/webrtc-streamer

The container accept arguments that are forward to webrtc-streamer application, then you can :

get the help using :

  docker run -p 8000:8000 -it mpromonet/webrtc-streamer -h

expose the V4L2 device /dev/video0 using :

  docker run --device=/dev/video0 -p 8000:8000 -it mpromonet/webrtc-streamer

nistath/webrtc-streamer