DEV Community

Cover image for Introduction to WebRTC
Abhishek Jaiswal
Abhishek Jaiswal

Posted on

Introduction to WebRTC

Installation and Code Guide

WebRTC (Web Real-Time Communication) is an open-source technology that enables real-time communication via simple APIs in web browsers and mobile apps. It allows audio, video, and data sharing directly between peers without needing an intermediary server, making it perfect for applications like video conferencing, live streaming, and file sharing.

In this blog, we'll dive into the following topics:

  1. What is WebRTC?
  2. Key Features of WebRTC
  3. Installing WebRTC
  4. Building a Basic WebRTC Application
  5. Understanding the Code
  6. Conclusion

What is WebRTC?

WebRTC is a set of standards and protocols that enables real-time audio, video, and data communication between web browsers. It includes several key components:

  • getUserMedia: Captures audio and video streams from the user's device.
  • RTCPeerConnection: Manages the peer-to-peer connection and handles audio and video streaming.
  • RTCDataChannel: Allows for real-time data transfer between peers.

Key Features of WebRTC

  1. Real-Time Communication: Low latency communication with minimal delay.
  2. Browser Compatibility: Supported by most modern web browsers (Chrome, Firefox, Safari, Edge).
  3. No Plugins Required: Works directly in the browser without additional plugins or software.
  4. Secure: Uses encryption for secure communication.

Installing WebRTC

WebRTC is a client-side technology and does not require a specific server installation. However, you will need a web server to serve your HTML and JavaScript files. For local development, you can use a simple HTTP server.

Prerequisites

  • Node.js: To set up a local server.
  • A Modern Web Browser: Chrome, Firefox, Safari, or Edge.

Setting Up a Local Server

  1. Install Node.js: Download and install Node.js from nodejs.org.

  2. Create a Project Directory: Open a terminal and create a new directory for your project.

    mkdir webrtc-project
    cd webrtc-project
    
  3. Initialize a Node.js Project:

    npm init -y
    
  4. Install HTTP Server:

    npm install --save http-server
    
  5. Create Your Project Files:

    • index.html
    • main.js

Create an index.html file with the following content:

```html
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>WebRTC Example</title>
</head>
<body>
    <h1>WebRTC Example</h1>
    <video id="localVideo" autoplay muted></video>
    <video id="remoteVideo" autoplay></video>
    <script src="main.js"></script>
</body>
</html>
```
Enter fullscreen mode Exit fullscreen mode

Building a Basic WebRTC Application

We'll create a simple peer-to-peer video call application. This example will use two browser tabs to simulate the peer connection.

Code Explanation

  1. Capture Local Video: Use getUserMedia to capture video from the user's camera.

  2. Create Peer Connection: Establish a peer connection between the local and remote peers.

  3. Exchange Offer and Answer: Use SDP (Session Description Protocol) to exchange connection details.

  4. Handle ICE Candidates: Exchange ICE candidates to establish the connection.

Create a main.js file with the following content:

const localVideo = document.getElementById('localVideo');
const remoteVideo = document.getElementById('remoteVideo');

let localStream;
let peerConnection;
const serverConfig = { iceServers: [{ urls: 'stun:stun.l.google.com:19302' }] };
const constraints = { video: true, audio: true };

// Get local video stream
navigator.mediaDevices.getUserMedia(constraints)
    .then(stream => {
        localStream = stream;
        localVideo.srcObject = stream;
        setupPeerConnection();
    })
    .catch(error => {
        console.error('Error accessing media devices.', error);
    });

function setupPeerConnection() {
    peerConnection = new RTCPeerConnection(serverConfig);

    // Add local stream to the peer connection
    localStream.getTracks().forEach(track => peerConnection.addTrack(track, localStream));

    // Handle remote stream
    peerConnection.ontrack = event => {
        remoteVideo.srcObject = event.streams[0];
    };

    // Handle ICE candidates
    peerConnection.onicecandidate = event => {
        if (event.candidate) {
            sendSignal({ 'ice': event.candidate });
        }
    };

    // Create an offer and set local description
    peerConnection.createOffer()
        .then(offer => {
            return peerConnection.setLocalDescription(offer);
        })
        .then(() => {
            sendSignal({ 'offer': peerConnection.localDescription });
        })
        .catch(error => {
            console.error('Error creating an offer.', error);
        });
}

// Handle signals (for demo purposes, this should be replaced with a signaling server)
function sendSignal(signal) {
    console.log('Sending signal:', signal);
    // Here you would send the signal to the other peer (e.g., via WebSocket)
}

function receiveSignal(signal) {
    if (signal.offer) {
        peerConnection.setRemoteDescription(new RTCSessionDescription(signal.offer))
            .then(() => peerConnection.createAnswer())
            .then(answer => peerConnection.setLocalDescription(answer))
            .then(() => sendSignal({ 'answer': peerConnection.localDescription }));
    } else if (signal.answer) {
        peerConnection.setRemoteDescription(new RTCSessionDescription(signal.answer));
    } else if (signal.ice) {
        peerConnection.addIceCandidate(new RTCIceCandidate(signal.ice));
    }
}

// Simulate receiving a signal from another peer
// This would typically be handled by a signaling server
setTimeout(() => {
    receiveSignal({
        offer: {
            type: 'offer',
            sdp: '...' // SDP offer from the other peer
        }
    });
}, 1000);
Enter fullscreen mode Exit fullscreen mode

Understanding the Code

  1. Media Capture: navigator.mediaDevices.getUserMedia captures the local video stream.
  2. Peer Connection Setup: RTCPeerConnection manages the peer connection.
  3. Offer and Answer: SDP offers and answers are used to negotiate the connection.
  4. ICE Candidates: ICE candidates are used to establish connectivity between peers.

Top comments (10)

Collapse
 
mohamed_karim_2dddebb42bd profile image
mohamed karim

Thank for sharing

Collapse
 
heyeasley profile image
heyeasley 🍓🥭 • Edited

Good. We can think about SKype, Microsoft Teams, Google Hangout. I want to know Kubernetes. Also can we apply WebRTC on any OS ?

Collapse
 
pablets profile image
Pablets

It woud be great to add more info to the content, I think as an introduction is more important understand the concept rather than the code. Without them the code is just a recipe to do something we don't understand "it just works".

Are links to more info, oficcial docs, etc?
Why do I need a node server?

In particular this part is a bit misleading:

Code Explanation
Capture Local Video: Use getUserMedia to capture video from the user's camera.

Create Peer Connection: Establish a peer connection between the local and remote peers.

Exchange Offer and Answer: Use SDP (Session Description Protocol) to exchange connection details.

Handle ICE Candidates: Exchange ICE candidates to establish the connection.

There is a lot of names and concepts but there is not a single definition of them.

Thank you for your work

Collapse
 
heyeasley profile image
heyeasley 🍓🥭

I shear opinion.

Collapse
 
muslmasan profile image
MOHAMED HASSAN ALI

Thank you bro it's was really helpful

Collapse
 
isahtech200 profile image
Isah Aruna

Thank you so much . Please I would love the both of us to have a session pls give me your time. I really wat to know how this can be deployed on premises seveer . Without using internet pls. Thanl you so much

Collapse
 
janmpeterka profile image
Jan Peterka

Hi, it looks like this post might be LLM-generated. If that's the case, it would be propriate to say so, either using tag or writing about it in the text.

Collapse
 
isahtech200 profile image
Isah Aruna

Pls what do you means that it work directly on the browser without additional plugin or software. Can it work on-premises server . Can it be deployed on on-premises server

Collapse
 
isahtech200 profile image
Isah Aruna

@abhishekjaiswal_4896 pls reply my question very important

Collapse
 
abhishekjaiswal_4896 profile image
Abhishek Jaiswal

WebRTC itself is browser-based and doesn't need plugins.

Yes, WebRTC can work with on-premises servers!

You can deploy your WebRTC application (web app) on an on-premises web server like Apache, NGINX, or Node.js.