comhall-webrtc

WebRTC producer/consumer for Community Hall projects.

The package contains three modules: producer, consumer and node.js server.

Producer

Producer module is used for capturing media streams from connected media devices and making them accessible by remote consumers. Producer uses WebRTC for streaming.

1. Run server
2. Run HTTP server (WebRTC does not allow access to the media sources from file:/// resources):

$ python -m SimpleHTTPServer 8000

3. Open localhost:8000/producer page in browser (Chrome)

Hint: while on producer's page, press 's' to see custom settings panel

Hint: while on producer's page, press 'l' to see the current log

Consumer

Consumer module is used for fetching media streams published by a remote producer.

1. Make sure the server is running
2. Make sure server is accessible through your network (for the date 1/22/2014 server's static IP address is 192.168.100.122)

	$ ping 192.168.100.122

3. Open http://192.168.100.122:8000/consumer/ in the browser
4. Type server's IP address (192.168.100.122 as of 1/22/2014) in the field and press 'Fetch'
5. Video stream should be received momentarily

Hint: while on consumer's page, press 'l' to see the current log

Server

Server module is used for delivering signaling functionality between consumers and producer so that the WebRTC's negotiation process can be conducted.

1. Install node.js
2. Get express package:

$ npm install --save express@4.10.2

3. Get socket.io package:

$ npm install --save socket.io

4. Run server:

$ node server/index.js

Two cameras support

In case if there is a need for publishing two streams from different devices, two producer instances can be launched on the same machine in separate browser tabs with different port options enabled on the settings panel (press 's' to reveal it on the producer's page):

1. Run PTZ camera server:

$ node server/index.js 3001

2. In separate Terminal window, run WebCamera server:

$ node server/index.js 3002

3. Open localhost:8000/producer page in first browser tab
   • Press 's'
   • Choose '3001 (PTZ camera)' server port option
   • Configure producer to acquire video from PTZ camera by choosing appropriate device from the list
4. Open localhost:8000/producer page in second browser tab
   • Press 's'
   • Choose '3002 (Web camera)' server port option
   • Configure producer to acquire video from web camera by choosing appropriate device from the list

Hint: Sometimes, when changing publishing camera on one producer tab while other producer is running, consumer may still receive old video stream. Try refreshing consumer page, chose correct camera and press 'Fetch' again.