Video Streamer User GuideUgCS 213401

Copyright copy 2017 SPH Engineering

ii CONTENTS

Contents

1 Video Streaming Service User Guide 1

11 Configuration in client 1

12 Configuration in the video-service properties file 1

121 Main settings 1

122 Network streams settings 1

123 Video device settings 2

124 Log level 3

125 File path 3

126 Maximum single file size 4

127 For developers 4

13 Examples for video stream configuration 4

131 Examples of supported devices 4

132 Examples of streaming to endpoint 4

133 Examples of broadcasting to web services 6

14 Supported formats and devices 6

2 Disclaimer 6

Copyright copy 2017 SPH Engineering

1 Video Streaming Service User Guide 1

1 Video Streaming Service User Guide

Video streaming service is used to stream the video from a vehicle or other source directly into UgCS

For the video streaming service to work correctly the user needs to configure it in the UgCS Client and also in theconfiguration file To do so please carefully read the instructions below After changing the configuration you mustrestart the Video Service via the Service Manager

11 Configuration in client

You can configure the video service in client ldquoMenurdquo gt ldquoConfigurationrdquo gt ldquoVideordquo By default it points to a localinstance In the case of a multi node deployment network address and port of the Video service can be specified

12 Configuration in the video-service properties file

You can configure the video-service settings in a video configuration file called vstreamerconf It can be found inthe following paths

bull On Microsoft Windows

CProgram FilesUgCSbinvstreamerconf

bull On Mac OS

~LibraryApplication SupportUGCSconfigurationvstreamerconf orUsersusernameLibraryApplication SupportUGCSconfigurationvstreamerconf

bull On GNULinux

etcoptugcsvstreamerconf

The configuration file vstreamerconf has the following sections which will be described below Main settings Net-work streams settings Video device settings Log level File path File Maximum single file size

121 Main settings

Parameter name Default value Descriptionvstreamerserver_port 8081 Http port for the main video

service server This server startsstreaming servers for each deviceStreaming servers run on portsright next to the main server (eg ifthe main server runs on port 8081streaming servers will run on ports8082 8083 etc)

Change this value if port conflictsappear

This port must be as specified inthe settings of the video in theclient

122 Network streams settings

You can also set a number of input network streams which will be re-streamed to the client By default the streamsfor ArDrone and GoPro are configured Feel free to add change or remove streams

Copyright copy 2017 SPH Engineering

2 CONTENTS

Parameter name Default value Descriptionvstreamerinputstream - Example Ardronetcp192168-

11555560640360

Format description

ltNamegtlturlgtltTimeoutgtlt-WidthgtltHeightgt

ltNamegt name of stream as itwill be seen in client

ltUrlgt URL of input networkstream

ltTimeoutgt Parameter isoptional Means time in secondswhile http stream will keep trying toconnect to stream afterdisconnecting and stream namewill appear in list (same as timeoutfor video devices)

ltWidthgt and ltHeightgt imagesize Parameters are optional butmay be needed for some streams

Since version 213 we support Yuneec E50 payloads as well For better performance Yuneec payload config is al-located to distinct parameters group vstreameryuneecstream | - | Example vstreameryuneecstream0=YuneecE90rtsp192168421554live

Format description

ltNamegtlturlgt

ltNamegt name of stream as it will be seen in client

ltUrlgt URL of input network stream

|

Local lowastavi file streaming from VLC is also available You should use a custom MJPEG codec with parametersencapsulation ndash M-JPEG video codec- MJPEG 800Kbs frame rate ndash same as source Specify new video sourcein vstreamerconf

123 Video device settings

By default every video device found is available for streaming You can change this behaviour by changing followingsettings

Copyright copy 2017 SPH Engineering

12 Configuration in the video-service properties file 3

Parameter name Default value Descriptionvstreamervideodevicesautodetect 1 Set audodetecting of video

devices If set to ldquo1rdquo everydetected device will be availablefor streaming except those whichare in deviceexclude list (seebelow) If set to ldquo0rdquo no devices willbe detected and available forstreaming except those which arein deviceallow list (see below)

vstreamervideodevicesexclude - List of device names which mustnot be available for streamingUseful for excluding built-in videodevices By default this list isempty

vstreamervideodevicesallow - List of device names which mustbe available for streaming Ifdevice auto detecting is turned offyou can manually set a list ofdevices available for streamingThe server will try to open thesedevices even if they were not autodetected By default this list isempty

vstreamervideodevicestimeout 10 Timeout in seconds for videodevices Timeout occurs after thesignal from the device is lost or noimage data can be grabbed Afterthis period the device will bedeleted from list of devicesavailable for streaming but it mayappear again if device gives off asignal

124 Log level

Optional

bull Name loglevel = [error|warning|info|debug]

bull Description Logging level

bull Default info

bull Example loglevel = debug

125 File path

Optional

bull Name logfile_path = [path to a file]

bull Description Absolute or relative (to the current directory) path to a logging file Logging is disabled if loggingfile is not defined File should be writable Backslash should be escaped with a backslash

bull Example logfile = varoptugcslogvstreamervstreamerlog

bull Example logfile = Clog

Copyright copy 2017 SPH Engineering

4 CONTENTS

126 Maximum single file size

Optional

bull Name logsingle_max_size = [size]

bull Description Maximum size of a single log file When maximum size is exceeded existing file is renamedby adding a time stamp and logging is continued into the empty file [size] should be defined as a numberpostfixed by a case insensitive multiplier

ndash Gb G Gbyte Gbytes for Giga-bytes

ndash Mb M Mbyte Mbytes for Mega-bytes

ndash Kb K Kbyte Kbytes for Kilo-bytes

ndash no postfix for bytes

bull Default 100 Mb

bull Example logsingle_max_size = 500 Mb

127 For developers

Using the parameter ucsdisable it is possible to connect this VSM directly to the client without using the serverThis parameter is for developers only and should not be changed

13 Examples for video stream configuration

All configurations for described video devices are set by default Be sure that all necessary drivers are installed

131 Examples of supported devices

Video source Configuration properties (vstreamerconf)ArDrone camera vstreamerinputstream0=Ardronetcp19216811-

555560640360GoPro camera vstreamerinputstream1=GoProhttp105-

598080liveambam3u830WebUSB camera Autodetection vstreamervideodevicesautodetect=1

Set manually

vstreamervideodevicesallow0=USB Video Device

vstreamervideodevicesallow1=Webcam

132 Examples of streaming to endpoint

Stream type DescriptionVLS stream 1 To run sample http stream use VLC

2 Add to config file a string like this

vstreamerinputstream2=VLChttp1270-01808030

Copyright copy 2017 SPH Engineering

ii CONTENTS

Contents

1 Video Streaming Service User Guide 1

11 Configuration in client 1

12 Configuration in the video-service properties file 1

121 Main settings 1

122 Network streams settings 1

123 Video device settings 2

124 Log level 3

125 File path 3

126 Maximum single file size 4

127 For developers 4

13 Examples for video stream configuration 4

131 Examples of supported devices 4

132 Examples of streaming to endpoint 4

133 Examples of broadcasting to web services 6

14 Supported formats and devices 6

2 Disclaimer 6

Copyright copy 2017 SPH Engineering

1 Video Streaming Service User Guide 1

1 Video Streaming Service User Guide

Video streaming service is used to stream the video from a vehicle or other source directly into UgCS

For the video streaming service to work correctly the user needs to configure it in the UgCS Client and also in theconfiguration file To do so please carefully read the instructions below After changing the configuration you mustrestart the Video Service via the Service Manager

11 Configuration in client

You can configure the video service in client ldquoMenurdquo gt ldquoConfigurationrdquo gt ldquoVideordquo By default it points to a localinstance In the case of a multi node deployment network address and port of the Video service can be specified

12 Configuration in the video-service properties file

You can configure the video-service settings in a video configuration file called vstreamerconf It can be found inthe following paths

bull On Microsoft Windows

CProgram FilesUgCSbinvstreamerconf

bull On Mac OS

~LibraryApplication SupportUGCSconfigurationvstreamerconf orUsersusernameLibraryApplication SupportUGCSconfigurationvstreamerconf

bull On GNULinux

etcoptugcsvstreamerconf

The configuration file vstreamerconf has the following sections which will be described below Main settings Net-work streams settings Video device settings Log level File path File Maximum single file size

121 Main settings

Parameter name Default value Descriptionvstreamerserver_port 8081 Http port for the main video

service server This server startsstreaming servers for each deviceStreaming servers run on portsright next to the main server (eg ifthe main server runs on port 8081streaming servers will run on ports8082 8083 etc)

Change this value if port conflictsappear

This port must be as specified inthe settings of the video in theclient

122 Network streams settings

You can also set a number of input network streams which will be re-streamed to the client By default the streamsfor ArDrone and GoPro are configured Feel free to add change or remove streams

Copyright copy 2017 SPH Engineering

2 CONTENTS

Parameter name Default value Descriptionvstreamerinputstream - Example Ardronetcp192168-

11555560640360

Format description

ltNamegtlturlgtltTimeoutgtlt-WidthgtltHeightgt

ltNamegt name of stream as itwill be seen in client

ltUrlgt URL of input networkstream

ltTimeoutgt Parameter isoptional Means time in secondswhile http stream will keep trying toconnect to stream afterdisconnecting and stream namewill appear in list (same as timeoutfor video devices)

ltWidthgt and ltHeightgt imagesize Parameters are optional butmay be needed for some streams

Since version 213 we support Yuneec E50 payloads as well For better performance Yuneec payload config is al-located to distinct parameters group vstreameryuneecstream | - | Example vstreameryuneecstream0=YuneecE90rtsp192168421554live

Format description

ltNamegtlturlgt

ltNamegt name of stream as it will be seen in client

ltUrlgt URL of input network stream

|

Local lowastavi file streaming from VLC is also available You should use a custom MJPEG codec with parametersencapsulation ndash M-JPEG video codec- MJPEG 800Kbs frame rate ndash same as source Specify new video sourcein vstreamerconf

123 Video device settings

By default every video device found is available for streaming You can change this behaviour by changing followingsettings

Copyright copy 2017 SPH Engineering

12 Configuration in the video-service properties file 3

Parameter name Default value Descriptionvstreamervideodevicesautodetect 1 Set audodetecting of video

devices If set to ldquo1rdquo everydetected device will be availablefor streaming except those whichare in deviceexclude list (seebelow) If set to ldquo0rdquo no devices willbe detected and available forstreaming except those which arein deviceallow list (see below)

vstreamervideodevicesexclude - List of device names which mustnot be available for streamingUseful for excluding built-in videodevices By default this list isempty

vstreamervideodevicesallow - List of device names which mustbe available for streaming Ifdevice auto detecting is turned offyou can manually set a list ofdevices available for streamingThe server will try to open thesedevices even if they were not autodetected By default this list isempty

vstreamervideodevicestimeout 10 Timeout in seconds for videodevices Timeout occurs after thesignal from the device is lost or noimage data can be grabbed Afterthis period the device will bedeleted from list of devicesavailable for streaming but it mayappear again if device gives off asignal

124 Log level

Optional

bull Name loglevel = [error|warning|info|debug]

bull Description Logging level

bull Default info

bull Example loglevel = debug

125 File path

Optional

bull Name logfile_path = [path to a file]

bull Description Absolute or relative (to the current directory) path to a logging file Logging is disabled if loggingfile is not defined File should be writable Backslash should be escaped with a backslash

bull Example logfile = varoptugcslogvstreamervstreamerlog

bull Example logfile = Clog

Copyright copy 2017 SPH Engineering

4 CONTENTS

126 Maximum single file size

Optional

bull Name logsingle_max_size = [size]

bull Description Maximum size of a single log file When maximum size is exceeded existing file is renamedby adding a time stamp and logging is continued into the empty file [size] should be defined as a numberpostfixed by a case insensitive multiplier

ndash Gb G Gbyte Gbytes for Giga-bytes

ndash Mb M Mbyte Mbytes for Mega-bytes

ndash Kb K Kbyte Kbytes for Kilo-bytes

ndash no postfix for bytes

bull Default 100 Mb

bull Example logsingle_max_size = 500 Mb

127 For developers

Using the parameter ucsdisable it is possible to connect this VSM directly to the client without using the serverThis parameter is for developers only and should not be changed

13 Examples for video stream configuration

All configurations for described video devices are set by default Be sure that all necessary drivers are installed

131 Examples of supported devices

Video source Configuration properties (vstreamerconf)ArDrone camera vstreamerinputstream0=Ardronetcp19216811-

555560640360GoPro camera vstreamerinputstream1=GoProhttp105-

598080liveambam3u830WebUSB camera Autodetection vstreamervideodevicesautodetect=1

Set manually

vstreamervideodevicesallow0=USB Video Device

vstreamervideodevicesallow1=Webcam

132 Examples of streaming to endpoint

Stream type DescriptionVLS stream 1 To run sample http stream use VLC

2 Add to config file a string like this

vstreamerinputstream2=VLChttp1270-01808030

Copyright copy 2017 SPH Engineering

1 Video Streaming Service User Guide 1

1 Video Streaming Service User Guide

Video streaming service is used to stream the video from a vehicle or other source directly into UgCS

For the video streaming service to work correctly the user needs to configure it in the UgCS Client and also in theconfiguration file To do so please carefully read the instructions below After changing the configuration you mustrestart the Video Service via the Service Manager

11 Configuration in client

You can configure the video service in client ldquoMenurdquo gt ldquoConfigurationrdquo gt ldquoVideordquo By default it points to a localinstance In the case of a multi node deployment network address and port of the Video service can be specified

12 Configuration in the video-service properties file

You can configure the video-service settings in a video configuration file called vstreamerconf It can be found inthe following paths

bull On Microsoft Windows

CProgram FilesUgCSbinvstreamerconf

bull On Mac OS

~LibraryApplication SupportUGCSconfigurationvstreamerconf orUsersusernameLibraryApplication SupportUGCSconfigurationvstreamerconf

bull On GNULinux

etcoptugcsvstreamerconf

The configuration file vstreamerconf has the following sections which will be described below Main settings Net-work streams settings Video device settings Log level File path File Maximum single file size

121 Main settings

Parameter name Default value Descriptionvstreamerserver_port 8081 Http port for the main video

service server This server startsstreaming servers for each deviceStreaming servers run on portsright next to the main server (eg ifthe main server runs on port 8081streaming servers will run on ports8082 8083 etc)

Change this value if port conflictsappear

This port must be as specified inthe settings of the video in theclient

122 Network streams settings

You can also set a number of input network streams which will be re-streamed to the client By default the streamsfor ArDrone and GoPro are configured Feel free to add change or remove streams

Copyright copy 2017 SPH Engineering

2 CONTENTS

Parameter name Default value Descriptionvstreamerinputstream - Example Ardronetcp192168-

11555560640360

Format description

ltNamegtlturlgtltTimeoutgtlt-WidthgtltHeightgt

ltNamegt name of stream as itwill be seen in client

ltUrlgt URL of input networkstream

ltTimeoutgt Parameter isoptional Means time in secondswhile http stream will keep trying toconnect to stream afterdisconnecting and stream namewill appear in list (same as timeoutfor video devices)

ltWidthgt and ltHeightgt imagesize Parameters are optional butmay be needed for some streams

Since version 213 we support Yuneec E50 payloads as well For better performance Yuneec payload config is al-located to distinct parameters group vstreameryuneecstream | - | Example vstreameryuneecstream0=YuneecE90rtsp192168421554live

Format description

ltNamegtlturlgt

ltNamegt name of stream as it will be seen in client

ltUrlgt URL of input network stream

|

Local lowastavi file streaming from VLC is also available You should use a custom MJPEG codec with parametersencapsulation ndash M-JPEG video codec- MJPEG 800Kbs frame rate ndash same as source Specify new video sourcein vstreamerconf

123 Video device settings

By default every video device found is available for streaming You can change this behaviour by changing followingsettings

Copyright copy 2017 SPH Engineering

12 Configuration in the video-service properties file 3

Parameter name Default value Descriptionvstreamervideodevicesautodetect 1 Set audodetecting of video

devices If set to ldquo1rdquo everydetected device will be availablefor streaming except those whichare in deviceexclude list (seebelow) If set to ldquo0rdquo no devices willbe detected and available forstreaming except those which arein deviceallow list (see below)

vstreamervideodevicesexclude - List of device names which mustnot be available for streamingUseful for excluding built-in videodevices By default this list isempty

vstreamervideodevicesallow - List of device names which mustbe available for streaming Ifdevice auto detecting is turned offyou can manually set a list ofdevices available for streamingThe server will try to open thesedevices even if they were not autodetected By default this list isempty

vstreamervideodevicestimeout 10 Timeout in seconds for videodevices Timeout occurs after thesignal from the device is lost or noimage data can be grabbed Afterthis period the device will bedeleted from list of devicesavailable for streaming but it mayappear again if device gives off asignal

124 Log level

Optional

bull Name loglevel = [error|warning|info|debug]

bull Description Logging level

bull Default info

bull Example loglevel = debug

125 File path

Optional

bull Name logfile_path = [path to a file]

bull Description Absolute or relative (to the current directory) path to a logging file Logging is disabled if loggingfile is not defined File should be writable Backslash should be escaped with a backslash

bull Example logfile = varoptugcslogvstreamervstreamerlog

bull Example logfile = Clog

Copyright copy 2017 SPH Engineering

4 CONTENTS

126 Maximum single file size

Optional

bull Name logsingle_max_size = [size]

bull Description Maximum size of a single log file When maximum size is exceeded existing file is renamedby adding a time stamp and logging is continued into the empty file [size] should be defined as a numberpostfixed by a case insensitive multiplier

ndash Gb G Gbyte Gbytes for Giga-bytes

ndash Mb M Mbyte Mbytes for Mega-bytes

ndash Kb K Kbyte Kbytes for Kilo-bytes

ndash no postfix for bytes

bull Default 100 Mb

bull Example logsingle_max_size = 500 Mb

127 For developers

Using the parameter ucsdisable it is possible to connect this VSM directly to the client without using the serverThis parameter is for developers only and should not be changed

13 Examples for video stream configuration

All configurations for described video devices are set by default Be sure that all necessary drivers are installed

131 Examples of supported devices

Video source Configuration properties (vstreamerconf)ArDrone camera vstreamerinputstream0=Ardronetcp19216811-

555560640360GoPro camera vstreamerinputstream1=GoProhttp105-

598080liveambam3u830WebUSB camera Autodetection vstreamervideodevicesautodetect=1

Set manually

vstreamervideodevicesallow0=USB Video Device

vstreamervideodevicesallow1=Webcam

132 Examples of streaming to endpoint

Stream type DescriptionVLS stream 1 To run sample http stream use VLC

2 Add to config file a string like this

vstreamerinputstream2=VLChttp1270-01808030

Copyright copy 2017 SPH Engineering

2 CONTENTS

Parameter name Default value Descriptionvstreamerinputstream - Example Ardronetcp192168-

11555560640360

Format description

ltNamegtlturlgtltTimeoutgtlt-WidthgtltHeightgt

ltNamegt name of stream as itwill be seen in client

ltUrlgt URL of input networkstream

ltTimeoutgt Parameter isoptional Means time in secondswhile http stream will keep trying toconnect to stream afterdisconnecting and stream namewill appear in list (same as timeoutfor video devices)

ltWidthgt and ltHeightgt imagesize Parameters are optional butmay be needed for some streams

Since version 213 we support Yuneec E50 payloads as well For better performance Yuneec payload config is al-located to distinct parameters group vstreameryuneecstream | - | Example vstreameryuneecstream0=YuneecE90rtsp192168421554live

Format description

ltNamegtlturlgt

ltNamegt name of stream as it will be seen in client

ltUrlgt URL of input network stream

|

Local lowastavi file streaming from VLC is also available You should use a custom MJPEG codec with parametersencapsulation ndash M-JPEG video codec- MJPEG 800Kbs frame rate ndash same as source Specify new video sourcein vstreamerconf

123 Video device settings

By default every video device found is available for streaming You can change this behaviour by changing followingsettings

Copyright copy 2017 SPH Engineering

12 Configuration in the video-service properties file 3

Parameter name Default value Descriptionvstreamervideodevicesautodetect 1 Set audodetecting of video

devices If set to ldquo1rdquo everydetected device will be availablefor streaming except those whichare in deviceexclude list (seebelow) If set to ldquo0rdquo no devices willbe detected and available forstreaming except those which arein deviceallow list (see below)

vstreamervideodevicesexclude - List of device names which mustnot be available for streamingUseful for excluding built-in videodevices By default this list isempty

vstreamervideodevicesallow - List of device names which mustbe available for streaming Ifdevice auto detecting is turned offyou can manually set a list ofdevices available for streamingThe server will try to open thesedevices even if they were not autodetected By default this list isempty

vstreamervideodevicestimeout 10 Timeout in seconds for videodevices Timeout occurs after thesignal from the device is lost or noimage data can be grabbed Afterthis period the device will bedeleted from list of devicesavailable for streaming but it mayappear again if device gives off asignal

124 Log level

Optional

bull Name loglevel = [error|warning|info|debug]

bull Description Logging level

bull Default info

bull Example loglevel = debug

125 File path

Optional

bull Name logfile_path = [path to a file]

bull Description Absolute or relative (to the current directory) path to a logging file Logging is disabled if loggingfile is not defined File should be writable Backslash should be escaped with a backslash

bull Example logfile = varoptugcslogvstreamervstreamerlog

bull Example logfile = Clog

Copyright copy 2017 SPH Engineering

4 CONTENTS

126 Maximum single file size

Optional

bull Name logsingle_max_size = [size]

bull Description Maximum size of a single log file When maximum size is exceeded existing file is renamedby adding a time stamp and logging is continued into the empty file [size] should be defined as a numberpostfixed by a case insensitive multiplier

ndash Gb G Gbyte Gbytes for Giga-bytes

ndash Mb M Mbyte Mbytes for Mega-bytes

ndash Kb K Kbyte Kbytes for Kilo-bytes

ndash no postfix for bytes

bull Default 100 Mb

bull Example logsingle_max_size = 500 Mb

127 For developers

Using the parameter ucsdisable it is possible to connect this VSM directly to the client without using the serverThis parameter is for developers only and should not be changed

13 Examples for video stream configuration

All configurations for described video devices are set by default Be sure that all necessary drivers are installed

131 Examples of supported devices

Video source Configuration properties (vstreamerconf)ArDrone camera vstreamerinputstream0=Ardronetcp19216811-

555560640360GoPro camera vstreamerinputstream1=GoProhttp105-

598080liveambam3u830WebUSB camera Autodetection vstreamervideodevicesautodetect=1

Set manually

vstreamervideodevicesallow0=USB Video Device

vstreamervideodevicesallow1=Webcam

132 Examples of streaming to endpoint

Stream type DescriptionVLS stream 1 To run sample http stream use VLC

2 Add to config file a string like this

vstreamerinputstream2=VLChttp1270-01808030

Copyright copy 2017 SPH Engineering

12 Configuration in the video-service properties file 3

Parameter name Default value Descriptionvstreamervideodevicesautodetect 1 Set audodetecting of video

devices If set to ldquo1rdquo everydetected device will be availablefor streaming except those whichare in deviceexclude list (seebelow) If set to ldquo0rdquo no devices willbe detected and available forstreaming except those which arein deviceallow list (see below)

vstreamervideodevicesexclude - List of device names which mustnot be available for streamingUseful for excluding built-in videodevices By default this list isempty

vstreamervideodevicesallow - List of device names which mustbe available for streaming Ifdevice auto detecting is turned offyou can manually set a list ofdevices available for streamingThe server will try to open thesedevices even if they were not autodetected By default this list isempty

vstreamervideodevicestimeout 10 Timeout in seconds for videodevices Timeout occurs after thesignal from the device is lost or noimage data can be grabbed Afterthis period the device will bedeleted from list of devicesavailable for streaming but it mayappear again if device gives off asignal

124 Log level

Optional

bull Name loglevel = [error|warning|info|debug]

bull Description Logging level

bull Default info

bull Example loglevel = debug

125 File path

Optional

bull Name logfile_path = [path to a file]

bull Description Absolute or relative (to the current directory) path to a logging file Logging is disabled if loggingfile is not defined File should be writable Backslash should be escaped with a backslash

bull Example logfile = varoptugcslogvstreamervstreamerlog

bull Example logfile = Clog

Copyright copy 2017 SPH Engineering

4 CONTENTS

126 Maximum single file size

Optional

bull Name logsingle_max_size = [size]

bull Description Maximum size of a single log file When maximum size is exceeded existing file is renamedby adding a time stamp and logging is continued into the empty file [size] should be defined as a numberpostfixed by a case insensitive multiplier

ndash Gb G Gbyte Gbytes for Giga-bytes

ndash Mb M Mbyte Mbytes for Mega-bytes

ndash Kb K Kbyte Kbytes for Kilo-bytes

ndash no postfix for bytes

bull Default 100 Mb

bull Example logsingle_max_size = 500 Mb

127 For developers

Using the parameter ucsdisable it is possible to connect this VSM directly to the client without using the serverThis parameter is for developers only and should not be changed

13 Examples for video stream configuration

All configurations for described video devices are set by default Be sure that all necessary drivers are installed

131 Examples of supported devices

Video source Configuration properties (vstreamerconf)ArDrone camera vstreamerinputstream0=Ardronetcp19216811-

555560640360GoPro camera vstreamerinputstream1=GoProhttp105-

598080liveambam3u830WebUSB camera Autodetection vstreamervideodevicesautodetect=1

Set manually

vstreamervideodevicesallow0=USB Video Device

vstreamervideodevicesallow1=Webcam

132 Examples of streaming to endpoint

Stream type DescriptionVLS stream 1 To run sample http stream use VLC

2 Add to config file a string like this

vstreamerinputstream2=VLChttp1270-01808030

Copyright copy 2017 SPH Engineering

4 CONTENTS

126 Maximum single file size

Optional

bull Name logsingle_max_size = [size]

bull Description Maximum size of a single log file When maximum size is exceeded existing file is renamedby adding a time stamp and logging is continued into the empty file [size] should be defined as a numberpostfixed by a case insensitive multiplier

ndash Gb G Gbyte Gbytes for Giga-bytes

ndash Mb M Mbyte Mbytes for Mega-bytes

ndash Kb K Kbyte Kbytes for Kilo-bytes

ndash no postfix for bytes

bull Default 100 Mb

bull Example logsingle_max_size = 500 Mb

127 For developers

Using the parameter ucsdisable it is possible to connect this VSM directly to the client without using the serverThis parameter is for developers only and should not be changed

13 Examples for video stream configuration

All configurations for described video devices are set by default Be sure that all necessary drivers are installed

131 Examples of supported devices

Video source Configuration properties (vstreamerconf)ArDrone camera vstreamerinputstream0=Ardronetcp19216811-

555560640360GoPro camera vstreamerinputstream1=GoProhttp105-

598080liveambam3u830WebUSB camera Autodetection vstreamervideodevicesautodetect=1

Set manually

vstreamervideodevicesallow0=USB Video Device

vstreamervideodevicesallow1=Webcam

132 Examples of streaming to endpoint

Stream type DescriptionVLS stream 1 To run sample http stream use VLC

2 Add to config file a string like this

vstreamerinputstream2=VLChttp1270-01808030

Copyright copy 2017 SPH Engineering

13 Examples for video stream configuration 5

UDP Stream (H264) 1 To run sample UDP Stream use ffmpeg

ldquoffmpeg -f dshow -i video=USB Video Device-vcodec libx264

-tune zerolatency -b 900k -f mpegtsudp1270011234rdquo

2 Add to config file string like this

vstreamerinputstream2=UDP_Stream_Nameudp-127001123460

RTP Stream (H264) 1 To run sample RTP Stream use ffmpeg

ldquoffmpeg -f dshow -i video=USB Video Device-vcodec libx264

-tune zerolatency -b 900k -f rtp rtp1270011234rdquo

2 To read from this stream you need create a sdpfile which describes the stream So create a testsdpfile

v=0

o=- 0 0 IN IP4 127001

s=No Name

c=IN IP4 127001

t=0 0

a=toollibavformat 561100

m=video 1234 RTPAVP 96

b=AS900

a=rtpmap96 H26490000

a=fmtp96 packetization-mode=1

3 Add to config file string with path to sdp like that

vstreamerinputstream2=RTP_Stream_Namec-testsdp

Copyright copy 2017 SPH Engineering

6 CONTENTS

RTSP Stream (H264) 1 We checked this stream withan online sample

rtsp18472239149vodmp4BigBuckBunny_115k-mov

2Add to config file string like this

ldquovstreamerinputstream2=RTSP_Stream_Name

rtsp18472239149vodmp4BigBuckBunny_115k-movrdquo

133 Examples of broadcasting to web services

After having correctly working video source you can stream to web services by using share button in video controlof UgCS client Supported services are Twitch Youtube and Ustream

Stream type DescriptionUstream 1 Register at httpwwwustreamtv

2 Create channel

3 Visit channel Broadcast settings and open Encodersetting

There you can find RTMP URL Now you have URLfor streaming looked like RTMP URLStream key

4 Put that URL in Ustream input box of UgCS videocontrol and press OK

5 Check your channel on UstreamYoutube To be implementedTwitch To be implemented

14 Supported formats and devices

List of supported

bull video codecs - httpswwwffmpegorggeneralhtmlVideo-Codecs

bull protocols - httpswwwffmpegorggeneralhtmlNetwork-Protocols

bull IO devices - httpswwwffmpegorggeneralhtmlInput_002fOutput-Devices

2 Disclaimer

DISCLAIMER OF WARRANTIES AND LIMITATIONS ON LIABILITY

(a) SPH ENGINEERING MAKE NO REPRESENTATIONS OR WARRANTIES REGARDING THE ACCURACY ORCOMPLETENESS OF ANY CONTENT OR FUNCTIONALITY OF THE PRODUCT AND ITS DOCUMENTATION

(b) SPH ENGINEERING DISCLAIM ALL WARRANTIES IN CONNECTION WITH THE PRODUCT AND WILL NOTBE LIABLE FOR ANY DAMAGE OR LOSS RESULTING FROM YOUR USE OF THE PRODUCT INCLUDING BUTNOT LIMITED TO INJURY OR DEATH OF USER OR ANY THIRD PERSONS OR DAMAGE TO PROPERTY

(c) THE SOFTWARE IS SUPPLIED AS IS WITH NO WARRANTIES AND CAN BE USED ONLY AT USERS OWNRISK

Copyright copy 2017 SPH Engineering

6 CONTENTS

RTSP Stream (H264) 1 We checked this stream withan online sample

rtsp18472239149vodmp4BigBuckBunny_115k-mov

2Add to config file string like this

ldquovstreamerinputstream2=RTSP_Stream_Name

rtsp18472239149vodmp4BigBuckBunny_115k-movrdquo

133 Examples of broadcasting to web services

After having correctly working video source you can stream to web services by using share button in video controlof UgCS client Supported services are Twitch Youtube and Ustream

Stream type DescriptionUstream 1 Register at httpwwwustreamtv

2 Create channel

3 Visit channel Broadcast settings and open Encodersetting

There you can find RTMP URL Now you have URLfor streaming looked like RTMP URLStream key

4 Put that URL in Ustream input box of UgCS videocontrol and press OK

5 Check your channel on UstreamYoutube To be implementedTwitch To be implemented

14 Supported formats and devices

List of supported

bull video codecs - httpswwwffmpegorggeneralhtmlVideo-Codecs

bull protocols - httpswwwffmpegorggeneralhtmlNetwork-Protocols

bull IO devices - httpswwwffmpegorggeneralhtmlInput_002fOutput-Devices

2 Disclaimer

DISCLAIMER OF WARRANTIES AND LIMITATIONS ON LIABILITY

(a) SPH ENGINEERING MAKE NO REPRESENTATIONS OR WARRANTIES REGARDING THE ACCURACY ORCOMPLETENESS OF ANY CONTENT OR FUNCTIONALITY OF THE PRODUCT AND ITS DOCUMENTATION

(b) SPH ENGINEERING DISCLAIM ALL WARRANTIES IN CONNECTION WITH THE PRODUCT AND WILL NOTBE LIABLE FOR ANY DAMAGE OR LOSS RESULTING FROM YOUR USE OF THE PRODUCT INCLUDING BUTNOT LIMITED TO INJURY OR DEATH OF USER OR ANY THIRD PERSONS OR DAMAGE TO PROPERTY

(c) THE SOFTWARE IS SUPPLIED AS IS WITH NO WARRANTIES AND CAN BE USED ONLY AT USERS OWNRISK

Copyright copy 2017 SPH Engineering