Viz Pilot User Guide
Version 8.3 | Published November 30, 2018 ©
Media Sequencer Configuration
The Media Sequencer Configuration window is used to configure the Media Sequencer enabling Director to connect to other devices. This can for example be a newsroom integration with connections to Viz Gateway, a connection to the Viz Pilot database, a GPI configuration of a GPI card on the Media Sequencer and so on.
In Director, open it from the main menu > Tools > Media Sequencer Configuration.
This section contains the following topics:
-
Database Tab
-
Viz One Tab
-
MOS Tab
-
General Purpose Input (GPI Tab)
-
Video Disk Control Protocol (VDCP Tab)
Database Tab
Main menu > Tools > Media Sequencer Configuration > Database.
The Database tab sets the database connection for the Media Sequencer.
If the information was added during the Viz Pilot System Installation the information is made available in this window; however, it must be manually applied.
The properties available depend on whether you are using Media Sequencer 4.0 and later or Media Sequencer 3.x and earlier.
Media Sequencer 4.0 and later
If using Media Sequencer 4.0 or later, the Database tab allows you to configure whether the Media Sequencer will fetch data elements directly from an Oracle database or via a Pilot Data Server.
Note that:
-
If Director is connected to a Graphic Hub, the Media Sequencer must connect to a Pilot Data Server that is connected to the same Graphic Hub as Director.
-
If Director is connected to an Oracle database, the Media Sequencer must connect to the same schema on the Oracle database, or connect to a Pilot Data Server that is connected to the same schema.
Properties and Parameters
-
Pilot Data Server: Connect to the database through a Pilot Data Server. Enter the host name and port of the Pilot Data Server
-
Oracle: Connect to an Oracle database directly.
-
Connection String: The connection string for Oracle, e.g. pilot/pilot@<hostname>/<SID>.
-
Schema: The name of the Oracle schema, e.g. PILOT.
-
-
Immediately remove deleted elements: Elements that are deleted from the database will be removed from the Media Sequencer.
Media Sequencer 3.x and earlier
Note: If you are using Graphic Hub as the Pilot database you must use Media Sequencer 4.0 or later.
If using Media Sequencer 3.x or earlier, the Database tab sets the database connection for the Media Sequencer and contains the following Properties:
-
Connection string: Use a regular connection string or a TNS name alias.
-
Example 1: pilot/pilot@<hostname>/<SID>
-
Example 2: pilot/pilot@<tnsname alias>
-
-
Schema: PILOT
-
Database encoding: The current database and application client encoding settings. The application encoding settings can be changed in the ContentPilot.ini file if the database has another Unicode encoding than UTF8; however, it is recommended to use Unicode encoding UTF8 on both ends.
To apply the Viz Pilot Database settings
-
Select the Media Sequencer Configuration option from the Tools menu.
-
Select the Database tab, and enter the database settings.
-
Click Apply.
Viz One Tab
Main menu > Tools > Media Sequencer Configuration > Viz One.
The Viz One tab sets the Viz One connection for the Media Sequencer. The Viz One connection enables the Media Sequencer to request transfer of media to Viz Engine for playout.
Note: Director and Viz Pilot News get their Viz One connection parameters from the Viz Pilot database.
Properties and Parameters
-
Enable the Viz One handler: Enables Media Sequencer to handle Viz One transfer requests.
-
Service document URI: Sets the service document URI which describes the services the search will provide.
To apply the Viz One settings
-
Select the Media Sequencer Configuration option from the Tools menu
-
Select the Viz One tab
-
Click the asset search provider link
-
From the web page (under Search Providers) copy the relevant asset search provider URL and paste it into the Service document URI field in the Viz One tab.
-
Click Apply.
Working with Viz One
The Viz Pilot system (5.6 and later) is able to connect to media providers and repositories, such as Viz One, that support the Pilot Data Server REST API.
In order to successfully connect to Viz One do the following:
-
Install and configure your media provider (e.g. Viz One)
-
Install and configure your Pilot Data Server by configuring Viz One as a search provider (see To configure search providers (Viz One)). See the Pilot Data Server documentation.
-
Configure Director’s Viz One Tab connection (see .Media Sequencer Configuration v8.3) in order for Media Sequencer to request transfer of video files from Viz One to your configured Viz Engine for playout
-
Configure your Viz Engine to enable transfer of video files over FTP from Viz One to Viz Engine for playout
-
Configure your Director’s output channels in order to playout video clips from the Viz Engine storage points where Viz One files are sent for playout (see Profile Configuration).
In case you are using Viz Engine to preview video clips from Viz One locally you also need to install Video Codecs Installation (e.g. MPEG-4 codec and Haali Media Splitter).
MOS Tab
Main menu > Tools > Media Sequencer Configuration > MOS.
e
The MOS tab enables the Media Sequencer to connect to Viz Gateway. If configured to use Viz Gateway 1.0, the newsroom system and Viz Gateway must be pre-configured with an NCS ID and MOS ID. For connections to Viz Gateway versions 2.0 and later, only the Viz Gateway host and port number is needed.
Note: MOS IDs are configured on the NCS server, and are usually case sensitive.
Properties and Parameters
-
Enable Gateway Configuration: When selected, enables the user to configure the Viz Gateway connection.
-
Viz Gateway Connection: The controls in the Viz Gateway Connection section allows a start, stop, and restart action to be performed on a Viz Gateway connection.
-
Start: Starts a connection to Viz Gateway.
-
Stop: Closes a connection to Viz Gateway.
-
Restart: Restarts a connection to Viz Gateway.
-
-
Viz Gateway Connection Config: Define Viz Gateway connection settings
-
Messages per second limit (0=disabled): Sets how many messages per second should be sent from Viz Gateway to the NCS. This is done to prevent flooding of the NCS. 0 disables the message throttling allowing unlimited messages per second
-
Viz Gateway Host: IP address of the Viz Gateway host.
-
Viz Gateway Port: Connection port for the Viz Gateway.
-
MOS ID: ID of the connecting MOS device.
-
NCS ID: ID of the Newsroom Control System (NCS).
-
-
Send status changes back to NCS: Sends new status changes to the NCS.
-
Send channel assignment changes back to NCS: Sends changes to the NCS.
IMPORTANT! A database connection must be established in order for the MOS integration to work. See how To apply the Viz Pilot Database settings for details.
To configure a Viz Gateway connection
-
Start Director.
-
Select Profile Configuration from the Tools menu (see Profile Configuration).
-
Click the MOS tab, and enter the appropriate settings collected from the newsroom system and the Viz Gateway host.
-
Click OK and check that the status indicator (G) appears in the lower right of Director’s status bar.
-
Click the Playlists button in the Resource Panel, and check that MOS Playlists are added to the list of available playlists.
General Purpose Input (GPI Tab)
Main menu > Tools > Media Sequencer Configuration > GPI.
The GPI tab allows the Media Sequencer to be configured to handle GPI commands. The commands can be handled by the Media Sequencer itself (Server Command) or forwarded to Director (Macro Command).
Both server and client side commands are profile specific, meaning that the profile determines which Director client and potentially which Viz Engine(s) that should execute a client and/or server command. It is therefore very important to assign the correct profile for each GPI action as they refer to unique profiles configured per Director client.
For example; A Director has its own profile with two Viz Engines (program and preview) and receives a client command from a GPI on the Media Sequencer. The command executes some logic on Director that issues commands to the program renderer. If the correct profile is not set, such commands might end up on the wrong Director and potentially on the wrong program renderer. The same would happen if the GPI action was defined as a server command; however, it would then trigger commands from the Media Sequencer to the Viz directly and not through Director.
This section contains the following topics:
-
Properties and Parameters
-
To assign a Server Command
-
To assign a Client Command
-
To add a macro command
Properties and Parameters
-
Show advanced: Displays all the settings in the GPI tab.
-
Box Type: Select the type of GPI box that is being configured. The Box Type can be set to SRC-8, SRC-8 III or SeaLevel.
-
Port: Sets the port that the GPI box is connected to. The Port can be set to COM1-COM17, or None.
-
Base Entry: This is the node in the Media Sequencer’s data structure where the systems look for the GPI actions. The base entry is by default set to /sys/gpi.
-
Baudrate: Sets the maximum rate of bits per second (bps) that you want data to be transmitted through this port. The Baudrate can be set to 110-921600. It is recommended to use the highest rate that is supported by the computer or device that is being used.
-
Stopbits: Sets the interval (bps) for when characters should be transmitted. Stopbits can be set to 1, 1.5, or 2.
-
Databits: Sets the number of databits that should be used for each transmitted and received character. The communicating computer or device must have the same setting. The number of databits can be set to 5, 6, 7 or 8.
-
Parity: Changes the type of error checking that is used for the selected port. The communicating computer or device must have the same setting. The parity can be set to:
-
Even: A parity bit may be added to make the number of 1’s in the data bits even. This will enable error checking.
-
Odd: A parity bit may be added to make the number of 1’s in the data bits odd. This will enable error checking.
-
None: No parity bit will be added to the data bits sent from this port. This will disable error checking.
-
Mark: A parity bit set to 0 will be added.
-
Space: A parity bit set to 1 will be added.
-
-
Flowcontrol: Changes how the flow of data is controlled. The Flowcontrol can be set to:
-
None: No control of dataflow.
-
XonXoff: Standard method of controlling the flow of data between two modems. XonXoff flowcontrol is sometimes referred to as software handshaking
-
Hardware: Standard method of controlling the flow of data between a computer and a serial device. Hardware flowcontrol is sometimes referred to as hardware handshaking.
-
-
Verbose: If enabled, Media Sequencer’s GPI handler outputs log information. This information is useful for debugging.
-
Reversed Input Order: Note that this check box is only available if Box Type is set to SRC-8. If enabled, the signal line that originally triggered GPI action DL0/DH0 will now trigger GPI action DL7/DH7, the signal line that originally triggered GPI action DL1/DH1 will now trigger GPI action DL6/DH6, and so on.
Commands and actions list:
-
GPI action: Shows a list of the available GPI actions.
-
Server/Client: Shows a drop-down list box in every row. This determines whether the selected GPI action will apply to the Media Sequencer (Server option) or the local Director (Client option).
Note: The server and client actions are reciprocally exclusive.
Note: GPI actions for the Client option will only work if Director is running.
-
Server Command: Shows a drop-down list box in every row, where the action to be performed on this GPI line can be selected. Server commands are GPI actions that apply to the Media Sequencer. When right-clicking an item in the playlist, the Playlist menu opens. In this menu, select Cursors, and then Set Next. An arrow appears next to the selected element in the playlist, which indicates that this is the current GPI cursor. The server commands can be set to:
-
take_and_advance: Runs the Start operation on the current element, and then shifts to the next element in the playlist.
-
take_current: Runs the Start operation on the current element (the element with the cursor).
-
next: Shifts to the next element in the playlist.
-
previous: Shifts to the previous element in the playlist.
-
continue: Runs the Continue operation on the current element.
-
out_current: Runs the Take Out operation on the current element.
-
-
Macro Command: Macro commands are silent GPI actions. Clicking the ellipsis (...) button opens the Add Command window.
-
Profile: Sets the profile to be used for the GPI action. This profile must match the profile set for the playlist that is to be triggered by the GPI actions. The drop-down list shows the profiles configured on Media Sequencer.
-
Description: Shows the description of the GPI action, as it was specified in the Add Command window.
To assign a Server Command
-
Select a GPI action, and select Server in the Server/Client column.
-
Select a Server Command.
-
Select a Profile.
-
Click Apply.
To assign a Client Command
-
Select a GPI action, and select Client in the Server/Client column.
-
Select or create a Macro Command.
-
Select a Profile.
-
Click Apply.
To add a macro command
-
Select the Macro Command column, and click the small ellipse (...) button to open the Add Command dialog box.
-
Enter the command in the Command text field, or alternatively click the ellipse (...) button to open the Predefined Functions window.
Video Disk Control Protocol (VDCP Tab)
Main menu > Tools > Media Sequencer Configuration > VDCP.
Using Video Disk Control Protocol (VDCP), the Media Sequencer acts like a server that controls the graphics through the VDCP protocol. The Media Sequencer sets up a connection with a video controller, over which VDCP commands are sent, and in this way the video controller is able to communicate with the playlist or show.
Note: The VDCP protocol defines recommended serial settings, but if you need to use different settings please refer to the Media Sequencer manual’s VDCP section, and in particular the section on Electrical and Mechanical Specifications, for information on how to configure this.
This section contains the following topics:
-
VDCP Tab
-
VDCP Properties and Parameters
-
VDCP Macros
VDCP Tab
The VDCP tab always shows an up-to-date status, where changes made by others are shown live. All changes are immediately propagated to the Media Sequencer.
To open the VDCP Tab either:
-
Go to the main menu: Tools > Media Sequencer Configuration > VDCP tab
-
Select Configure VDCP from the playlist’s context menu in Director ***
-
Once VDCP handlers have been defined, click the VDCP Indicator button at the bottom of each playlist ***
-
Not available if using the deprecated Legacy Playlist style.
-
VDCP Properties and Parameters
The configuration consists of the general VDCP settings, and the selection of which playlist to control.
-
VDCP handler: This displays the currently selected VDCP handler. You can change, add or delete multiple VDCP handlers.
-
Enable/Disable handler: The handlers can only be modified when they are disabled.
-
Port: Select the appropriate COM port for the selected VDCP handler.
-
Profile: Select the profile to use. The profile defines the Viz Engines and video devices where the command is to be executed. In the VDCP handler, the configured playlist must be active on the configured profile. (See also Profile Configuration).
-
Element identifier: Use either the element’s name or description as the VDCP ID. The Name is a unique identifier, assigned to each element by the Media Sequencer, whereas the Description is the textual description of the data element, as entered when the item was created in Director/Viz Trio.
-
Use 8 byte IDs: Allow the use of 8 character IDs. For more information about 8 byte IDs and the Media Sequencer VDCP plugin see the “8 characters identifiers” section in the Media Sequencer User Guide.
-
Targets: Select the Director playlists or Viz Trio shows which will be the Primary and Fallback targets.
When the vdcp_client handler receives a command over the VDCP protocol, it iterates over the primary target collection, looking for the element with the specified ID. If a matching item is found, the command is executed on it. If no match is found in the primary target collection, or if there is no primary target collection specified, then it searches the fallback target collection. If there are still no matches, then an error is returned over the VDCP protocol, and it is also reported in the Media Sequencer logs.
Click the buttons next to the primary and fallback target slots to select a playlist or show. Double click a slot to clear it.
A ‘Path not found’ warning, or a missing playlist/show icon, indicates that the selected playlist or show is invalid (eg. playlist has been deleted) -
Target Candidates: Suggests some of the playlists and shows that are available. If you do not find the one you want, use the buttons next to the Primary and Fallback target slots.
Drag a candidate to a target slot or double-click one to make it the Primary target.
VDCP Macros
The following macros provide easy access for turning the VDCP control on and off for an open playlist. They only work with the VDCP handler called vdcp_client. Note that using the VDCP macros will restart the VDCP handler.
vdcp:clear_all_targets, vdcp:clear_primary_target, vdcp:clear_fallback_target, vdcp:set_playlist_as_primary_target, vdcp:set_playlist_as_fallback_target, vdcp:set_primary_target, vdcp:set_fallback_target