openvidu-call

Check it on GitHub

OpenVidu Call demo, built with Angular 7, allows users to make videoconference calls with many of the capabilities integrated by OpenVidu platform. It is a frontend-only application.

OpenVidu-Call is composed by the six Angular components displayed in the image below.







Running this demo

You have several options to run OpenVidu Call:

Using Docker

The easiest way is running this Docker container (you will need Docker CE):

docker run -p 4443:4443 openvidu/openvidu-call

Cloning GitHub Repository

1) Clone the repo:

git clone https://github.com/OpenVidu/openvidu-call.git

2) You will need node, NPM and angular-cli to execute the app. You can install them with:

sudo apt-get update
sudo curl -sL https://deb.nodesource.com/setup_10.x | sudo bash -
sudo apt-get install -y nodejs
sudo npm install -g @angular/cli

3) openvidu-server and Kurento Media Server must be up and running in your development machine. The easiest way is running this Docker container which wraps both of them (you will need Docker CE):

docker run -p 4443:4443 --rm -e openvidu.secret=MY_SECRET openvidu/openvidu-server-kms:2.11.0

4) Install NPM dependencies of Angular app:

cd openvidu-call/front/openvidu-call
npm install

5) Launch the server:

ng serve --open


If you are using Windows, read this FAQ to properly run the tutorial

To learn some tips to develop with OpenVidu, check this FAQ

Using the Release

Here are OpenVidu Call releases. The openvidu-call-X.X.X.tar.gz file contains the compiled app served in / and openvidu-call-demos-X.X.X.tar.gz file contains the compiled app served in /openvidu-call/.

To run OpenVidu Call with the compiled files you will need:

1) openvidu-server and Kurento Media Server must be up and running in your development machine. The easiest way is running this Docker container which wraps both of them (you will need Docker CE):

docker run -p 4443:4443 --rm -e openvidu.secret=MY_SECRET openvidu/openvidu-server-kms:2.11.0

2) Download the release:

wget https://github.com/OpenVidu/openvidu-call/releases/download/v2.8.0/openvidu-call-demos-2.8.0.tar.gz

3) Decompress the downloaded file:

mkdir openvidu-call
tar -xvzf openvidu-call-2.8.0.tar.gz -C openvidu-call/
cd openvidu-call

4) You will need a HTTP server to display the app like NGINX or http-server. We will use http-server:

You will need node and NPM to install http-server. You can install them with:

sudo apt-get update
sudo curl -sL https://deb.nodesource.com/setup_10.x | sudo bash -
sudo apt-get install -y nodejs

Install http-server:

npm i http-server

5) Serve the app:

http-server

Wait until you see on the output a line IP address.

By default, the app will be served in localhost:8080 address. You will need go to https://localhost:4443/ to accept the self-signed certificate. Once accepted, you will be able to test OpenVidu Call in the default IP localhost:8080

Extra features

Using the OpenVidu Call release, you can set up the address where your app will be served with http-server -a "your_address". Moreover, by including a JSON file named ov-settings.json in the root directory, you can configure the openvidu_url and openvidu_secret;

{
  "openviduCredentials": {
    "openvidu_url": "https://0.0.0.0:4443",
    "openvidu_secret": "MY_SECRET"
  }
}

Not only you can establish your own openvidu_url and openvidu_secret parameters, but also you can customize the session interface adding an extra JSON object named openviduSettings inside of the file. You have explained how openviduSettings object must be treated in detail here.