socketio-over-nodejs

socketio-over-nodejs for WebRTC Experiments: https://www.webrtc-experiment.com/socket.io/.

npm install socketio-over-nodejs
1 downloads in the last day
17 downloads in the last week
57 downloads in the last month

Socket.io over Node.js / Demo

socket.io over node.js for webrtc-signaling!

=

Install via npm

npm install socketio-over-nodejs

and run the signaler.js nodejs file:

cd node_modules/socketio-over-nodejs/ && node signaler

=

  1. https://www.webrtc-experiment.com/docs/WebRTC-Signaling-Concepts.html
  2. http://www.RTCMultiConnection.org/FAQ/
  3. http://www.RTCMultiConnection.org/docs/sessionid/
  4. http://www.RTCMultiConnection.org/docs/channel-id/

=

Otherwise, follow these steps:

  1. Download and extract ZIP file of this repository then copy folder-location of thesignaler.js file
  2. Open Node.js command prompt window
  3. Type command cd folder-location where folder-location can be C:\socketio-over-nodejs
  4. Type npm install express or download ZIP
  5. Type npm install socket.io or download ZIP
  6. Type node signaler to run the node.js server

Then open http://localhost:8888/.

=

If you want to deploy your application

  1. Create an account at nodejitsu
  2. Use same Node.js command prompt window
  3. Type jitsu deploy

and you're done!

Remember: jitsu deploy command will deploy the entire directory containing all all files including node_modules (i.e. dependencies).

=

How to use?

In ui.js files you can find openSocket method; or in all libraries; you can find openSignalingChannel method.

// http://socketio-over-nodejs.hp.af.cm/
// http://socketio-over-nodejs.jit.su:80/
// http://webrtc-signaling.jit.su:80/

var SIGNALING_SERVER = 'http://socketio-over-nodejs.hp.af.cm';
connection.openSignalingChannel = function(config) {   
   var channel = config.channel || this.channel || 'default-namespace';
   var sender = Math.round(Math.random() * 9999999999) + 9999999999;

   io.connect(SIGNALING_SERVER).emit('new-channel', {
      channel: channel,
      sender : sender
   });

   var socket = io.connect(SIGNALING_SERVER + channel);
   socket.channel = channel;

   socket.on('connect', function () {
      if (config.callback) config.callback(socket);
   });

   socket.send = function (message) {
        socket.emit('message', {
            sender: sender,
            data  : message
        });
    };

   socket.on('message', config.onmessage);
};

io.connect(URL).emit('new-channel') starts a new namespace that is used privately or publicly to transmit/exchange appropriate stuff e.g. room-details, participation-requests, SDP, ICE, etc.

=

Presence Detection

You can detect presence of a room like this:

// http://socketio-over-nodejs.hp.af.cm/
// http://socketio-over-nodejs.jit.su:80/
// http://webrtc-signaling.jit.su:80/

var SIGNALING_SERVER = 'http://webrtc-signaling.jit.su:80/';
function testChannelPresence(channel) {
    var socket = io.connect(SIGNALING_SERVER);
    socket.on('presence', function (isChannelPresent) {
        console.log('is channel present', isChannelPresent);
        if (!isChannelPresent) startNewSession();
    });
    socket.emit('presence', channel);
}

// test whether default channel already created or not!
testChannelPresence('default-channel');

=

What is cd folder-location?

Using this command; you can open project's directory (i.e. folder).

=

What is node signaler?

This command runs node.js server via signaler.js file. That file handles socket.io relevant stuff.

=

What is jitsu deploy?

This command deploys the entire directory (i.e. project, including all node_modules dependencies) over nodejitsu servers. You will be able to access your deployed project using URL like this:

http://username.jit.su/

See the demo URL: http://webrtc-signaling.jit.su/

=

Note

Each experiment is using something like this:

var SIGNALING_SERVER = '/';

This is the URL of your site. By default it will be equal to http://localhost:8888/.

It is strongly recommended to use absolute URL including port number:

var SIGNALING_SERVER = 'http://domain.com:8888/';

=

Are you beginner or totally novice?

  1. To run socket.io on your computer; you need to download node.js software from nodejs.org.
  2. If you're using windows; in the Start Menus; you can type node in the search-box. Node.js command prompt will be listed on the top.
  3. You can use same command prompt to run any node.js file; also you can write nodejitsu commands in the same place e.g. jitsu deploy or jitsu login etc.
  4. Default port 8888 is used for this experiment. You can manually open this URL: http://localhost:8888/

=

Signaling Concepts

Interested to understand WebRTC Signaling Concepts? Read this document.

=

SSL/TLS/HTTPS/Socket.io/Node.js ??

https://github.com/muaz-khan/WebRTC-Experiment/issues/62

=

License

Socket.io over Node.js is released under MIT licence . Copyright (c) 2013 Muaz Khan.

npm loves you