Code Monkey home page Code Monkey logo

webrtc-group-chat-example's Introduction

About this fork

This fork is intended for use only with audio so video support was removed because I have no intentions to test and support it. Also I don't have a webcam.

Second, HTTPS support was added because without it this demo was working for Firefox users only (which allows getUserMedia for insecure hosts). Now support should be much broader, tested Chrome and Firefox on Mac, Chrome on Android. From now on client.html and signaling server should be hosted on SSL enabled domain.

3rd, some issues were fixed (but some deprecation issues are still there).

PS: hosting slightly modified version of this with channels support. feel free to explore: https://ham.ayeaye.ae

About

This is a "simple", but complete example of how to utilize WebRTC to do peer to peer voice chatting between two or more people.

Server Side

This example uses node.js and socket.io to create a "Signaling Server", which runs on (or near) your web server to manage who should talk to who. The purpose of the signaling server is to relay information between peers while you are setting them up to talk directly to each other.

Client Side

Included is client.html which contains all of the logic to connect to the signaling server, join a virtual group chat channel, connect with peers, and stream audio to all party members using the raw WebRTC API.

Running

Node.js signaling server

You'll need to install node.js as well as the express and socket.io libraries:

npm install

Then change in signaling-server.js variables SSL_KEY_PATH and SSL_CERT_PATH to the full path to key and certificate of domain you are hosting this demo on.

And then simply run the signaling server:

node signaling-server.js

Web server

You'll also probably want to host client.html on a web server somewhere. You'll need to edit client.html and change YOUR_HTTPS_DOMAIN to be the hostname or IP of the signaling server.

Note: you cannot file locally or AFAIK host signaling server and client.html on different hosts.

Running the sample

Now navigate to wherever you stuck client.html and you should be presented with a dialog asking permission to access your microphone / webcam. Once accepted, you should see a local stream appear on the page. Now open up the same page in another browser, on the same computer or another, and watch as the magic of WebRTC takes effect and both images and audio samples mysteriously move from one browser to the other. Repeat with as many browsers as you dare.

Note: At the time of writing this, only firefox and chrome support WebRTC, however both browsers support this on Windows, Linux, Mac, and Android, so lots of fun can be had pointing everyones' phones, tablets, and laptops at that client.html and bogging down your network with audio traffic.

Using things other than jQuery, node.js, and socket.io

The choice of node.js and socket.io is based purely on my familiarity with them and the fact that their fairly easy to understand even if you aren't familiar with them. However, you can use any mechanisms you want for your signaling system, you just need a way to exchange ICE candidates and session descriptions between clients.

The use of jQuery is even less important, I just like using it for DOM manipulation, and we only do that to add and remove the elements in this demo. We don't use it at all for anything WebRTC specific in this example.

Adapter.js

You'll see client.html use adapter.js. This "library" just normalizes the WebRTC API, which will only be necessary while WebRTC is making its way through the standards process. Once everything is standardized and functions are de-prefixed in the browsers, this won't be necessary anymore.

webrtc-group-chat-example's People

Contributors

anoek avatar jcarapia avatar vigilancer avatar

Stargazers

 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.