org.agent.slang.in.videoconferencing

Class VCStreamer

java.lang.Object

SourceComponent

org.agent.slang.in.videoconferencing.VCStreamer

public class VCStreamer
extends SourceComponent

This component enables to stream a webcam and a microphone to other machines. Using it requires the installation of GStreamer in its 1.x series (preferably a "complete" installation).

Basic functionality

To stream the multimedia data to other machines, the "targets" parameter should contain a semi-column-separated list of hostname:port elements.

Each hostname should be either an IP address or a machine defined in the configuration for CNService.

As it is currently implemented, streaming does not use just one port but six per "target": not only port but also port + {1, 2, 3, 5, 7} should be available on the target machine.

Each target machine should in turn run a VCDisplay component with the basePort parameter set to the chosen port.

IP Camera Simulation

So as to keep the camera available to other software (most notably FaceReader), this component is capable of simulating an IP camera.

Two parameters must be used if this feature is needed: ipcamerafrom, which must be an available local port but otherwise bears no impact, and ipcamerato, which defines the port on which the camera will be available.

For example, if ipcamerato is set to 4001, the camera can be seen in an MJPEG-compatible client (such as VLC, QuickTime Player, Firefox, Safari or Chrome) at http://localhost:4001/.

Saving to a file

Finally, the multimedia streams can be saved to an MKV file by setting the saveTo parameter to the desired location. The video stream will be encoded using H.264 and the audio stream using Opus. OS Compatibility: Windows and Linux

Version:

1, 4/16/15, 2, 22/05/2017

Author:

Sami Boukortt, sami.boukortt@insa-rouen.fr, Sahba Zojaji, sahba.zojaji@insa-rouen.fr

Constructor Summary

Constructors

Constructor and Description
VCStreamer(java.lang.String outboundPort, ComponentConfig config)

Method Summary

Modifier and Type	Method and Description
void	close() Closes connection and stops streaming user's webcam video and audio on http port.
void	definePublishedData() Checking type of output data.
static java.lang.Process	startWithExecutableExtension(java.lang.ProcessBuilder pb) Starts a process for running gstreamer with predefined configuration.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

VCStreamer

public VCStreamer(java.lang.String outboundPort,
                  ComponentConfig config)

Method Detail

definePublishedData

public void definePublishedData()

Checking type of output data.

close

public void close()

Closes connection and stops streaming user's webcam video and audio on http port.

startWithExecutableExtension

public static java.lang.Process startWithExecutableExtension(java.lang.ProcessBuilder pb)
                                                      throws java.io.IOException

Starts a process for running gstreamer with predefined configuration.

Parameters:

pb - Process Builder to run gstreamer

Returns:

process

Throws:

java.io.IOException - IO exception