CVH-Camera

The CVH-Camera project provides a way to share one or multiple camera views using the Janus WebRTC gateway. It is designed to be used with the PULT project available at https://gitlab.cvh-server.de/pgerwinski/pult.

Note that the project and its documentation are still in development.

In this documentation clients that publish a feed will be referred to as senders and clients who receive a feed will be referred to as receivers or viewers.

Camera Server

CVH-Camera uses a Nodejs server with the socket.io library to send events regarding the camera feeds out to the receivers in realtime. The socket connection is also used to verify feeds that are published in the Janus rooms and only send those to the receivers. This way no unwanted feeds can be shown to the receivers while still having a public password for the Janus room itself.

One instance of the camera server is meant to manage one Janus room. It does this by defining slots for cameras which are all disabled by default. To activate a slot, one has to provide a token for that slot. This token will be required to be able to send a feed on that slot. As mentioned above, only feeds that are verified in that way are shown to the receivers. One can also refresh the token for a given slot or simply deactivate it.

Compiling and Running the Server

The camera server is written in typescript, a superset of javascript. That means that is has to be compiled before being able to start. To compile the code, install the typescript compiler using npm npm install -g typescript or apt apt install node-typescript. Navigate into the camera-server folder and run tsc. This will compile the files into a newly created folder dist.

Once the code is compiled, the server can be started with node server.js in the dist folder.

Config

The camera server can read a path to a config file from the CONFIG_PATH environment variable. This config file has to be in the json format and should have this structure.

Below is a description of the config file's properties:

• port: The port on which the server will listen. Defaults to 5000.

• cameraSlots: The camera slots available for this room. Defaults to 4.

Stdin-Interface

The camera server is controlled by PULT via its stdin. One could also implement the interface in any other program to manage the CVH-Camera.

For the syntax of the commands the following convention is used in this documentation:

• <param> is a parameter that is required.

• <a | b> is a parameter that is required and has to hold either the value a or b.

• [param] is a parameter that is optional

This is the list of the available commands:

Slot Control Commands

Camera Control Commands

These commands are designed to work well with the PULT project and thus with noVNC, a VNC web client.

The current state of the camera feeds is saved in the server's memory and will be applied to new viewers.

Socket Traffic

This section describes the socket traffic and the socket.io events that are used.

Sender

When the sender side expects an answer to a request, a callback can be passed to the emit function. The server can then take that function as a parameter of the handler and call it with the response. Below you can see an abstract example of the described technique.

// Client
socket.emit('sender_init', 'Some data', function(responseData) {
    console.log(responseData); // Should log 'Some answer'
});

// Server
socket.on('sender_init', function(data, fn) {
    console.log(data); // Should log 'Some data'
    fn('Some answer');
});

Server responses to request will always include the following fields:

• success: A boolean that indicates, whether the request was successful or not.

• message: A string that holds a user-friendly text to display. Holds the message of the error if one occurred.

In order to authenticate itself, the sender has to provide a slot and a token by emitting a sender_init event. These values are provided through the query string of the sender web page. When the server receives the sender_init event it validates the slot and the token and sends a response.

After a successful initialisation the connectin to janus is established. When the camera is shared, the id of the transmitted Janus feed is determined and then sent to the server using the set_feed_id event. On the server the corresponding slot will save that feed id. This will then be used to tell all receivers which feed id to attach to.

When the sender socket disconnects, an event will be emitted, notifying the receivers to remove the corresponding feed.