openvidu-call 🔗

Check it on GitHub

OpenVidu Call demo, built with Angular 9, 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 and move to stable brach:

git clone https://github.com/OpenVidu/openvidu-call.git
cd openvidu-call
git checkout -b v2.12.0b v2.12.0

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

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

3) OpenVidu Platform service 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):

# WARNING: this container is not suitable for production deployments of OpenVidu Platform
# Visit https://docs.openvidu.io/en/stable/deployment/deploying-on-premises

docker run -p 4443:4443 --rm -e OPENVIDU_SECRET=MY_SECRET openvidu/openvidu-server-kms:2.13.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 Platform service 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):

# WARNING: this container is not suitable for production deployments of OpenVidu Platform
# Visit https://docs.openvidu.io/en/stable/deployment/deploying-on-premises

docker run -p 4443:4443 --rm -e OPENVIDU_SECRET=MY_SECRET openvidu/openvidu-server-kms:2.13.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_12.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.