Distributed Cloud Gaming Pipeline

Structure of the repository

.
├── gstreamer-live-streaming                        # Live streaming WebRTC server (C)
│   ├── gstreamer-cheatsheet.md                         # Overview of GStreamer's most important elements
│   ├── CMakeLists.txt                                  # CMake boilerplate
│   ├── media-live-streamer.c                           # source code
│   ├── Dockerfile	                                # Docker image boilerplate
├── openGL-offscreen-rendering/headless-renderer    # Example of 3D mesh headless rendering using EGL (C++)
│   ├── main.cpp                                        # entry point of the program
│   ├── src/                                         	# Folder containing the source code
│   ├── graphics/                                       # Folder containing graphics-related classes
│   ├── utils/		                                # Utilities headers 
│   ├── extern/                                         # Extern libraries
│   ├── CMakeLists.txt                                  # CMake boilerplate
│   ├── cmake-modules/                                  # Folder containing modules to find libraries
│   ├── meshes/                                  	# Folder containing the meshes obj files
│   ├── shaders/                                 	# Folder containing the GLSL shader programs
│   ├── Dockerfile	                                # Docker image boilerplate

Installing the WebRTC Streamer

Dependencies

These dependencies have been listed here since the environment used for Docker is GStreamer ready. For other dependencies plese see the Dockerfile

The OS used to develop the application is Ubuntu 20.04, for which the default GStreamer library downloaded by apt is the 1.16. For better support with OpenGL, the latest stable version was installed, 1.18. To upgrade the repositories needed to install gstreamer-1.18 run:

sudo add-apt-repository ppa:savoury1/ffmpeg4
sudo add-apt-repository ppa:savoury1/multimedia
sudo apt update
sudo apt dist-upgrade

Then, to install the libraries needed to build and run the application locally:

sudo apt install gstreamer1.0-tools gstreamer1.0-nice gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-plugins-good libgstreamer1.0-dev libglib2.0-dev libgstreamer-plugins-bad1.0-dev libsoup2.4-dev libjson-glib-dev

NB

If you already have anaconda installed, you already have GStreamer installed. To check run:

which gst-launch-1.0

If you do have it, it will probably be an older version so it would be better to install it outside of anaconda and run:

conda deactivate

if the terminal has conda environment active.

Application

Local setup

To install the application simply run (from the current folder):

cd gstreamer-live-streaming
cmake .
make

which will place the executable file in the folder gstreamer-live-streaming/bin.

To run the application run:

./main

Docker container setup

To install from a clone of this repository

sudo docker build . -t webrtc-streamer:latest

To download from docker hub

docker pull lauramazzuca/webrtc-streamer:latest

Then run it with host network configuration with

sudo docker run --rm --network host -dit webrtc-streamer:latest

Installing the Headless Renderer

Dependencies

For the libraries needed to run locally this application see the Dockerfile.

The host to run the Docker container onto needs to have a NVIDIA GPU and install the NVIDIA Docker toolkit with the following commands:

$ distribution=$(. /etc/os-release;echo $ID$VERSION_ID) \
   && curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add - \
   && curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list
   
$ sudo apt-get update && sudo apt-get install -y nvidia-container-toolkit

$ sudo service docker stop
$ sudo tee /etc/docker/daemon.json <<EOF
{
    "runtimes": {
        "nvidia": {
            "path": "/usr/bin/nvidia-container-runtime",
            "runtimeArgs": []
        }
    },
		"default-runtime": "nvidia"
}
EOF
$ sudo service docker start

Application

Local setup

To install the application locally run:

cd headless-renderer
cmake .
make

then, to run it:

./main

Docker container setup

To install from a clone of this repository

sudo docker build . -t headless-renderer:latest

To download from docker hub

docker pull lauramazzuca/headless-renderer:latest

Then run it with host network configuration with

sudo docker run --rm --network host -dit headless-renderer:latest