bitcontrol® Video Streaming Server (bcVSS)

bitcontrol® Video Streaming Server (bcVSS)
bitcontrol® Video
Streaming Server (bcVSS)
User manual
Version 3.8
Copyright © 2014
BitCtrl Systems GmbH
bitcontrol® Video Streaming
Server (bcVSS)
User manual
bitcontrol® Video Streaming Server (bcVSS)
User manual
Version 3.8
Copyright © 2014 BitCtrl Systems GmbH
bitcontrol® Video Streaming
Server (bcVSS)
User manual
bitcontrol® Video
Streaming Server (bcVSS)
Table of Contents
BitCtrl information ..................................................................................................................... vii
1. Copyright ...................................................................................................................... vii
2. Liability ......................................................................................................................... vii
Release levels ......................................................................................................................... viii
Glossary .................................................................................................................................... 1
1. Introduction ............................................................................................................................ 3
2. Login /Logout ........................................................................................................................ 6
3. User interface (general) .......................................................................................................... 8
3.1. User interface elements ............................................................................................... 8
3.1.1. Structuring elements ......................................................................................... 8
3.1.1.1. Views .................................................................................................... 9
3.1.1.2. Perspective ............................................................................................ 9
3.1.2. Controlling elements ......................................................................................... 9
3.1.2.1. Menus ................................................................................................. 10
3.1.2.2. Function bars ....................................................................................... 10
3.1.2.3. Perspective bar .................................................................................... 10
3.1.2.4. Wizards ............................................................................................... 10
3.1.2.5. Dialogues ............................................................................................ 10
4. Media .................................................................................................................................. 11
4.1. Function bar .............................................................................................................. 11
4.1.1. Change configuration ...................................................................................... 11
4.1.1.1. Common preferences ........................................................................... 11
4.1.1.2. Console color preferences .................................................................... 13
4.1.1.3. Lable decoration .................................................................................. 13
4.1.1.4. License management and statistic ......................................................... 15
4.1.1.5. Keyboard driver preferences (fast access via hot keys) ........................... 16
4.1.1.6. WSDL server properties ....................................................................... 18
4.1.2. Import ............................................................................................................ 19
4.1.3. Export ............................................................................................................ 20
4.1.4. Keyboard driver preferences view .................................................................... 22
4.1.5. Create / add Media Application ....................................................................... 22
4.1.6. Delete Media Application ................................................................................. 25
4.1.7. Start Media Application ................................................................................... 26
4.1.8. Stop Media Application ................................................................................... 26
4.1.9. Switch channel (Open channel keyboard parameter) ......................................... 26
4.1.10. About bitcontrol® Video Streaming Server ...................................................... 27
5. Media Application ................................................................................................................. 29
5.1. Media Application context menus ............................................................................... 29
5.2. Adding plug-ins ......................................................................................................... 30
5.2.1. Plug-in selection notes .................................................................................... 30
5.2.2. Media Application overview ............................................................................. 31
5.2.3. Adding plug-in procedure ................................................................................ 32
5.2.4. Plug-in context menu ...................................................................................... 32
5.3. Add / Edit Scenario .................................................................................................... 33
5.4. Create new script ...................................................................................................... 36
5.5. Application wizard ...................................................................................................... 36
5.6. Create Samples ......................................................................................................... 36
iii
bitcontrol® Video Streaming
Server (bcVSS)
User manual
bitcontrol® Video
Streaming Server (bcVSS)
6. Plug-in Axis ......................................................................................................................... 37
6.1. Add plug-in / edit properties ....................................................................................... 37
6.2. Parameterise event detection for Axis cameras ........................................................... 41
7. Plug-in BDA ......................................................................................................................... 42
7.1. BDA properties .......................................................................................................... 42
7.2. Setup of a Media Application with the BDA plug-in ...................................................... 43
8. Plug-in Bosch VIP X ............................................................................................................. 46
8.1. Add plug-in / edit properties ....................................................................................... 46
9. Plug-in Capture .................................................................................................................... 48
9.1. Add plug-in / edit properties ....................................................................................... 48
10. Set Top Box plug-ins .......................................................................................................... 52
10.1. Add plug-in / Edit properties ..................................................................................... 52
10.2. Switch channel (Open channel keyboard parameter) .................................................. 53
11. Plug-in Colored frame ......................................................................................................... 54
12. Plug-in File ......................................................................................................................... 55
13. Plug-in Console .................................................................................................................. 57
14. Plug-in Multistream Server .................................................................................................. 59
14.1. Add plug-in / edit properties ...................................................................................... 59
14.2. Multistream Server Media Sessions .......................................................................... 62
14.3. Multistream Server user management ....................................................................... 70
15. Plug-in NetPublisher .......................................................................................................... 72
16. Plug-in Recorder ................................................................................................................ 74
16.1. Add plug-in / edit properties ...................................................................................... 74
17. Plug-in RTSP Receiver ....................................................................................................... 77
18. Plug-in Traficon Vip-T ......................................................................................................... 79
18.1. Add plug-in / edit properties ...................................................................................... 79
19. Transcoder ......................................................................................................................... 82
20. Scripting ............................................................................................................................. 88
20.1. Managing scripts inside the media navigator ............................................................. 88
20.2. Edit scripts in the editor view .................................................................................... 91
20.3. bcVSS scripting basics ............................................................................................. 92
20.3.1. Samples ....................................................................................................... 93
21. User administration ............................................................................................................. 96
21.1. User administration perspective context menu ........................................................... 96
21.2. User groups ............................................................................................................ 96
21.3. User ........................................................................................................................ 96
21.3.1. Add / edit user .............................................................................................. 97
21.3.2. User contect menu ........................................................................................ 98
22. Logger ............................................................................................................................... 99
22.1. Logger perspective context menu ........................................................................... 100
22.2. Message filter ........................................................................................................ 100
22.3. Level filter ............................................................................................................. 100
23. Documentation ................................................................................................................. 102
iv
bitcontrol® Video Streaming
Server (bcVSS)
User manual
bitcontrol® Video
Streaming Server (bcVSS)
List of Figures
1.1. bitcontrol® Video Streaming Server overview ........................................................................ 5
2.1. bitcontrol® Video Streaming Server - tray icon ...................................................................... 6
2.2. bitcontrol® Video Streaming Server login dialogue ............................................................... 7
2.3. Note no valid bitcontrol® Video Streaming Server license ...................................................... 7
3.1. bitcontrol® Video Streaming Server user interface ................................................................. 8
3.2. bitcontrol® Video Streaming Server perspective bar ............................................................ 10
4.1. Window Common preferences ............................................................................................ 12
4.2. Window Console color preferences ..................................................................................... 13
4.3. Window Lable decoration ................................................................................................... 14
4.4. Window License management ............................................................................................ 15
4.5. Window License statistic .................................................................................................... 16
4.6. Window Keyboard driver preferences ................................................................................. 17
4.7. Hot key list ........................................................................................................................ 18
4.8. Window WSDL server properties ........................................................................................ 19
4.9. Import selection Media Application or script ........................................................................ 20
4.10. Import a bcVSS configuration ........................................................................................... 20
4.11. Export selection Media Application or script ....................................................................... 21
4.12. Export note ..................................................................................................................... 21
4.13. Exported bcVSS configuration .......................................................................................... 22
4.14. Create / add a new Media Application ............................................................................... 23
4.15. Selectable video formats .................................................................................................. 24
4.16. Selectable audio formats .................................................................................................. 24
4.17. bitcontrol® Audio Video Decoder attributes ....................................................................... 25
4.18. Note before Media Application deletion ............................................................................. 26
4.19. About bitcontrol® Video Streaming Server ........................................................................ 27
4.20. Version information of plug-ins ......................................................................................... 28
5.1. Wizard for adding Media Application plug-in ........................................................................ 32
5.2. Dialogue - Name and description of a scenario ................................................................... 34
5.3. Selection of Media Application and respective procedure ..................................................... 34
5.4. 1st dialogue of Application wizard ...................................................................................... 36
6.1. Network address of the Axis camera .................................................................................. 37
6.2. Axis camera selection ........................................................................................................ 38
6.3. Properties of Axis plug-in ................................................................................................... 38
6.4. Axis specific properties of Axis plug-in ................................................................................ 40
7.1. BDA plug-in configuration .................................................................................................. 42
7.2. Channel scan assistant for BDA devices ............................................................................. 44
7.3. Gefundene Kanäle ............................................................................................................. 44
7.4. Apply channels .................................................................................................................. 45
7.5. Switch channel dialogue of the BDA plug-in ........................................................................ 45
8.1. Plug-in Bosch VIP X .......................................................................................................... 46
8.2. PTZ properties of the Bosch VIP X plug-in .......................................................................... 47
9.1. Properties of the Capture plug-in ........................................................................................ 48
9.2. Dialogue for the selection of the fade in picture ................................................................... 49
9.3. Selected logo picture in a video (example) .......................................................................... 49
9.4. Set fade-in (text, time and/or date) ..................................................................................... 50
10.1. Plug-in Dreambox properties ............................................................................................ 52
10.2. Switch channel ................................................................................................................ 53
v
bitcontrol® Video Streaming
Server (bcVSS)
User manual
bitcontrol® Video
Streaming Server (bcVSS)
11.1. Plug-in Colored frame ...................................................................................................... 54
12.1. Plug-in File ...................................................................................................................... 55
12.2. File selection dialogue ..................................................................................................... 56
13.1. Plug-in Console ............................................................................................................... 57
13.2. Console example in a running Media Application .............................................................. 58
14.1. Multistream Server wizard ................................................................................................ 59
14.2. Multistream Server Assistent - Timeout ............................................................................. 60
14.3. Timeout relations ............................................................................................................. 61
14.4. Multistream Server wizard - IP address filter ..................................................................... 61
14.5. Multistream Server wizard - preconfiguration ..................................................................... 62
14.6. Media Session selection via Multistream Server context menus .......................................... 62
14.7. Common properties of a Media Sessions .......................................................................... 63
14.8. URL Path ........................................................................................................................ 63
14.9. Media Sessions user groups ............................................................................................ 64
14.10. General properties of a Media Session ........................................................................... 64
14.11. Allowed IP Address Ranges of the Media Session ........................................................... 65
14.12. Denied IP Address Ranges of the Media Session ........................................................... 65
14.13. Specific adjustments for HTTP Ctrl Media Session ........................................................... 66
14.14. Specific adjustments for HTTP File Media Session .......................................................... 67
14.15. Specific adjustments for HTTP Live Media Session .......................................................... 67
14.16. Specific adjustments for RTMP Live Media Session / RTMP Rec Media Session / RTMP
VideoOnDemand Media Session ............................................................................................... 68
14.17. Specific adjustments for RTSP Live Media Session .......................................................... 69
14.18. Specific adjustments for Net Receiver Media Session ...................................................... 70
14.19. Multistream Server user group wizard ............................................................................. 71
15.1. Interaction of NetPublisher and Net Receiver Media Session ............................................. 72
15.2. Plug-in NetPublisher configuration dialogue ....................................................................... 72
16.1. Plug-in Recorder .............................................................................................................. 74
17.1. RTSP Receiver plug-in wizard .......................................................................................... 77
18.1. Network address of the Traficon Vip-T device ................................................................... 79
18.2. Further properties of the Traficon Vip-T plug-in .................................................................. 80
19.1. Transcoder declaration for Media Application .................................................................... 82
19.2. Create a transcoder - XML configuration ........................................................................... 84
20.1. Script object in the media navigator .................................................................................. 88
20.2. Wizard to create a new script ........................................................................................... 89
20.3. Script object context menu ............................................................................................... 90
20.4. Execution of a script object via media navigator ................................................................ 91
20.5. Script editor ..................................................................................................................... 92
20.6. Toolbar actions of the script editor view ............................................................................ 92
21.1. Add user / Edit user data ................................................................................................. 97
21.2. Example - Added user ..................................................................................................... 97
22.1. Log messages in tree view .............................................................................................. 99
22.2. Example - Search for the term DTVLink* ......................................................................... 100
22.3. Message selection by messge type ................................................................................ 100
22.4. Selection by search term and message type ................................................................... 101
23.1. HTML version of the bcVSS user manual (detail) ............................................................. 102
vi
bitcontrol® Video Streaming
Server (bcVSS)
User manual
BitCtrl information
BitCtrl information
1. Copyright
The software and its documentation are property of BitCtrl Systems GmbH and are, when used,
subjected to the license agreement held between the end-user/customer and BitCtrl Systems GmbH.
Any form of copying, lending or sale of the software and documentation from the end-user to a third
party is strictly forbidden.
The documentation reflects the present development stage of the software and its documentation. If
you should come across any errors or unclear passages in the documentation please contact:
BitCtrl Systems GmbH
Weißenfelser Str. 67
04229 Leipzig, Germany
Tel. +49-341-490670
Fax +49-341-4906715
E-Mail: <info@bitctrl.de>
bitcontrol® and BitCtrl Systems® are registered trademarks of the company BitCtrl Systems GmbH,
Leipzig 2004-2013.
All other names and trade marks are the property of their respective owners.
2. Liability
BitCtrl Systems GmbH (referred to as BitCtrl in the following) will not accept liability (whether specifically
or implicitly) for the software and its components. This includes any claims regarding usage and
suitability of the software for a specific purpose. BitCtrl will in no way accept liability for coincidental,
indirect or consequential damage resulting from misuse or correct usage of the software. This also
applies should BitCtrl be informed prior to this of such possible damage.
The general terms of business for BitCtrl Systems GmbH will apply. Rights to change software and
documentation accrued through technical advancements are reserved.
vii
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Release levels
Release levels
Date
Version
Description
Author
01.06.2007 1.0
Document created
Winter
01.09.2007 1.1
Document - Update
Winter
31.03.2008 2.0
New: Layout, structure, further features (e.g. help in HTML, Winter
configuration), license management for bcDTVLink
17.10.2008 3.0 (beta)
New: Update to Eclipse/Rich Ajax Application (version 1.1) Winter
platform
23.01.2009 3.1
Update for BcVSS 3.1
Winter
20.02.2009 3.1
Adaption to BcVSS 3.1
Hösel
04.11.2009 3.1.7
Documentation update
Winter
Juni 2011
3.5
Documentation update
Winter
July 2012
3.8
Complete documentaion revision according to bcVSS version Winter
3.8.0
May 2013
3.8
bcVSS version 3.8.2 / chapters 5.4 upt to 5.6 added
viii
Winter
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Glossary
Glossary
AJAX
Asynchronous JavaScript and XML
API
Application Programming Interface
bcmsdb
bitcontrol® Streaming Protocol (HTTP – Subset)
Codec
Program part for coding and/or decoding
DCT
Discrete Cosine Transformation
DVB
Digital Video Broadcast (C – Cable, S – Satellite, T – Terrestrial)
DVD
Digital Versatile Disk
DXVA
DirectX® Video Acceleration – a DirectX® API to use the hardware
acceleration of the graphic chip for specific tasks, e.g. for DCT
calculation
EPG
Electronic Program Guide
fps
Frames per second
HDTV
High Definition Television
HTML
Hypertext Markup Language
HTPC
Home Theater PC
IDCT
Inverse Discrete Cosinus Transformation
IP
Internet Protocol
JDK
Java Development Kit
JSP
Java Server Pages
MMX#
Multi Media Extension
MPEG
Motion Picture Expert Group
Multicast
Data transmission from one sender to a receiver group
OSD
On Screen Display
PES
Encapsulated packetised elementary video streams, which are packed
into the HTTP protocol
px
Pixel
SDK
Software Development Kit
1
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Glossary
SSE
Streaming SIMD Extension
STB
Set Top Box – Device for the reception of digital TV (DVB-C/S/T)
Unicast
Data transmission from one sender to one receiver
URL
Uniform Resource Locator (common: Internet Addresse)
WMV
Windows Media® Video
XML
Extensible Markup Language
2
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 1. Introduction
Chapter 1. Introduction
With the help of the bitcontrol® Video Streaming Server (bcVSS) it is possible to play back any video
from various input sources or make them available to other applications.
Possible usage scenarios are:
• Integration of video display in interfaces of third party applications,
• Supply of video streams for use by different display devices (e.g. PC monitor, large scale screens),
• Network streaming,
• Storage of video data for later analysis,
• ...
Additionally, the handling of various bitcontrol® multimedia products (e.g. bitcontrol® Audio Video
Decoder and Digital TV Linkbitcontrol® Digital TV Link) on a system becomes much easier. All important
and necessary configurations can be done at one central location, the bitcontrol® Video Streaming
Server.
All of these can be used as video stream sources:
Sources like
• Streaming output (Multicast/Unicast) of another bitcontrol® Digital TV Link
• Encoder devices (e.g. Bosch VIP X1, Traficon VIP-T)
• Encoder cards (with Kfir-Chip and others)
• Capture devices (e.g. webcams)
• Cameras (e.g. Axis)
• Geutebrück GeViScope
• BDA devices (e.g. TV sticks or PCI TV cards)
• SetTop Boxes (e.g. Dreambox, DBox2, ReelBox)
The bitcontrol® Digital TV Link handles different input formats depending on the video source:
• PES
• TS
• RTP/H.263
• RTSP/RTP MPEG-4
3
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 1. Introduction
• bcmsdb (Unicast / Multicast)
• *.mpg File (m1v, m2v, m2p, mpa, mpeg, mp2)
• *.vob File
• *.ts File
• *.avi File (MPEG-4 part 2)
• *.mp4 (in part DivX)
The following output formats are supported:
• NV12 for DXVA 2.0
• RGB24
• RGB32
• RGB555
• RGB565
• UYVY
• YUY2
• YV1
• YUY2
• YV1
• YVYU
The bitcontrol® Digital TV Link is able to transmit an incoming TV stream as unicast, multiple-unicast
and multicast stream back into the network. In this mode, the filter works like a video server.
Furthermore it is possible to record the received videos directly onto hard disk. The recorded file can
be played back afterwards with Windows Media® Player or bitcontrol® Simple Player or edited with a
video editing program.
The camera recordings are storable in a ring buffer, where they are then available for a period of time.
This kind of archiving is a functionality of bitcontrol® Archiver (bcVideoArx), which can also configure
the video length and storage duration.
The user can read back the recorded video files out of the ring buffer via FTP.
The bitcontrol® multimedia products bitcontrol® Audio Video Decoder and bitcontrol® Digital TV Link
are also running on the client-PC, so it is possible to play back the video files via video player (e.g.
Windows Media® Player or bitcontrol® Simple Player) there.
The bitcontrol® Digital TV Link filter can be used in combination with
4
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 1. Introduction
• bitcontrol® Video Streaming Server,
• bitcontrol® Simple Player,
• Windows Media® Player version 6, 9, 10 and higher
• or other multimedia players (if they are able to load DirectShow® filters).
The bitcontrol® Video Streaming Server can also be used in combination with other source devices, but
in these cases it is not guaranteed to work properly. Errors may result.
Because of the perfect combination with the other bitcontrol® multimedia products the bitcontrol®
Video Streaming Server is characterized by high robustness in matters of errors (e.g. temporary signal
intermission or bit errors) and good quality in matters of color brilliance as well as in matters of correct
color reproduction. These properties are advantages for the use of the bitcontrol® Video Streaming
Server in private PCs or in commercial / industrial products.
The bitcontrol® Video Streaming Server is a completely web based product. That’s why a web browser
(e.g. Microsoft® Internet Explorer or Firefox) is needed to display the user interface. The bitcontrol®
Video Streaming Server uses AJAX to display the user interface and for server communication. Because
of this, JavaScript and the play back of ActiveX components have to be allowed. (More information about
hardware and software requirements can be found in the bcVSS documentation Installation guide.)
Figure 1.1. bitcontrol® Video Streaming Server overview
5
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 2. Login /Logout
Chapter 2. Login /Logout
Login
To run the bitcontrol® Video Streaming Server, please double click either on the bcVSS icon or the icon
bcVSS (Console). The difference between these variants: If bcVSS (Console) is used, all bcVSS output
messages are shown in an additional console window. When using the the bcVSS icon, bitcontrol®
Video Streaming Server will be started without showing the console window.
bitcontrol® Video Streaming Server was started a tray icon will show that (Figure 2.1, “bitcontrol® Video
Streaming Server - tray icon” [6]).
Figure 2.1. bitcontrol® Video Streaming Server - tray icon
The following functions can be executed via the tray icon context menu:
Web GUI: Opens the GUI in a browser window.
Bundle state: Opens a tabularly overview of the server moduls runtime states.
System information Shows the current working directory of bitcontrol® Video Streaming Servers.
Help: Opens the bitcontrol® Video Streaming Server documentation in a browser window.
Stop server: Stops the bitcontrol® Video Streaming Server.
GUI opening occurs via desktop icon bcVSSGUI(HTTP), via Web GUI action in try or directly by browser
start with an entered application URL. It is http://localhost:8080/bcvss by default.
Note
If the port on which bitcontrol® Video Streaming Server should be running is not available,
change the port by editing the parameter org.osgi.service.http.port in the file [install dir]\build
\configuration\config.ini .
After URL entering the login dialogue shown in Figure 2.2, “bitcontrol® Video Streaming Server login
dialogue ” [7] appears.
6
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 2. Login /Logout
Figure 2.2. bitcontrol® Video Streaming Server login dialogue
Enter the user name admin and the password admin and click the OK button.
Note
User name and password are defined by default. They should be changed after the first login
in the web interface of bitcontrol® Video Streaming Server.
along with the user name and password the login dialogue shows the master license key of bitcontrol®
Video Streaming Server (red mark in Figure 2.2, “bitcontrol® Video Streaming Server login dialogue
” [7]).
The login process can be aborted by using the Cancel button.
Note
If there is no valid license installed on the system, the note shown in Figure 2.3, “Note no
valid bitcontrol® Video Streaming Server license”
[7] appears. bitcontrol® Video Streaming
Server will run for 30 minutes without a valid license.
Figure 2.3. Note no valid bitcontrol® Video Streaming Server license
Logout
The user can leave bitcontrol® Video Streaming Server by using the
7
symbol.
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 3. User
interface (general)
Chapter 3. User interface (general)
Note
Because of the dynamic regeneration of the web view, the Return button or Back button of the
web browser doesn't work anymore. All navigation has to be done via the menu or the tree
structure of the bcVSS web user interface.
All system functionalities can be used via a visual uniform user interface. The layout considers the usual
characteristics of current graphical user interfaces.
The base of the user interface development is the RPC of Eclipse. RPC means Rich Client Platform.
A Rich Client is an application which runs on a PC, receives data from a source and processes it. By
contrast a Thin Client (e.g. a web interface) is an application that allocates information visually. The
data handling takes place on another PC.
If the login was successful, the user interface appears in the browser window Figure 3.1, “bitcontrol®
Video Streaming Server user interface” [8].
Note
View, selection and configuration possibilities depend on the role of the registered user. In
Figure 3.1, “bitcontrol® Video Streaming Server user interface”
[8] the role Administrator
was chosen, because this role holds all available rights.
Figure 3.1. bitcontrol® Video Streaming Server user interface
3.1. User interface elements
3.1.1. Structuring elements
Structuring elements are elements that help to organize the layout structure of the user interface. These
are
8
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 3. User
interface (general)
• views and
• perspectives.
3.1.1.1. Views
Views are windows that show application data and where application data can be manipulated by the
user. It is possible to site any number of views inside the main window. The positioning can be arranged
at will and adjusted by simple mouse operations.
The following views depending on the respective selected perspective are available in bitcontrol® Video
Streaming Server:
1. Tree view
2. Info view
3. Statistic view
3.1.1.2. Perspective
Perspectives are main windows with a functional layout of specified views. There are predefined
perspectives with specified tasks. The available perspectives of a user depending on its role.
Note
Only one perspective can be active at one.
The following perspectives are available in bitcontrol® Video Streaming Server:
• Chapter 4, Media [11]
• Chapter 21, User administration [96]
• Chapter 22, Logger [99]
• Chapter 23, Documentation [102]
3.1.2. Controlling elements
All other elements in bitcontrol® Video Streaming Server, like
• Menus,
• Function bars,
• Perspective bar,
• Wizards and
• Dialogues
9
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 3. User
interface (general)
are controlling elements.
3.1.2.1. Menus
The main menu of the application is situated on the upper border of the main window and contains
general functions for
• Server (see Section 4.1.1, “Change configuration” [11] to Section 4.1.4, “Keyboard driver
preferences view” [22])
• Media Application (see Section 4.1.5, “Create / add Media Application ”[22] to Section 5.1, “Media
Application context menus” [29])
• Help (see Section 4.1.10, “About bitcontrol® Video Streaming Server”[27] and Chapter 23,
Documentation [102]) .
The menu can be adjusted dynamically depending on the selected perspective or current chosen view.
The context menus are menus that are connected to single data elements shown in views and which
provide functions specially for these data elements.
3.1.2.2. Function bars
Function bars provide functionalities which can also be available in the main menu or in the context
menu of a view. The functions are displayed as symbols. Function bars can be available in the main
window and in the single views. In general the function bar is situated below the main menu.
3.1.2.3. Perspective bar
The perspective bar is a special bar, which shows the available perspectives. Furthermore it is used to
switch between the different perspectives.
Figure 3.2. bitcontrol® Video Streaming Server perspective bar
3.1.2.4. Wizards
Wizards are special input dialogues that consist of several pages. A wizard page describes a special
logical part of the input amount of the whole dialogue. A wizard window shows just one page, which
can be edited by the user. All wizards have the buttons Back and Next which can be used for wizard
page navigation.
3.1.2.5. Dialogues
Dialogues are special wizards with just one page.
10
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
Chapter 4. Media
4.1. Function bar
The following table shows a list of the symbols and functions of the Media perspective menu bar.
Symbol
Function
bitcontrol® Video Streaming Server logout (see Chapter 2, Login /Logout [6])
Change configuration (see Section 4.1.1, “Change configuration” [11])
Import a stored tree view (see Section 4.1.2, “Import” [19])
Export created tree view (see Section 4.1.3, “Export” [20])
Information about bitcontrol® Video Streaming Server version (see Section 4.1.10, “About
bitcontrol® Video Streaming Server” [27])
Stop running Media Application (see Section 4.1.8, “Stop Media Application” [26])
Start stopped Media Application (see Section 4.1.7, “Start Media Application” [26])
Switch channel (see Section 4.1.9, “Switch channel (Open channel keyboard
parameter)” [26])
Delete created Media Application (see Section 4.1.6, “Delete Media Application” [25])
Change created Media Application (see Section 4.1.5, “Create / add Media Application
” [22])
Add new Media Application (see Section 4.1.5, “Create / add Media Application ” [22])
Opens channel keyboard parameter view (see Section 4.1.1.5, “Keyboard driver
preferences (fast access via hot keys)” [16] or Section 4.1.4, “Keyboard driver
preferences view” [22])
4.1.1. Change configuration
Properties of a marked configuration can be changed via the
icon. This happens in different
dialogues, which will be explained in the next parts of ducumentation.
4.1.1.1. Common preferences
The window Common preferences (seeFigure 4.1, “Window Common preferences”[12]) offers a
the possibility to set a holding time (in seconds) between the simultaneous start of different Media
11
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
Applications. Furthermore it is possible to define a time (in seconds) for statistic refresh in the second
field.
Figure 4.1. Window Common preferences
There are some more possibilities for global bitcontrol® Video Streaming Server settings in the Common
preferences area. These are:
Configuration storage
Activating the checkbox in the Configuration storage window will ensure that a bitcontrol® Video
Streaming Server configuration will be stored in several files.
Failover
Activating the checkbox in the Failover window will make a Media Application restart automatically after
crashing.
Help system
activating the checkbox in the Help system window will open up the online help of bitcontrol® Video
Streaming Servers in an extra window.
12
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
4.1.1.2. Console color preferences
It is possible to define a backgroud color for procedures (e.g. plug-in procedures) in console view to
make it easier to tell them apart. This preference can be set in window Console color preferences (see
Figure 4.2, “Window Console color preferences” [13]).
The color selection is done with an editor, which opens is opened by clicking on the field behind the
respective list entry.
Figure 4.2. Window Console color preferences
4.1.1.3. Lable decoration
The user can adjust which further information should be visible on an items label or icon in the window
Lable decoration (see Figure 4.3, “Window Lable decoration” [14]).
13
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
Figure 4.3. Window Lable decoration
Any of the following information can be displayed:
• Current Channel:Shows the current channel of an input plug-in as text next to it.
• Media Application plug-in status:Shows the current status of a Media Application plug-in.
• Media Application status:If this option is active a status symbol appears over the Media Application
plug-in icon.
• User status decoration:Shows the current status of a certain user.
• Media Session decorator:Shows further properties of a Media Session.
• Recorder plug-in decoration:Shows the current status of a Recorder plug-in i.e. whether anything
is currently being recorded, with extra text and icons.
All entries are activated and deactivated via the checkboxes in front of them. By default, they are all
activated.
14
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
4.1.1.4. License management and statistic
License management
The window License management contains an overview of all bitcontrol® licenses installed on the
system. If there is no license available a red note appears (see Figure 4.4, “Window License
management” [15]).
Figure 4.4. Window License management
License statistic
The window License statistic (see Figure 4.5, “Window License statistic”[16]) contains an overview
of the type and amount of all installed bitcontrol® plug-in licenses.
15
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
Figure 4.5. Window License statistic
4.1.1.5. Keyboard driver preferences (fast access via hot keys)
In the Keyboard driver preferences windows the user is able to adjust hot keys that will make a fast
access to bitcontrol® Video Streaming Server functionalities (e.g. change channel) possible.
16
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
Figure 4.6. Window Keyboard driver preferences
If the checkbox in the Server startup parameter area is active, the keyboard driver will be started during
the boot process.
The user can choose between two possibilities of hot key realisation in the Keyboard driver options
area. The selection field Delay which can be edited by the user, contains the duration between hot key
entering and function execution.
The button Start keyboard driver in the window area Keyboard driver control activates the bitcontrol®
Video Streaming Server hot key functionality. It can be stopped by the button Stop keyboard driver.
It is possible to test the hot key via the Preview field. For this, the desired character string has to be
entered.
Note
This function is only available when the keyboard driver is running.
The settings are assumed by clicking on the Apply button.
The button Restore defaults will recover and restore the default settings.
Keyboard layout
The Keyboard layout window (see Figure 4.7, “Hot key list” [18]) contains a list of hot keys and their
respective bitcontrol® Video Streaming Server functionalities.
17
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
Entries can be added with the "+" button and deleted with the "-" button.
Entries can be edited or created via the selection field in the respective column.
The settings are assumed with the Apply button.
The button Restore defaults will recover and restore the default settings.
Figure 4.7. Hot key list
4.1.1.6. WSDL server properties
The bitcontrol® Video Streaming Server provides a platform independent, XML based, programming
language independent WSDL interface to access bcVSS by third-party programs.
Note
You will find more information about WSDL here: http://www.w3.org/TR/wsdl
The properties of the WSDL server interface can be configured in the window WSDL server properties
(see Figure 4.8, “Window WSDL server properties” [19]).
18
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
Figure 4.8. Window WSDL server properties
Run on bcVSS start: If this checkbox is active, the WSDL interface will be started automatically when
bitcontrol® Video Streaming Server starts.
Server port: The WSDL server interface port will be entered in this text field.
The WSDL server interface can be started by hand via the Start button. The window below then shows
the URL to the interface specification (WSDL contract).
The WSDL server interface can be stopped via Stop button.
4.1.2. Import
An exported bcVSS configuration (i.e. all available Media Applications and their properties) or the scripts
on an exported bcVSS configuration can be added to the bitcontrol® Video Streaming Server via the
Import function. Selection occurs in the first dialogue (see Figure 4.9, “Import selection Media Application
or script” [20]) which is opened by clicking on the
perspective.
19
symbol in the function bar of the Media
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
Figure 4.9. Import selection Media Application or script
If Import configuration was selected, the user is allowed to find the desired bcVSS configuration
represented by a dtvlink_cfg.bcvss file in the local file system and upload it to bcVSS (see Figure 4.10,
“Import a bcVSS configuration” [20]).
Figure 4.10. Import a bcVSS configuration
After a successful import all Media Applications of the imported bcVSS configuration appear in the tree
view of Media perspective.
The import of exported bcVSS configuration scripts occurs analogously.
4.1.3. Export
A bcVSS configuration (it means all in bcVSS available Media Applications and their properties) or the
scripts of a bcVSS configuration are exportable to restore the system if necessary. Selection occurs in
the first dialogue (see Figure 4.11, “Export selection Media Application or script”[21]) of the Export
function, which is opened by clicking on the
symbol in the function bar of the Media perspective.
20
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
Figure 4.11. Export selection Media Application or script
After selecting Export configuration a note appears in the next dialogue (see Figure 4.12, “Export
note” [21]) before the exporting starts. The dtvlink_cfg.bcvss file which represents the bcVSS
configuration can be downloaded and saved afterwards (see Figure 4.13, “Exported bcVSS
configuration” [22]).
Figure 4.12. Export note
21
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
Figure 4.13. Exported bcVSS configuration
The export of bcVSS configuration scripts occurs analogously.
Note
This option is only present if a bcVSS configuration or respective scripts are available.
4.1.4. Keyboard driver preferences view
Clicking on the
icon, the hot key list and their respective bitcontrol® Video Streaming Server
functionalies open in the information view. (You will find more information about this topic in
Section 4.1.1.5, “Keyboard driver preferences (fast access via hot keys)” [16].)
4.1.5. Create / add Media Application
The user can create /add a Media Application by using the
symbol. This will open a wizard (see
Figure 4.14, “Create / add a new Media Application”[23]), where all necessary settings for the new
Media Application can be adjusted.
22
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
Figure 4.14. Create / add a new Media Application
Media Application name: The name of the Media Application must be entered in the text field name.
Later, the entered name appears in the tree view of bitcontrol® Video Streaming Server.
Description: This text field contains a short description of the Media Application.
Start automatic: If this checkbox is active, the Media Application will be automatically started by the
process manager when the server starts.
Decoder buffer (sec): The buffer size of the bitcontrol® Ausdio Video Decoder must be defined in this
text field. The designation must be made in seconds. Decoder buffer (sec) is a mandatory field.
Video Pin: The video output will be controlled by the bitcontrol® Audio Video Decoder video pin.
Video Format: The selection field Video format contains all selectable video formats (see Figure 4.15,
“Selectable video formats” [24]). The user can choose the video format that should be used by the
Media Application here. It is also possible to edit the list entries and to add new lines. Default values:
MPEG2, 720x576, PAL.
Audio Pin: The audio output will be controlled by the bitcontrol® Audio Video Decoder audio pin.
Audio Format: The selection field Audio format contains all selectable audio formats (see Figure 4.16,
“Selectable audio formats” [24]). The user can choose the audio format that should be used by the
Media Application here. Default values: MP2, 48000, 16-bit, stereo.
23
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
Window size and position: The size (width and hight) and the position (x and y) of the window can
be entered in the text field of this wizard part.
Figure 4.15. Selectable video formats
Figure 4.16. Selectable audio formats
Clicking the Next button opens the attribute dialogue of bitcontrol® Audio Video Decoder (see
Figure 4.17, “bitcontrol® Audio Video Decoder attributes”[25]). The following attributes of bitcontrol®
Audio Video Decoders can be configured here:
Deinterlace: If the video was recorded interlaced, the video quality can be increased here. (You will
find more information about this topic in the bitcontrol® Audio Video Decoder documentation, part 5.2.2
Preferences.)
DXVA 1.0 (DirectX Video Acceleration): The decoder tries to use features of the graphics chip to
accelerate the video playback. If this option is used, the software deinterlace mechanisms become
inefficient. The DXVA option unburdens the CPU during video decoding a lot, so that a standard PC
needs less CPU power.
DXVA 2.0 (DirectX Video Acceleration): Next generation DXVA 1.0 (e.g. in Windows Vista); at the
moment just MPEG-2
Use Hardware Accelerated Deinterlace: The decoder tries to use features of the graphics chip to
offload deinterlace computations.
Frame Skipping: Frame skipping allows picture skipping for synchronisation.
24
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
Figure 4.17. bitcontrol® Audio Video Decoder attributes
Assume your settings with the Confirm button. The new Media Application will appear in the tree view.
The information view contains the entered data of the Media Application.
The process can be aborted via the Abort button.
4.1.6. Delete Media Application
The user can delete a selected Media Application out of the tree view by using the
symbol.
It is possible to delete several Media Applications at the same time. For this the user must select the
respective Media Applications.
Before the deletion process starts the following note Figure 4.18, “Note before Media Application
deletion” [26] appears.
25
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
Figure 4.18. Note before Media Application deletion
If the user confirms the question with the Yes button the selected Media Application will be permanently
deleted from the system.
The process can be aborted with the Abort button.
4.1.7. Start Media Application
The user can start a Media Application by using the
symbol.
It is possible to start several Media Applications at the same time. For this the user must select the
respective Media Applications.
Note
The start symbol is only available for Media Applications that are not running.
If a Media Application changes its state from Stop to Running, the symbol will be marked with a green
flag. In the opposite case the green flag disappears.
Running
Stopped
4.1.8. Stop Media Application
The user can stop a Media Application by selecting the
symbol.
It is possible to stop serveral Media Applications at the same time. For this, the user must select the
respective Media Applications.
Note
The stop symbol is only available for running Media Applications.
4.1.9. Switch channel (Open channel keyboard parameter)
See Section 10.2, “Switch channel (Open channel keyboard parameter)” [53]
26
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
4.1.10. About bitcontrol® Video Streaming Server
After selecting the
symbol a window opens (see Figure 4.19, “About bitcontrol® Video Streaming
Server” [27]) that contains information about the installed bitcontrol® Video Streaming Server
version. The window can be closed with the OK button or with the Close button.
Figure 4.19. About bitcontrol® Video Streaming Server
Version information on the installed plug-ins (see Figure 4.20, “Version information of plug-ins”[28])
can be found by clicking on the plug-ins button.
27
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 4. Media
Figure 4.20. Version information of plug-ins
28
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 5. Media Application
Chapter 5. Media Application
A Media Application is a set of configurable plug-ins for input and output video streams which will be
used for a concrete purpose.
5.1. Media Application context menus
Main context menu
The main context menu of a Media Application can be opened by clicking on the right mouse button.
The following functions, which were partially described in Chapter 4, Media [11], are available here:
Symbol
Function
Description
New
Opens sub context menu of a Media Application
Change Media Application
Changes a created Media Application (see Section 4.1.5,
“Create / add Media Application ” [22])
Delete Media Application
Deletes a created Media Application (see Section 4.1.6,
“Delete Media Application” [25])
Start
Starts a stopped Media Application (see Section 4.1.7,
“Start Media Application” [26])
Stop
Stopps a running Media Application (see Section 4.1.8,
“Stop Media Application” [26])
Copy
Copies a Media Application (1:1)
Cut
Cuts a Media Application
Paste
Adds a copied or cut Media Application (1:1) into the tree
Sub context menu
The sub context menu of a Media Application can be opened by clicking on the right mouse button over
the main context menu entry New.
The following functions, which were partially described in Chapter 4, Media [11], are available here:
Symbol
Function
Description
New Media Application
Adds new Media Application (see Section 4.1.5, “Create /
add Media Application ” [22])
New plug-in
Adds plug-in to a Media Application (see Section 5.2,
“Adding plug-ins” [30])
29
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Symbol
Chapter 5. Media Application
Function
Description
Add Scenario
Adds a new Scenario to the tree (siehe Section 5.3, “Add /
Edit Scenario” [33])
Add Transcoder
Adds a Transcoder configuration to the selected Media
Application (see Chapter 19, Transcoder [82])
Add script
Allwos the creation of a new script for bitcontrol® Video
Streaming Server (see Chapter 20, Scripting [88])
5.2. Adding plug-ins
5.2.1. Plug-in selection notes
The following notes should be helpful for bitcontrol® Video Streaming Server plug-in selection:
1. Unique plug-in selection per Media Application instance!
If a plug-in was added to a Media Application, a new selection of the same plug-in isn't possible
anymore.
2. One input plug-in per Media Application!
bitcontrol® Video Streaming Server only handles one input source per Media Application. The
definition of several input sources for one instance isn't designated. If a plug-in was selected, it isn't
possible to choose a further one. The change from one input plug-in to another is only possible if the
existing plug-in is deleted and a new one is created.
Note
In certain cases (e.g. input source failure or periodic input source change), it is sensible to
define several input plug-ins per Media Application. In these cases, the checkbox just one
input plug-in must be deactivated. It is then possibleto define several input plug-ins per Media
Application.
3. Standard plug-ins can be combined with all other plug-ins!
It is possible to combine the standard plug-ins with all other bitcontrol® Video Streaming Server plugins.
4. The Recorder plug-in needs an input!
The Recorder plug-in can be combined with all input plug-ins except for the File plug-in (it's not
expedient).
5. Output plug-ins require an input!
The output plug-ins require a definition of an input plug-in.
Note
In certain cases it can be possible to combine different input plug-ins.
30
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 5. Media Application
5.2.2. Media Application overview
The following plug-ins can be added to a Media Application:
Input plug-ins
Axis plug-in
The video stream source is an Axis camera
Traficon VIP-T plug-in
The video stream source is a Traficon encoder card
Bosch VIP-X plug-in
The video stream source is a Bosch encoder card of a
VIPX type
Capture plug-in
The video stream source is a capture device (e.g. a
webcam)
Dreambox plug-in
The video stream source is a Dreambox
DBox2 plug-in
The video stream source is a DBox2
Reel Box plug-in
The video stream source is a ReelBox
BDA plug-in
The video stream source is a device with BDA driver
support (e.g. PCI TV card or USB TV stick)
File plug-in
The video stream source is a video file (supported
formats see Chapter 1, Introduction [3].)
RTSP Receiver plug-in
bitcontrol® Video Streaming Server works for the video
stream (RTSP data packages) as an RTSP receiver.
Output plug-ins
Multistream Server plug-in
Provides one or several video streams in different
streaming formats.
NetPublisher plug-in
Provides one or several video streams in different
streaming formats.
Other plug-ins
Recorder plug-in
The user can adjust the settings for video recording in the
dialogues of the Recorder plug-in.
Console plug-in
Opens a console window to show information about
bitcontrol® Video Streaming Server processes.
Systray plug-in
Shows the Media Application icon in the footline of the
desktop
Colored Frame plug-in
Possibility to set a colored frame around the video
window.
31
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 5. Media Application
5.2.3. Adding plug-in procedure
Clicking the entry Add new plug-in (
symbol) in the sub context menu of a Media Application (see
Section 5.1, “Media Application context menus”[29] opens the following wizard (see Figure 5.1,
“Wizard for adding Media Application plug-in” [32]).
Figure 5.1. Wizard for adding Media Application plug-in
Plug-in name: The user can choose the desired Media Application plug-in via this selection field.
Note
The selection field only contains the plug-ins that were installed during the bitcontrol® Digital
TV Link installation!
Description: This field contains a description of the respective plug-in. The text field cannot be edited.
The selection is confirmed with the Next button and the user then arrives at the next dialogue.
The process can be aborted with the Abort button.
Note
Buttons whose functions aren't available yet are grayed out.
The following dialogues contain adjustment possibilities for the selected plug-in. They will be explained
in the respective plug-in documentation parts.
5.2.4. Plug-in context menu
Clicking the right mouse button over a plug-in entry the plug-in will open context menu. Several functions
are available here depending on the plug-in.
The following functionalities are generally possible:
32
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 5. Media Application
Main context menu
New
Opens sub context menu of a Media Application plug-in
Switch channel
Switchs channel
Change plug-in
Changes plug-in settings
Remove plug-in
Removes plug-in
Start recording
Starts video stream recording (Recorder plug-in only!)
Stop recording
Stops video stream recording (Recorder plug-in only!)
Copy
Copies the selected plug-in (1:1)
Cut
Cuts the selected plug-in (1:1)
Paste
Pastes a copied or cut plug-in (1:1) into another Media
Application
Sub context menu
New Media Application
Adds a new Media Application
Add scenario
Adds a new scenario (see Section 5.3, “Add / Edit
Scenario” [33])
Add script
Allows creation of new scripts for bitcontrol® Video
Streaming Server (see Chapter 20, Scripting [88])
Note
Functions that aren't executable are greyed out.
The functions are described futher in the respective plug-in documentation part.
5.3. Add / Edit Scenario
Add Scenario
Scenarios can be used to start procedures (e.g. start, stop, ..) of several Media Applications at the same
time with one click.
Scenarios are on the same hierarchy level as Media Applications.
Clicking the
sub context menu icon opens the window shown in Figure 5.2, “Dialogue - Name and
description of a scenario” [34]. The name and the description of the scenario can be entered.
33
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 5. Media Application
Figure 5.2. Dialogue - Name and description of a scenario
The Media Applications and their respective procedures (e.g. start) are listed in the next dialogue
Figure 5.3, “Selection of Media Application and respective procedure”[34]. The table entries can be
selected via the fold-out selection field, which contains all available possiblities.
Figure 5.3. Selection of Media Application and respective procedure
After completion the new scenario appears in the tree.
Main context menu of a scenario
The following functions can be executed via the main context menu:
Symbol
Function
Description
New
Opens the sub context menu of a scenario
34
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Symbol
Chapter 5. Media Application
Function
Description
Add scenario
Adds a new scenario to the tree (siehe Section 5.3, “Add /
Edit Scenario” [33])
Edit Scenario
Opens the dialogues for editing the selected scenario
(analogously add scenario / see Section 5.3, “Add / Edit
Scenario” [33] / part "Add Scenario" )
Copy
Copies a scenario (1:1)
Cut
Cuts a scenario
Paste
Adds a copied or cut scenario to the tree
Execute Scenario
Executes the configure procedures (see part Execute
Scenario)
Delete Scenario
Deletes the scenario from the tree
Sub context menu of a scenario
The following functions can be executed via sub context menu:
Symbol
Function
Description
New Media Application
Adds a new Media Application (see Section 4.1.5,
“Create / add Media Application ” [22])
Add Scenario
Adds a new scenario to the tree (siehe Section 5.3, “Add /
Edit Scenario” [33] / part "Add Scenario")
Edit Scenario
Opens the dialogues for editing the selected scenario
(analog add scenario / see Section 5.3, “Add / Edit
Scenario” [33] / part "Add Scenario" )
Copy
Copies a scenario (1:1)
Cut
Cuts a scenario
Paste
Adds a copied or cut scenario to the tree
Execute Scenario
Executes the configure procedures (see part "Execute
Scenario")
Delete Scenario
Deletes the scenario fom the tree
Execute Scenario
A scenario can be started by clicking on the
executed then.
context menu icon. All configured procedures will be
35
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 5. Media Application
5.4. Create new script
See Chapter 20, Scripting [88]
5.5. Application wizard
The Application wizard guides the user through the creation of a simple Media Application.
A simple Media Application can constists of exactly one source plug-in (e.g. BDA) and/or exactly one
output plug-in (e.g. NetPublisher) and/or exactly one plug-in with additional functions (e.g. Colored
Frame).
After creating a Media Application via the Application wizard, it is possible to change the properties of
the created Media Application and their plug-ins and to add futher plug-ins.
The most important settings of a Media Application will be adjusted in the first dialogue of the Application
wizard (see Figure 5.4, “1st dialogue of Application wizard”[36]). The next dialogues of video sources,
video outputs and plug-ins with additional functions correspond with the configuration window of the
respective plug-in.
Figure 5.4. 1st dialogue of Application wizard
5.6. Create Samples
The entry Create Samples can be used to add two precasted functional sample Media Applications File Sample and RTSP Client Sample - into the tree structure. These can be changed by the user.
36
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 6. Plug-in Axis
Chapter 6. Plug-in Axis
With the plug-in Axis connected devices by Axis Communications AB company, e.g. cameras, can be
used as input video sources.
Note
The Axis plug-in requires a separate license.
6.1. Add plug-in / edit properties
The properties of the Axis plug-in are configured by a wizard during the creation process and can be
edited afterwards with these dialogues.
After selecting the main context menu entry Change plug-in, the window shown in Figure 6.1, “Network
address of the Axis camera” [37] appears. The IP address of the input stream can be edited here.
Figure 6.1. Network address of the Axis camera
Address*: The IP address (> 224.x.x.x) of the input stream will be entered here.
Note
The network address requires the attachment rtsp:// !
Search Axis RTSP Devices ... : A list of all available Axis cameras (see Figure 6.2, “Axis camera
selection” [38]) will be shown with this button. The user can select the desired device here.
37
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 6. Plug-in Axis
Figure 6.2. Axis camera selection
The settings can be stored by clicking on the Finish button. Other properties can be changed via the next
dialogue (see Figure 6.3, “Properties of Axis plug-in” [38]). It is opened by clicking on the Next button.
Figure 6.3. Properties of Axis plug-in
Authorization area
Name: The Axis device user name can be defined here. It is necessary to set a user name here if the
URL doesn't contain a user name but coercively needs one for server authentication.
38
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 6. Plug-in Axis
Password: The Axis device receiver user password can be defined here. It is necessary to set a
password here if the URL doesn't contain a password but coercively needs one for server authentication.
Authorisation "Basic": This option activates the authentication level "Basic". With this level, the
username and password are set directly to the RTSP Server in text form. "Basic" is a simple but unsafe
authentication method.
Authorisation "Digest": This option activates the authentication level "Digest". With this level, the
username and password are encoded and sent to the RTSP Server. "Digest" is a more complicated
but safer authentication method.
RTP and RTCP area
The adjustable values in the RTP and the RTCP area represent socket parameters, which can be used
to optimise network data traffic. The following configurations are possible:
-1: The value range will be automatically set up to MTU size.
0: The parameter will not be set.
a KB value: Manual value range input in KB.
Transport area
The window Transport area contains possibilities to set the type of data stream transport.
Query Transport: The data stream transmission methods unicast (default value), multicast or
interleaved can be selected via this selection field. The list sequence shows the preferred methods (first
place = most prefered).
Query Multicast Address: Activating this option is only reasonable if the multicast transmission
method was chosen in the Query Transports. Entering a destination server address (e.g. 329.0.0.1) is
mandatory!
Further options
Send "Options": If this option is active, the client asks for server options (server methods and
commands).
Ignore "Content-Base": If this option is active, the content (audio/video) will be interpreted in an
alternative way. This option can be useful to solve conflicts of servers with more than one network
interface card.
Ping with "GET_PARAMETER": If this option is active, the server will be pinged periodically to check
its availability.
Accept "Redirect": If this option is active, the server sends a message that the content (video/audio)
is located on another server.
Cache Addresses: This option activates the latching of network addresses.
39
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 6. Plug-in Axis
AV sync (lip-sync): This option activates the synchronisation of video and audio streams via RTCP.
The settings can be stored with the Finish button. Other properties can be changed via the next dialogue
(see Figure 6.4, “Axis specific properties of Axis plug-in” [40] ), which is opened by the Next button.
Figure 6.4. Axis specific properties of Axis plug-in
Video options area
Bitrate: The bitrate of the video stream will be shown in this field. It can also be edited here.
Rotation: The video can be rotated via this selection field. The following positions are possible: 0
degrees and 180 degrees.
Colored: If this option is active, the video will be colored. Otherwise, it's black and white. This option
is active by default.
Color level: The color level of the video can be adjusted with this slider. The color level value will be
visible in the the field next to the slider.
Overlay area
Show clock: If this option is active, a clock will be shown in the video. The value comes from the system.
Show Date: If this option is active, the date will be shown in the video. The value comes from the system.
Show Text: If this option is active, a text will be shown in the video. The text can be entered in the field
"Text" beside the option box.
40
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 6. Plug-in Axis
Text Position: The position of the text in the video can be set via this selection field. The choices are:
top and bottom.
The button Back can be used to return to the previous dialogue.
The settings are assumed with the Finish button.
The process can be aborted with the Abort button.
All "*" marked fields are mandatory fields, i.e. they must be filled.
Areas that aren't available are greyed out.
6.2. Parameterise event detection for Axis cameras
Follow these steps to parameterise event detection for Axis cameras:
1. Add a new event server in the web interface of the camera, that supports HTTP protocol and listens to
the same host and port as bcVSS (default 8080); URL-Path /axisEvent. Event server URL example:
http://192.168.2.36:8080/axisEvent
2. Next parameterise the desired events on the camera and add the server for notification.
3. If a parameterised event occurs, a log message will be generated in bitcontrol® Video Streaming
Server. The log message can be read out of the log perspective.
41
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 7. Plug-in BDA
Chapter 7. Plug-in BDA
With the help of the BDA plug-in connected BDA devices such as DVB USB TV sticks or PCI cards
can be used as input sources.
Note
The BDA plug-in license is part of the bitcontrol® Multimedia Suite base license.
7.1. BDA properties
The BDA plug-in properties are configured by a wizard during the creation process and can be edited
afterwards with this dialogue.
After selecting the entry BDA out of the main context menu of the plug-in the following dialogue
Figure 7.1, “BDA plug-in configuration” [42] appears. An available BDA tuner can be selected or
configured by hand here.
Figure 7.1. BDA plug-in configuration
Select tuner
Select Tuner: All available devices (PCI cards or USB TV sticks) are listed in the selection field
Select Tuner. The user can chose the desired one here. The corresponding settings will be assumed
automatically.
Manual
Manual: If the checkbox is active, the device settings can be entered or edited by hand.
42
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 7. Plug-in BDA
DVB System: The user can select the DVB system here. The following possibilities are available: DVBT (terrestrial), DVB-S (satellite), DVB-C (cable).
Tuner: All available devices (PCI card or USB TV sticks) are listed in the selection field Select tuner.
The user can choqse here.
Demodulator: The user can select the demodulator which should be used here. The following
possibilities are available: BDA Slip De-Framer, BDA MPE-Filter as well as device dependent
demodulators.
Capture: The user can select the capture component which should be used here. The following
possibilities are available: BDA Slip De-Framer, BDA MPE-Filter as well as device dependent capture
applications.
7.2. Setup of a Media Application with the BDA plug-in
The following steps show the setup of a Media Application with the BDA plug-in.
1. step: Add the BDA plug-in to a created Media Application (see Section 5.2, “Adding plug-ins” [30])
2. step: Configure the BDA plug-in (see Section 7.1, “BDA properties” [42])
3. step: Add the Systray plug-in to the Media Application (see Section 5.2, “Adding plug-ins” [30])
4. step: Configure the Systray plug-in
5. step: Start the Media Application
6. step: Scan channels
After the first start of the Media Application, the area where usually the video is running just a black
square. The reason for this is that no video channel was already set. But before setting a video
channel, all available channels must be found by scanning first. To do this the user clicks the right
mouse button on the bitcontrol® Digital TV Link icon in the footline of the desktop. A sub menu opens
from which the entry Options... is selected. After that, the option dialogues of the Media Application
open. There, the entry channels of the respective BDA plug-in are selected from the option dialogues
tree. After that, the assistant shown in Figure 7.2, “Channel scan assistant for BDA devices”[44]
appears.
43
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 7. Plug-in BDA
Figure 7.2. Channel scan assistant for BDA devices
The channel scan starts after clicking on the Scan button. All available channels will be shown in red
color and in table form in the lower part of the window (see Figure 7.3, “Gefundene Kanäle” [44]).
Figure 7.3. Gefundene Kanäle
When the scan process has ended the located channels will be assumed in the channel list. This is
done by clicking on the Apply button. The color of the channels changes from red into green (see
Figure 7.4, “Apply channels”[45]). Afterwards the Media Application option dialogue can be closed
by clicking on the OK button.
44
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 7. Plug-in BDA
Figure 7.4. Apply channels
7. step: Set channel (respectively switch channel)
Clicking the right mouse button on the BDA plug-in opens the main context menu. Here the entry
Switch channel will be chosen. The Switch channel dialogue (see Figure 7.5, “Switch channel
dialogue of the BDA plug-in” [45]) opens. All located channels are displayed in this window.
The user marks the desired channel and assumes the selection with the Switch button. After a few
seconds the video of the selected channel will be played back into the black display area.
Figure 7.5. Switch channel dialogue of the BDA plug-in
45
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 8. Plug-in Bosch VIP X
Chapter 8. Plug-in Bosch VIP X
Connected Bosch VIP X devices can be used as the input video source by the plug-in Bosch VIP X.
Note
The Bosch VIP X plug-in requires a separate license.
8.1. Add plug-in / edit properties
The Bosch VIP X plug-in properties are configured by a wizard during the creation process and can be
edited afterwards with this dialogue.
After selecting the plug-in entry Change Plugin out of the plug-in context menu, the window shown in
Figure 8.1, “Plug-in Bosch VIP X” [46] appears.
Figure 8.1. Plug-in Bosch VIP X
Address*: The IP address (> 224.x.x.x) of the input and output stream will be entered in this text field.
Network interface card*: With this selection field, the user is able to set the network interface card on
which the multicast stream should be received. The choices are: auto (default network interface card),
any (any network interface card) and loopback (local computer).
Receiver buffer (KBytes)*: The value of the maximum buffer size for data packages on the receiver
site can be set in this text field.
Enable multicast loopback: If this option is active, the reception of a local video stream will be possible.
The next dialogue is opend by clicking on the Next button.
46
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 8. Plug-in Bosch VIP X
Figure 8.2. PTZ properties of the Bosch VIP X plug-in
Device address: The Device address is the IP address to which PTZ commands (pan – tilting -zoom)
can be sent. This functionality of the Bosch VIPX encoder requires a connected device that supports
PTZ.
The button Back can be used to return to the previous dialogue.
The settings are assumed with the Finish button.
The process can be aborted with the Abort button.
All "*" marked fields are mandatory fields, i.e. they must be filled.
Areas that aren't available are greyed out.
47
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 9. Plug-in Capture
Chapter 9. Plug-in Capture
bitcontrol® Video Streaming Server supports the connection of video capture devices such as webcams,
cameras or grabber cards (for digitalization analog input signal) by using the Capture plug-in.
Note
The Capture plug-in license is part of the bitcontrol® Multimedia Suite base license.
9.1. Add plug-in / edit properties
The Capture plug-in properties are configured by a wizard during the creation process and can be edited
afterwards with this dialogue.
After selecting the plug-in entry Change plug-in out of the plug-in context menu, the window shown in
Figure 9.1, “Properties of the Capture plug-in” [48] appears.
Figure 9.1. Properties of the Capture plug-in
Video capture device: The capture device (e.g. camera) that should be used as the video source can
be selected via the selection field Video capture. The connected device will be identified automatically
by the Media Application. Selecting the entry Screen allows capturing the monitor activities (screencast
functionality).
Audio capture device: The capture device (e.g. camera with microphone) that should be used as
the audio source, can be selected via the selection field Audio capture. The connected device will be
identified automatically by the Media Application.
Overlay: bitcontrol® Video Streaming Server makes it possible to fade in a picture (e.g. a logo) in the
upper left edge of a video. The path to the picture will be entered in this field. The picture can also
be chosen by using a file selection dialogue (see Figure 9.2, “Dialogue for the selection of the fade
48
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 9. Plug-in Capture
in picture” [49]), which opens after clicking on the button Choose image. The result is shown in
Figure 9.3, “Selected logo picture in a video (example)” [49].
Figure 9.2. Dialogue for the selection of the fade in picture
Figure 9.3. Selected logo picture in a video (example)
Compression area
The Compression area contain possible video and/or audio encoders which will be used to encode video
and/or audio streams.
49
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 9. Plug-in Capture
Video compression: The video compressor that should be used, can be selected via the selection field
Video compressor. The selection field contains all video encoders available in the system.
Audio compression: The audio compressor that should be used, can be selected via the selection
field Audio compressor. The selection field contains all audio decoders available on the system.
Video standard area
The Video standard area contains the settings of the format (PAL, NTSC or SECAM) and the respective
video and/or audio profile (e.g. resolution, bit rate, etc.) for video and/or audio playback.
Video standard: This selection field contains all available video standards. A selection here requires
a selection in Video and/or Audio Profile as well.
Video profile: The selection field Video profile contains all available video profiles.
Audio profile: The selection field Audio profile contains all available audio profiles.
Clicking the Next button opens the next dialogue (see Figure 9.4, “Set fade-in (text, time and/or
date)” [50]).
Here the user is able to define further information and their properties which should fade into the video
of the Capture device. If the display of date, time and/or text is necessary, the user has to click on the
button Add fade-in first. Thereby a table row in the left part of the dialogue will be completed beforehand.
All table fields can be edited (by double clicking on the respective table entry), so the user can change
the settings for the additional information afterwards.
A marked table entry can be removed by using the button Remove fade-in.
Figure 9.4. Set fade-in (text, time and/or date)
x: The numerical value in this field defines the horizontal distance of the text window from the left upper
border of the video.
y: The numeriacl value in this field defines the vertical distance of the text window from the left upper
border of the video.
50
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 9. Plug-in Capture
Width: The numerical value for the width of the text window can be entered into this table field.
Height: The numerical value for the height of the text window can be entered into this table field
Color: If the user clicks in this field, a color editor opens. The color of the additional information can
be chosen here.
Font height: The font height for the additional information can be chosen via this dropdown box.
Font name: The font of the additional information can be chosen via this dropdown box. All fonts that
are installed on the system are available.
Text: Any text, date and/or time can be entered in this field. Date and time are defined by special
placeholders (table of possible placeholders see Chapter 16, Plug-in Recorder [74]).
Note
The display of all additional information characters depends on the amount, the size of the
defined text window, the font and the font size!
The button Back can be used to return to the previous dialogue.
The settings are assumed with the Finish button.
The process can be aborted with the Abort button.
All "*" marked fields are mandatory fields, i.e. they must be filled.
Areas that aren't available are greyed out.
51
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 10. Set Top Box plug-ins
Chapter 10. Set Top Box plug-ins
This documentation part describes how to add a set top box plug-in (plug-in Dreambox, plug-in ReelBox
and plug-in DBox2) using the example of plug-in the Dreambox.
10.1. Add plug-in / Edit properties
The set top box properties are configured by a wizard during the creation process and can be edited
afterwards with this dialogue.
After selecting the plug-in entry Change plug-in out of the plug-in context menu, the window shown in
Figure 10.1, “Plug-in Dreambox properties” [52] appears.
Figure 10.1. Plug-in Dreambox properties
Address*: The IP address (> 224.x.x.x) of the set top box is entered in this text field.
STB model: With this selection field the set top box type can be chosen. The following set top box types
are supported at the moment: DM 500, DM 600, DM 800, DM 7000, DM 7020, DM 7025.
Note
The plug-in DBox2 and the plug-in ReelBox don't have this choice.
Streaming method: The user can set the streaming method via this selection field. The options PES
and TS are supported.
Note
The plug-in DBox2 and the plug-in ReelBox don't have this choice.
Refresh cycle (Min)*: This value shows the time in minutes of the automatic channel update.
The button Back can be used to return to the previous dialogue.
52
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 10. Set Top Box plug-ins
The settings will be assumed with the Confirm button. Afterwards the plug-in Dreambox is visible in the
tree view of the respective Media Application.
The process can be aborted with the Abort button.
Note
All * marked fields are mandatory fields, i.e. they must be filled.
10.2. Switch channel (Open channel keyboard parameter)
If the user chooses the entry Change channel out of the main context menu, the table shown in
Figure 10.2, “Switch channel” [53] opens. The current channel can be changed here. For this the
user selects a channel out of the list and clicks on the Switch button.
Figure 10.2. Switch channel
53
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 11. Plugin Colored frame
Chapter 11. Plug-in Colored frame
For a better video stream detection a colored frame can be added. For this, it is necessary to add the
plug-in Colored frame to the respective Media Application and to configure it.
The plug-in Colored frame will be added like the other Media Application plug-ins via sub context menu,
entry Add new plug-in. After selecting the entry Colored frame in the opened dialogue, the mask shown
in Figure 11.1, “Plug-in Colored frame” [54] appears.
Figure 11.1. Plug-in Colored frame
Frame color:Clicking the button Frame color opens a color selection editor. Here, the user can choose
the color. After confirmation with OK, the selected color appears in the field behind the button. This will
be the color of the frame around the video stream.
Frame size: The frame size can be set via the up and down buttons of the selection field.
The settings are assumed with the Confirm button. Afterwards the plug-in Colored Frame is visible in
the tree view of the respective Media Application.
The process can be aborted with the Abort button.
54
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 12. Plug-in File
Chapter 12. Plug-in File
The plug-in File represents one single or several video files which are saved in a playlist and which
can be played back.
The properties of the File plug-in will be configured by a wizard during creation process and can be
edited afterwards with these dialogues.
After selecting the main context menu entry Change plug-in, the window shown in Figure 12.1, “Plugin File” [55] appears.
Note
The window is still empty when the option was called for the first time after installation.
Figure 12.1. Plug-in File
55
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 12. Plug-in File
Figure 12.2. File selection dialogue
Add: Clicking the button Add opens a dialogue for file selection (see Figure 12.2, “File selection
dialogue” [56]). A video file can be selected here. After that the video file appears as a new entry in
the table. If the process is repeated several times, a playlist develops in the table. It means, the chosen
videos will be played back in this sequence.
Remove: A marked entry can be removed from the table by clicking the Remove button.
Move up: The Up button can be used to move a table entry one position up. It means the marked entry
changes its position with the previous entry.
Move down: The Down button can be used to move a table entry one position down. It means the
marked entry changes its position with the successive entry.
The Apply button can be used to assume the settings for the File plug-in.
The process can be aborted with the Abort button.
56
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 13. Plug-in Console
Chapter 13. Plug-in Console
The user receives information about the processes of a Media Application via the Console plug-in.
Note
It is better to add a Console plug-in to each Media Application, so that is easier to detect errors.
Only the checkbox Invert scrolling can be activated in the configuration dialogue of plug-in Console (see
Figure 13.1, “Plug-in Console” [57]). If the user activates this checkbox, the Console output will be
in reversed order. That means the entry that arrived last will be shown first.
Figure 13.1. Plug-in Console
Information output via the Console plug-in is only available when the Media Application is running.
In other words, a Media Application must be started first. After clicking on the entry Console in
the information view a filled table appears (see Figure 13.2, “Console example in a running Media
Application ” [58]).
57
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 13. Plug-in Console
Figure 13.2. Console example in a running Media Application
Console window information
Plug-in filter: Messages of all Media Application that create log information are shown in the table by
default. If the messages should be sorted according to a special plug-in, the desired plug-in can be
chosen with this selection field.
Note
The selection field always contains the entry Media Application, because a Media Application
works together with the software component bitcontrol® Digital TV Link.
Level filter: The slider can be used to set the priority granularity of the message. The scale area is from
left 1 (only messages of the highest priority are shown) to right 15 (all messages are shown).
Column Timestamp: This column contains the time when the message was reported.
Column Source: This column shows which plug-in reported the message.
Column Level: This column contains the priority level of the message. Thereby level 1 means highest
priority and level 15 lowest priority.
Column Message: This column contains the message information.
58
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 14. Plugin Multistream Server
Chapter 14. Plug-in Multistream
Server
With the Multistream Server plug-in you can provide various video streams from different video sources
within a network. The source of the video can be one of the input plug-ins or an already existing video
stream from the network. The following output formats are supported:
• RTSP
• RTMP / RTMPT
• Apple HTTP Live Streaming (HLS)
Note
The Multistream Server plug-in requires a separate license.
14.1. Add plug-in / edit properties
The Multistream Server is configurated with the Multistream Server wizard, as shown in Figure 14.1,
“Multistream Server wizard” [59].
Figure 14.1. Multistream Server wizard
Network interface card*: With this selection field the user is able to set the network interface card on
which the http request should be received. The choices are: auto (default network interface card), any
(any network interface card) and loopback (local computer).
Verbose: The logging level that the Multistream Server uses.
Max connections: The maximum amount of simultaneous connections that the Multistream Server will
handle. All connection requests above that limit will be denied.
59
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 14. Plugin Multistream Server
Max. Connections per Client: The maximum amount of simultaneous connections of one single client.
Strict access: If this option is activated then every privilege that is set to undefined will be interpreted as
false. Not activating this option has the opposite effect. It means all privileges with value undefined will be
interpreted as activated. You can set privileges for every user group of Multistream Server individually.
Max live channels: The maximum amount of video channels the Multistream Server will handle.
The wizard can be aborted with the Abort button.
All * marked fields are mandatory fields, i.e. they must be filled.
With the following wizard page (see Figure 14.2, “Multistream Server Assistent - Timeout”[60])
connection timeouts that will be used by the Multistream Server can be set.
Figure 14.2. Multistream Server Assistent - Timeout
Timeouts
Rx: Receive timeout (R0 - receive first byte, R1 - receive delta), it means the time to the next client
request
Sx: Send timeout (S0 - send first byte, S1 - send delta), it means the time until the server answers
the request
Cx: Connection timeout (C0 - receive/send first byte, C1 - receive/send delta, C2 - connection duration),it
means the total connection timeout
60
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 14. Plugin Multistream Server
Figure 14.3. Timeout relations
At wizard page 3 and 4 (see Figure 14.4, “Multistream Server wizard - IP address filter”[61]) you can
restrict the IP ranges that can connect to the Multistream Server. You can explicitly allow or forbid IP
ranges. To define a IP range you can use the CIDR notation.
Adding a new IP range is done with the + button. After clicking this button will add a row to the table
in the window. The row can be edited.
To remove an IP range from the list, the entry must be marked first. After that the button - must be used.
The Multistream Server also offers the possibility to read in IP ranges from a separate file in CIDR
notation. For this, a file upload dialogue opens after clicking on the CIDR button.
Note
Files with IP ranges are provided in the internet a as service or can be created by the user.
Figure 14.4. Multistream Server wizard - IP address filter
61
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 14. Plugin Multistream Server
For a faster configuration of the Multistream Server you can use various preconfigurations you can
find on the last page of the Multistream Server wizard (see Figure 14.5, “Multistream Server wizard preconfiguration” [62]).
Figure 14.5. Multistream Server wizard - preconfiguration
14.2. Multistream Server Media Sessions
The Multistream Server uses Media Sessions to describe the different video streaming formats. There
are several types of Media Session that serve several purposes.
A new Media Session can be created via the sub context menu of the Multistream Server.
Figure 14.6. Media Session selection via Multistream Server context menus
Common properties of Media Sessions
Different Media Sessions own common properties which will be explained using the example of RTSP
Live Media Session.
62
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 14. Plugin Multistream Server
Figure 14.7. Common properties of a Media Sessions
Verbose Level: Log level which shows the Media Session events
URL (URL Path): See next scheme
Figure 14.8. URL Path
Strict Access: If this option is activated then every privilege that is set to undefined will be interpreted as
false. Not activating this option has the opposite effect. It means all privileges with value undefined will
be interpreted as activated. You can set privileges for every user group of the Media Session individually.
Note
If the option is already set to active in the Multimedia Server plug-in, the option will also be
active by default for each Media Session. It means: If Strict Access shouldn't be active for a
single Media Session this field can be used for deactivation.
Max Client Sessions: The maximal amount of clients which can log in to the Media Session
Client Session Timeout (sec): Duration (in seconds) of the client session without data transmission
before it is closed by the Multistream Server
Port: Port number of the Media Session
63
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 14. Plugin Multistream Server
Figure 14.9. Media Sessions user groups
The user groups of the Media Session can be activated or deactivated by selecting the respective
checkbox.
Figure 14.10. General properties of a Media Session
Authenticate: Authentication type of the client at Multistream Server for a Media Session
Authentication Realm: Description of the protected authentication area
Encoding extentions: Protocols like HTTP can have extention files that own further protocol properties
(e.g. functions, style, ...). The field Encoding Extentions can be used to add such extention files.
64
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 14. Plugin Multistream Server
Encoding Min File Size:Minimal size of the extention file
Encoding Max File Size: Maximal size of the extention file
Note
All files between maximum and minimum will be compressed.
The limitation of the IP address area is part of the next Media Session wizard pages. IP address ranges
for Media Session can be allowed or denied here. The definition of the IP ranges follows CIDR (Classless
Inter Domain Routing) notation. The configuration ist only valid for this Media Session.
Figure 14.11. Allowed IP Address Ranges of the Media Session
Figure 14.12. Denied IP Address Ranges of the Media Session
65
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 14. Plugin Multistream Server
Media Session Types and their specific configuration pages
The following Media Session types can be configured:
• HTTP Ctrl Media Session: Provides an XML structure with Multistream Server channel information.
Figure 14.13. Specific adjustments for HTTP Ctrl Media Session
The XML file contains different HTTP requests to control the Multistream Server. These files will be
limited for receive direction and sending direction because of safety reasons. The limitation will be
configured in this window.
XML Message Max Receive Size: Maximum size of the XML file in receive direction
XML Message Max Send Size: Minimum size of the XML file in sending direction
• HTTP File Media Session: Provides files from the file system via HTTP.
66
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 14. Plugin Multistream Server
Figure 14.14. Specific adjustments for HTTP File Media Session
Content Folder: This field contains the directory with files to which HTTP File Media Session should
have access to.
Default Page: This page appears when no URL was entered.
FileReadBufferSize: Internal parameter (don't change)
• HTTP Live Media Session: Provides video streams for the iOS of Apple devices via HTTP.
Figure 14.15. Specific adjustments for HTTP Live Media Session
67
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 14. Plugin Multistream Server
Burst: Internal parameter (don't change)
Burst Time Offset (ms): Internal parameter (don't change)
Max number of files in m3u playlist: Maximum amount of items a M3U playlist should own.
Note
A M3U playlist is a playback sequence according to M3U and PLS specification. For more
information see http://www.scvi.net/pls.htm.
M3U playlist duration (sec): Time limit of a single item in a M3U playlist. Time period: ca. 10 up
to 40 seconds
• HTTP Test Media Session: Provides a HTML site, which shows the currently available Multistream
Server video channels.
• RTMP Live Media Session: Provides video streams with the RTMP (Real Time Messaging Protocol)
network protocol by Adobe Systems.
Figure 14.16. Specific adjustments for RTMP Live Media Session /
RTMP Rec Media Session / RTMP VideoOnDemand Media Session
Enable RTMPT: An alternative method for HTTP streaming via tunneling can be activated by selecting
this option. The option is useful when RTMP protocol isn't allowed or is limited by a firewall.
RTMPT Port: Default HTTP port
Note
Utilisation: Flash streaming
• RTMP Rec Media Session: Is made for RTMP video stream reception.
68
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 14. Plugin Multistream Server
See RTMP Live Media Session
• RTMP VideoOnDemand Media Session: Publishes Video on Demand (VOD) via RTMP.
See RTMP Live Media Session
• RTP Live Media Session: Provides video streams via the RTP (Real-Time Transport Protocol)
network protocol.
No specific adjustments
• RTSP Live Media Session: Provides video streams via the RTSP (Real - Time Streaming Protocol)
network protocol.
Figure 14.17. Specific adjustments for RTSP Live Media Session
Session Timeout (sec): Duration (in seconds) of a RTSP Live Media Session without protocol
transmission before it is closed by the Multistream Server.
Further RTSP Live Media Session parameters correspond to the RTCP standard and can be retrieved
from the internet http://www.ietf.org/rfc/rfc3550.txt.
• RTSP VideoOnDemand Media Session: Publishes Video on Demand (VOD) via RTSP.
No specific adjustments
• Net Receiver Media Session: Receives video streams that are sent by the Net Publisher plug-in
via HTTP.
69
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 14. Plugin Multistream Server
Figure 14.18. Specific adjustments for Net Receiver Media Session
Buffering Time (sec): Video data cache time (in seconds)
14.3. Multistream Server user management
To restrict the access of the video channels, it is necessary to create users and user groups. These
can be defined for each Multistream Server instance. The creation of a new user group is done with a
wizard Figure 14.19, “Multistream Server user group wizard” [71].
Note
Multistream Servers users and user groups are not identical to bitcontrol® Video Streaming
Server users and user groups!
70
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 14. Plugin Multistream Server
Figure 14.19. Multistream Server user group wizard
Each user inherits the rights of the user groups which he belongs to.
71
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 15. Plug-in NetPublisher
Chapter 15. Plug-in NetPublisher
NetPublisher is the client input plug-in for the Net Receiver Media Session of Multistream Servers. The
interaction of both plug-ins is shown in Figure 15.1, “Interaction of NetPublisher and Net Receiver Media
Session ” [72].
A NetPublisher client must be configured for a special Net Receiver Media Session. But a Net Receiver
Media Session is able to recieve the video streams of several clients.
Note
The video stream transmission from the NetPublisher to the Multistream Server occurs via
HTTP. Thereby local safety barriers (firewall, packet filter, etc.) can be surmounted.
Figure 15.1. Interaction of NetPublisher and Net Receiver Media Session
The properties of the NetPublisher plug-in are configured by a wizard during the creation process and
can be edited afterwards with this dialogue.
After selecting the main context menu entry Change plug-in, the window shown in Figure 15.2, “Plugin NetPublisher configuration dialogue” [72] appears.
Figure 15.2. Plug-in NetPublisher configuration dialogue
72
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 15. Plug-in NetPublisher
Address*: This field contains the IP address and port (example 192.x.x.x:8080) of the Multistream
Server.
Session name: Name of the Net Receiver Media Session for which the NetPublisher is configured as
an input client.
Source name: Name of the connected video source. The name can be freely allocated.
Source ID: The field contains the ID of the video stream which should be displayed if the connected
video source delivers multiple streams.
Primary channel only: If this checkbox is active only the primary channel will be streamed to the server.
Message length (sec): The selection buttons are used to set the message length in seconds of the
transmitted video stream. The packages will be transmitted in this way to the Multistream Server.
The settings will be assumed with the Apply button.
The Abort button can be used to abort the process.
73
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 16. Plug-in Recorder
Chapter 16. Plug-in Recorder
The Recorder plug-in is made for recording video streams of different input sources.
16.1. Add plug-in / edit properties
The Recorder plug-in properties are configured by a wizard during the creation process and can be
edited afterwards with this dialogue.
After selecting the plug-in entry Change Plug-in out of the plug-in context menu, the window shown in
Figure 16.1, “Plug-in Recorder” [74] appears.
Figure 16.1. Plug-in Recorder
Autostart: If this option is active the video recording will be started automatically at the start of the
Media Application.
Path: The text field contains the storage directory of the recording file. The directory selection occurs
via a search dialogue which is opened by clicking on the Browse button.
File name: The text field contains the name and format (e.g. avi) of the recording file. The following
replacement characters are usable:
$CHANNELS$
Name of the current video channel
$PROVIDER$
Name of the video provider (DVB specific)
74
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 16. Plug-in Recorder
%b
Name of the month (shortcut)
%B
Name of the month
%d
Day of the month
%H
Hour in 24 hour format
%m
Month (01 - 12)
%M
Minutes
%S
Seconds
%y
Time
%Y
Year as a 2-digit number
Note
The table information can also be seen in the Recorder window with the
button.
File container format: The video file format can be set here in the form of a format extension. It is
possible to name more than one format. In this case the first format will be preferentially used. If this
is not possible, the next format follows and so on.
Save elementary stream: If this option is active, the elementary data streams (audio, video,...) will be
stored too.
File limit
Both selection fields in the File limit area can be used to set the maxium file size (in MBytes) and the
recording time (in minutes).
The user can choose one of the following settings:
• Max. file volume (MByte): unlimited, 600, 1000 and 4000
• Max. recording time (Min):unlimited, 60, 120 and 240
Autodelete
Note
The plug-in area Autodelete is important for permanent recording.
The user can set the options for autodelete in this part of the wizard. The checkbox Enable autodelete
activates the functionality. The storage time of the recorded file can be set in the field Lifetime(min).
The Back button can be used to return to the previous dialogue.
The settings are assumed with the Confirm button. Afterwards the plug-in Recorder is visible in the tree
view of the respective bcDTVLink instance.
The process can be aborted with the Abort button.
75
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 16. Plug-in Recorder
Note
All * marked fields are mandatory fields, i.e. they must be filled.
76
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 17. Plugin RTSP Receiver
Chapter 17. Plug-in RTSP Receiver
The RTSP Receiver plug-in allows to the receiving of video via the Real-Time Streaming Protocol
(RTSP). One possible source of such streams is the Multistream Server (Chapter 14, Plug-in
Multistream Server [59]) with a RTSP Live Media Session.
Figure 17.1. RTSP Receiver plug-in wizard
The configuration of a RTSP Receiver is done in 2 steps (Figure 17.1, “RTSP Receiver plug-in
wizard” [77]): First one or more channels can be created. Each channel has a name and a URL,
which point to the source of the RTSP video stream. After that, the following options are configurable:
Authorization
User name and password are deposited here if the video source demands authorization.
The encryption level of the data transmission can be set by activating or deactivating the options Basic
or Digest. With the authorization level Basic, the username and password are sent directly to an RTSP
server (e.g. Multistream Server, RTSP Media Session). Basic is a very simple but unsafe authorization
method. With the authorization level Digest, the username and password are encrypted and sent to
an RTSP server (e.g. Multistream Server, RTSP Media Session). Digest is a complicated but safe
authorization method.
RTP and RTCP
RTP: The RTSP Receiver uses buffers for receiving the video. In some situations you may need to
change these values - especially when you have video in HD.
77
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 17. Plugin RTSP Receiver
RTCP: As well as the buffer for the video there is a buffer for the control commands.
Transport
This area contains settings for the type of data stream transport. Depending on the network environment
and the kind of network communication (unicast or multicast) the user can change between unicast,
multicast and interleaved mode. The sequence in the selection field shows the priority of the transport
method (first = "most prefered"). The interleaved mode should be used when the receiver and the video
source are not in the same sub net.
If the transport method Multicast was selected, it is better to select the option Query Multicast Address
as well and to add the address of the destination server (e.g. 329.0.0.1) in the field behind.
Further options
Send "Options": If this option is active, a client request to the server according to options (server
methods and commands) occurs.
Ignore "Content-Base": If this option is active, an alternative content (audio/video) interpretation takes
place. This option can help to solve conflicts of servers with several network cards.
Ping with "GET_PARAMETER": If this option is active, a ping will be sent periodically to the server
to find out if the server is still available.
Accept"Redirect": If this option is active, the server sends a message saying that the content (video/
audio) is available on another server.
Cache addresses: This option activates buffering from network addresses.
AV-Sync (lip-sync): This option activates the synchronization of video and audio streams with RTCP.
The configuration can be saved by clicking on the Finish button.
78
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 18. Plugin Traficon Vip-T
Chapter 18. Plug-in Traficon Vip-T
The plug-in Traficon Vip-T makes it possible to use connected Vip-T devices by Traficon as the input
video source.
Note
The Traficon Vip-T plug-in requires a separate license.
18.1. Add plug-in / edit properties
The Traficon Vip-T properties will be configured by a wizard during the creation process and can be
edited afterwards with these dialogues.
After selecting the main context menu entry Change plug-in, the window shown in Figure 18.1, “Network
address of the Traficon Vip-T device”[79] appears. The IP address of the input stream can be edited
here.
Figure 18.1. Network address of the Traficon Vip-T device
Address*: The IP addresse (> 224.x.x.x) of the input stream will be entered in this text field.
Note
The network address needs the attachment rtsp://!
79
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 18. Plugin Traficon Vip-T
The settings can be stored with the Finishbutton. Other properties can be changed with the next dialogue
(see Figure 18.2, “Further properties of the Traficon Vip-T plug-in”[80]). It can be opened with the
Next button.
Figure 18.2. Further properties of the Traficon Vip-T plug-in
Authorization
User name and password are deposited here if the video source demands authorization.
The encryption level of the data transmission can be set by activating or deactivating the options Basic
or Digest. With the authorization level Basic, the username and password are sent directly to an RTSP
server (e.g. Multistream Server, RTSP Media Session). Basic is a very simple but unsafe authorization
method. With the authorization level Digest, the username and password are encrypted and sent to
an RTSP server (e.g. Multistream Server, RTSP Media Session). Digest is a complicated but safe
authorization method.
RTP und RTCP
The adjustable values in the RTP and the RTCP area represent socket parameters that can be used to
optimise network data traffic. The following configurations are possible:
-1: The value range will be set automatically up to MTU size.
0: The parameter will be not set.
a KB value: Manual value range input in KB.
80
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 18. Plugin Traficon Vip-T
Transport
This area contains settings for the type of data stream transport. Depending on the network environment
and the kind of network communication (unicast or multicast) the user can change between unicast,
multicast and interleaved mode. The sequence in the selection field shows the priority of the transport
method (first = "most prefered"). The interleaved mode should be used when the receiver and the video
source are not in the same sub net.
If the transport method Multicast was selected, it is recommended to select the option Query Mulicast
Address as well and to add the address of the destination server (e.g. 329.0.0.1) in the field behind.
Further options
Send "Options": If the option is active, the client asks for server options (server methods and
commands).
Ignore "Content-Base": If this option is active, the content (audio/video) will be interpreted in an
alternative way. This option can be useful to solve conflicts of servers with more than one network
interface card.
Ping with "GET_PARAMETER": If this option is active, the server will be pinged periodically to see
its availability.
Accept "Redirect": If this option is active, the server sends a message saying that the content (video/
audio) is on another server.
Cache Addresses: This option activates the latching of network addresses.
AV sync (lip-sync): This option activates the synchronisation of video and audio streams via RTCP.
The Back button can be used to return to the previous dialogue.
The settings are assumed with the Finish button.
The process can be aborted with the Abort button.
All * marked fields are mandatory fields, i.e. they must be filled.
Areas which are not available are greyed out.
81
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 19. Transcoder
Chapter 19. Transcoder
Note
Transcoding video streams needs a lot processing power !
A transcoder will be used to transform an input data stream of any format into an output data stream
of any format.
Thereby the decoder and encoder will be interlinked in this way so that the input format becomes the
desired output format.
EXAMPLE: A MPEG-2 video stream should be transcoded into H.264. For this, a MPEG–2
decoder is required whose output is connected to a H.264 encoder. This construct will then be
realized then in bcVSS by a transcoder configuration (see Figure 19.2, “Create a transcoder - XML
configuration” [84]).
Beside this structural description, there is a declaration which describes the Transcoder interface to
the Media Application or to the user, respectively (see Figure 19.1, “Transcoder declaration for Media
Application” [82]).
Figure 19.1. Transcoder declaration for Media Application
The following settings can be adjusted via the mask fields:
Name: This field contains the name of the transcoder.
Active: This option shows if the transcoder is active or not.
Transcoder-Typ: The data streams or parts of them which should be transcoded can be set here. The
choices are:
82
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 19. Transcoder
• EDTVLinkTranscoderType_Substream: Only the substream which is entered in InputSubStreamId
field will be transcoded.
• EDTVLinkTranscoderType_Stream: Only the input stream (channel) which is entered in
InputStreamName will be transcoded with all its substreams.
• EDTVLinkTranscoderType_Global: All data streams of the input source which is entered in
InputSourceName field will be transcoded.
Input type: This selection field is used to choose the input stream type (video, audio oder
other data stream). The following types can be chosen: EDTVL_SUBSTREAM_TYPE_UNKNOWN,
EDTVL_SUBSTREAM_TYPE_VIDEO and EDTVL_SUBSTREAM_TYPE_AUDIO.
InputFCCs: This field contains the format of the input stream (e.g. MJPG, MPEG2, ...).
InputSourceName: This field contains the name of the DTVLink input plug-in (e.g. BDA, Capture, ...).
If it is empty, all DTVLink input plug-ins are possible input sources.
InputStreamName: This field contains the name of the input stream (e.g. a TV channel name like ZDF).
The input stream name comes from the source. If the field isn't defined, all channels are accepted.
InputSubStreamId: The InputSubStreamID is only relevant, if there are several tracks (audio - audio
tracks; video - format tracks) inside the input streams. In this case, it is possible to separate them by
using an ID at this place.
InputFCCMap: The format identifiers of the input stream can be changed by editing this field.
OutputFCCMap: The format identifiers of the output stream can be changed by editing this field.
The second dialogue (see Figure 19.2, “Create a transcoder - XML configuration”[84]) is opened
by a clicking on the Next button.
The XML trancoder configuration must be entered into the empty text field. An XML transcoder
configuration example can be chosen via the selection field.
Note
The XML trancoder configuration is necessary and very individual. It must be customized to the
respective system.
83
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 19. Transcoder
Figure 19.2. Create a transcoder - XML configuration
XML description of a Trancoder
The XML description of a Transcoder shows the following XML tags with their respective attributes:
Topology: Is the encircling XML construct which describes a Transcoder. It has no own attributes.
Filter: Describes a single chain link of the Transcoder. It is used to consecutively declare all decoder,
encoder or other used Windows Media® filters. The XML object filter has the following attributes:
• guid: Windows GUID of the respective filter.
• Name: A unique name of the filter which is necessary for object referencing.
Connection: Describes a connection between 2 filter objects. The XML object filter has the following
attributes:
• SrcFilter: The name of the input filter object (see filter, attribute Name)
• SrcPin: The Pin of the source filter which a following filter can be connected to. The indication of the
Pin can be done by its name (see example 1) or by its index (see example 2).
• DstFilter: The name of the output filter object.
• DstPin: The Pin of the destination filter which a source filter needs to be connected to. The indication
of the Pin can be done by its name (see example 1) or by its index (see example 2).
Note
The filter objects Source and Sink are created automatically and don't need to be described
separately. There should always be exactly one Source and one Sink (see graph theory in
http://en.wikipedia.org/wiki/Graph_theory).
84
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 19. Transcoder
Example 1 - Decode and encode with ffdshow
Note
ffdshow software must be configured first for this.
<Topology>
<Filter guid="{BECD3686-53B3-4C9E-935F-A69E06BFB44A}"
Name="bitcontrol Video Decoder" />
<Filter guid="{4DB2B5D9-4556-4340-B189-AD20110D953F}"
Name="ffdshow video encoder" />
<Connection SrcFilter="Source" SrcPin="Output"
DstFilter="bitcontrol Video Decoder" DstPin="Video In" />
<Connection SrcFilter="bitcontrol Video Decoder" SrcPin="Video Out"
DstFilter="ffdshow video encoder" DstPin="In" />
<Connection SrcFilter="ffdshow video encoder" SrcPin="Out"
DstFilter="Sink" DstPin="Input" />
</Topology>
Example 2 - Decode of MJPEG and encode with ffdshow
<Topology>
<Filter guid="{301056D0-6DFF-11D2-9EEB-006008039E37}"
Name="MJPEG Decompressor" />
<Filter guid="{4DB2B5D9-4556-4340-B189-AD20110D953F}"
Name="ffdshow video encoder" />
<Connection SrcFilter="Source" SrcPin="Output"
DstFilter="MJPEG Decompressor" DstPin="#0" />
<Connection SrcFilter="MJPEG Decompressor" SrcPin="#0"
DstFilter="ffdshow video encoder" DstPin="#0" />
<Connection SrcFilter="ffdshow video encoder" SrcPin="#0"
DstFilter="Sink" DstPin="#0" />
</Topology>
Example 3 - Decode with bitcontrol® Audio Video Decoder (it
means MPEG–2, MPEG–4, H263 or H.264) and encode with ffdshow
<Topology>
<Filter guid="{BECD3686-53B3-4C9E-935F-A69E06BFB44A}"
Name="bitcontrol Video Decoder" />
<Filter guid="{4DB2B5D9-4556-4340-B189-AD20110D953F}"
Name="ffdshow video encoder" />
<Connection SrcFilter="Source" SrcPin="Output"
DstFilter="bitcontrol Video Decoder" DstPin="Video In" />
<Connection SrcFilter="bitcontrol Video Decoder" SrcPin="Video Out"
DstFilter="ffdshow video encoder" DstPin="In" />
85
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 19. Transcoder
<Connection SrcFilter="ffdshow video encoder" SrcPin="Out"
DstFilter="Sink" DstPin="Input" />
</Topology>
Example 4 - Decode with bitcontrol® Audio Video Decoder
(it means MPEG–2, MPEG–4, H263 or H.264) and encode with
nanocosmos video encoder
<Topology>
<Filter guid="{BECD3686-53B3-4C9E-935F-A69E06BFB44A}"
Name="bitcontrol Video Decoder" />
<Filter guid="{A88889A8-3C2A-4A32-8EAA-755D491D02A0}"
Name="nanocosmos Video Encoder" />
<Connection SrcFilter="Source" SrcPin="Output"
DstFilter="bitcontrol Video Decoder" DstPin="Video In" />
<Connection SrcFilter="bitcontrol Video Decoder" SrcPin="Video Out"
DstFilter="nanocosmos Video Encoder" DstPin="In" />
<Connection SrcFilter="nanocosmos Video Encoder" SrcPin="Out"
DstFilter="Sink" DstPin="Input" />
</Topology>
Example 5 - Decode with Divx decoder and encode with ASFWriter
into WMV and push to Windows Media® service
<Topology>
<Filter Name="Source" guid="Source" />
<Filter guid="{6F513D27-97C3-453C-87FE-B24AE50B1601}" Name="Decoder" />
<Filter Name="WMVEncoder" guid="{7C23220E-55BB-11D3-8B16-00C04FB6BD3D}">
<WMAddPushSink URL="http://192.168.1.53/WMV_Test" User="Admin"
Password="secret" />
<profile version="589824" storageformat="1"
name="PAL 160x120 CBR 300K V8" description="">
<streamconfig majortype="{73646976-0000-0010-8000-00AA00389B71}"
streamnumber="1" streamname="Video Stream" inputname="Video"
bitrate="291000" bufferwindow="8000" reliabletransport="0"
decodercomplexity="AU" rfc1766langid="en">
<videomediaprops maxkeyframespacing="3000000"
quality="80" />
<wmmediatype subtype="{32564D57-0000-0010-8000-00AA00389B71}"
bfixedsizesamples="0" btemporalcompression="1" lsamplesize="0">
<videoinfoheader dwbitrate="291000" dwbiterrorrate="0"
avgtimeperframe="400000">
<rcsource left="0" top="0" right="160" bottom="120" />
<rctarget left="0" top="0" right="160" bottom="120" />
<bitmapinfoheader biwidth="160" biheight="120"
86
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 19. Transcoder
biplanes="1" bibitcount="24" bicompression="WMV2" bisizeimage="0"
bixpelspermeter="0" biypelspermeter="0" biclrused="0"
biclrimportant="0" />
</videoinfoheader>
</wmmediatype>
</streamconfig>
</profile>
</Filter>
<!-- Connect pins -->
<Connection SrcFilter="Source" SrcPin="Output" DstFilter="Decoder"
DstPin="#0" />
<Connection SrcFilter="Decoder" SrcPin="#0" DstFilter="WMVEncoder"
DstPin="#0" />
</Topology>
87
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 20. Scripting
Chapter 20. Scripting
The chapter Scripting describes the features to control the functions of a bcVSS instance using internal
scripts.
The bcVSS server and the configuration UI include the ability to use functions of the configured objects
of the server via Java Script. For this purpose, the script engine contains the bcVSS as a Java object in
their global programming context. The Java object allows the full access to all Java member functions
of the object and the contained objects.
20.1. Managing scripts inside the media navigator
Scripts are included as special objects in the media navigator objects hierarchy. The root element for
scripts is the directory object Scripts as shown in the figure below:
Figure 20.1. Script object in the media navigator
Access to a single script object occurs via the context menu inside the media navigator.
The command New is extended with a new sub command to create a new script object. A wizard, will be
shown. Inside the wizard the name of the new script and an optional description text will be requested.
88
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 20. Scripting
Figure 20.2. Wizard to create a new script
A script will be identified via name. The name has to be unique inside the bcVSS instance. The wizard
will prevent the creation of a new script using the name of an existing script object.
After the creation, the new script object appears in the navigator tree and can be edited by using
functions of the script context menu.
89
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 20. Scripting
Figure 20.3. Script object context menu
Edit script: Shows a new editor view, including the source code of the script, in a source code editor.
Remove script: After a security confirmation dialog the selected script object will be permanently
remove from the server configuration.
Rename script: Asks for a new name for the selected script object using a requesting dialog. The name
of the script object will be changed after confirming this dialog.
Duplicate script: Asks for a name for the new copy of the selected script object. After confirmation a
new object will be created using the source code of the original object.
Run script: Runs the selected script.
90
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 20. Scripting
Figure 20.4. Execution of a script object via media navigator
A confirmation dialog will inform the user that only a saved state of the script object may be executed.
Changes in an open editor will be ignored.
20.2. Edit scripts in the editor view
A special source code editor is provided for editing purposes. The editor will be presented inside the
upper right view area of the UIs media perspective.
91
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 20. Scripting
Figure 20.5. Script editor
The UI allows several editor views but only one per script object.
The editor supports default functions of a source code editor including syntax highlighting and bracket
matching. Additional functions are provided in the toolbar of the editor view.
Figure 20.6. Toolbar actions of the script editor view
Save: Saves the source code which was entered in the editor text area. This action will be enabled
after the first change of the source code.
Help: Activates the help system of the server. The help content will be presented inside a non-modal
dialog area or an external browser window depending on the preferences defined for the server. The
help content includes an API reference of the bcVSS model implementation. All presented model objects
are accessible using the base bcVSS Java object presented in the global context of the script engine.
Run script: Runs the script shown in the editor area. This action is only enabled for saved script objects.
Starting a script with pending changes will be prevented. The user will be informed with a standard
message dialog.
20.3. bcVSS scripting basics
Scripts inside a bcVSS instance will be created with Java Script. All features of the basic language are
available. The inclusion of other scripts or external java script libraries is not supported. Java libraries
and Java classes may be included using import statements.
92
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 20. Scripting
The global context of the script engine provides a Java object bcvss with the class type EBcVss
representing the server itself. By using the functions of this object, all Media Application instances and
their functions can be accessed. Detailed information about the available objects are described in the
API reference included in the help system.
20.3.1. Samples
Activation of a Media Application
The script extracts a special link out of the server Media Applications. For this, the list with all links will
be iterated and each link name composed with the searched one.
importPackage(java.lang);
importPackage(com.bitctrl.bcvss.modell.bcvss);
importClass(com.bitctrl.bcvss.modell.bcvss.EDTVLink);
for(var i = 0 ; i < bcvss.getDtvlinks().size();i++) {
link = bcvss.getDtvlinks().get(i);
if ( link.getName().equals("Fernseher")) {
link.setState(EDTVLinkState.RUNNING);
break;
}
}
The found link will be activated.
Switching a channel
The script searches the special Media Application named Fernseher and a special channel inside of
that Media Application.
importPackage(java.lang);
importPackage(com.bitctrl.bcvss.modell.bcvss);
importClass(com.bitctrl.bcvss.modell.bcvss.EDTVLink);
for(var i = 0 ; i < bcvss.getDtvlinks().size();i++) {
link = bcvss.getDtvlinks().get(i);
if ( link.getName().equals("Fernseher")) {
for( var pi = 0; pi < link.getPlugins().size(); pi++ ) {
plugin = link.getPlugins().get(pi);
if ( plugin instanceof EDTVLinkPluginWithChannels ) {
for( var ci = 0; ci < plugin.getChannels().size(); ci++ ) {
channel = plugin.getChannels().get(ci);
if ( channel.getName().equals("Das Erste")) {
93
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 20. Scripting
plugin.setActiveChannel( channel );
break;
}
}
}
}
}
}
The found channel will be activated.
Cyclic channel switch with function definition
The script defines a function for switching the Media Application called Fernseher and starting it
cyclically. The loop delay uses additional Java classes.
importPackage(java.lang);
importPackage(com.bitctrl.bcvss.modell.bcvss);
importClass(com.bitctrl.bcvss.modell.bcvss.EDTVLink);
function switchChannel(channelName) {
for(var i = 0 ; i < bcvss.getDtvlinks().size();i++) {
link = bcvss.getDtvlinks().get(i);
if ( link.getName().equals("Fernseher")) {
for( var pi = 0; pi < link.getPlugins().size(); pi++ ) {
plugin = link.getPlugins().get(pi);
if ( plugin instanceof EDTVLinkPluginWithChannels ) {
for( var ci = 0; ci < plugin.getChannels().size(); ci++ ) {
channel = plugin.getChannels().get(ci);
if ( channel.getName().equals(channelName)) {
plugin.setActiveChannel( channel );
break;
}
}
}
}
}
}
}
var counter = 0;
while ( counter < 100 ) {
switchChannel("Das Erste");
Thread.sleep(5000);
switchChannel("arte");
Thread.sleep(5000);
counter++;
94
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 20. Scripting
}
95
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 21. User administration
Chapter 21. User administration
The chapter User administration contains explanations about the specific menu line and about the
functionality of the bcVSS user administration.
Note
Access to the user administration is only allowed for users that are logged in as Administrator.
21.1. User administration perspective context menu
The following actions can be executed via the context menu of the perspective User administration:
Symbol
Action
Note
Change user data
The action is only active if a user was chosen!
Delete user
The action can't be done for users of the Administrators group!
Add user
More information about the mentioned actions can be found in Section 21.3, “User” [96].
21.2. User groups
A user group is represented via the
symbol.
A user can be allocated to one of the following user groups:
Name
Right
Administrator
Owns unlimited user rights
Operator
Owns the rights to configure but has no user rights
Spectator
Is only able to see the tree structure inclusive its Media Application
instances and the documentation
VideoViewer
Is only able to watch video streams
Note
User groups don't have their own context menu!
21.3. User
A bcVSS user is represented inside its user group via the
96
symbol.
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 21. User administration
21.3.1. Add / edit user
After the symbol was selected from the context menu of the perspective User administration, the
following dialogue (see Figure 21.1, “Add user / Edit user data” [97]) appears.
Figure 21.1. Add user / Edit user data
Login: User name which is also shown in the tree view.
Name: Real user name
Password: User password for bcVSS login
Password (Repeat): Password verification by retyping the entered password
User group: User group selection via selection field (see Section 21.2, “User groups” [96])
The settings will be assumed with the Confirm button. Afterwards the new user is visible in its user group.
The process can be aborted with the Abort button.
Note
All * marked fields are mandatory fields, i.e. they must be filled.
The next picture (see Figure 21.2, “Example - Added user”[97]) shows an example of an added
bcVSS user.
Figure 21.2. Example - Added user
97
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 21. User administration
21.3.2. User contect menu
The following functions can be executed via the users context menu:
Delete user Name: If this entry was selected, the chosen user will be permanently deleted from
its user group and the bcVSS.
Change user data: Selecting the entry Change user data out of the users context menu opens a
dialogue (similar to the dialogue in Section 21.3.1, “Add / edit user”[97]) where the user data settings
can be edited.
98
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 22. Logger
Chapter 22. Logger
The tree view of the perspective Logger represents the internal bcVSS module hierarchy. Usually it's
unused.
The information view of the perspective Logger shows a list of all received messages (see Figure 22.1,
“Log messages in tree view” [99].
Figure 22.1. Log messages in tree view
The following messages are possible:
Symbol
Level
Description
FATAL
Only shows fatal errors.
ERROR
Only shows errors.
WARN
Only shows warnings.
INFO
Only shows information.
DEBUG
Only shows debug information.
The message table can be sorted by columns . It is also possible to search for a special message by
99
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 22. Logger
• Section 22.2, “Message filter” [100] and/or
• Section 22.3, “Level filter” [100]
22.1. Logger perspective context menu
The complete logger table in the information view can be updated with the
symbol.
22.2. Message filter
The user can enter a term for the searched message into the text field Message filter and execute the
search via the Search button. All messages which contain the search term will be shown as results.
To increase the search results, the use of * (wildcards) is allowed.
Figure 22.2, “Example - Search for the term DTVLink*”[100] shows the result of the message search
for the term DTVLink.
Figure 22.2. Example - Search for the term DTVLink*
22.3. Level filter
The user can search for message types via the selection field Level filter (see table in Chapter 22,
Logger [99]) heraussuchen. The example Figure 22.3, “Message selection by messge type” [100]
shows the search for the message type DEBUG (
symbol).
Figure 22.3. Message selection by messge type
It is possible to combine the methods Meldungs filter and Level filter (see Figure 22.4, “Selection by
search term and message type” [101]).
100
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 22. Logger
Figure 22.4. Selection by search term and message type
101
bitcontrol® Video Streaming
Server (bcVSS)
User manual
Chapter 23. Documentation
Chapter 23. Documentation
By using the entry Documentation in the bcVSS perspective bar, the user receives HTML views of the
bitcontrol® Video Streaming Server documentations (see Figure 23.1, “HTML version of the bcVSS user
manual (detail)” [102] ). These are the bcVSS model API reference which is necessary to create Java
Scripts for bcVSS, and this user manual.
Figure 23.1. HTML version of the bcVSS user manual (detail)
102
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising