CloudTV Player 3.12 User Guide

Introduction

The CloudTV Player™ (CTVP) functions as a combination of a set-top box and TV monitor display, or connected device/connected TV. The CTVP is a stand-alone compiled application that is installed on a desktop computer system. CTVP must connect to a CloudTV server and will also need to be given the URL of the application. The application is then launched from the CloudTV server as it would be within a production environment. The video stream is delivered to CTVP, and CTVP simulates the set-top box by decoding the stream and providing a virtual remote control to interact with the application. Interaction with the application is handled in the same manner as it would be from the CloudTV client installed on a device or set-top box. The user input is sent to the CloudTV server and the stream is updated accordingly. The CTVP runs on Windows and Mac OS. There is also unsupported (experimental) support for Linux.

CloudTV Player can be used to test and optimize applications, by processing them on the CloudTV H5 platform. There are also a number of additional tools useful to developers that are built into the CTVP application. It is highly recommended that developers use CTVP to test their applications running on the CloudTV platform.

The CloudTV Player interface is broken out into four primary sections. Some sections can be hidden with options found in the View menu.

Navigation Bar
The Navigation Bar is where you will enter the Server URL and the Application URL. You will also find the Play/Stop button and Home button located within the Navigation Bar.

Content Pane
This is where the video stream from the CloudTV system will be displayed.

Remote Pane
This pane displays the virtual remote control. The type of remote to display can be selected from the preferences menu or by right-clicking the virtual remote.

Output Pane
The Output Pane includes several tabs to aid in application development and testing.

The navigation bar has six items:

Server URL

Server URL edit box — Enter the URL of the Server the CloudTV Player should connect to, or click the Home button to load the default URL. You may also click the down arrow at the right end of the field to open a listing of the last several URLs that were used, from which you can select one.

server-url 3-6

Server URL pulldown menu

  • Add Current To Server Bookmarks — This will add the current Server URL to the Server URL bookmarks.
  • Show Server Bookmarks — This will bring up a dialog showing saved Server URL bookmarks.
  • Set Protocol — displays a submenu of protocols to choose from. See Preferences > Protocols.

server-url2 3-6

App URL

App URL edit box — Enter the URL that the html5 Server should connect to, or click the Home button to load the default URL. You may also click the down arrow at the right end of the field to open a listing of the last several URLs that were used, from which you can select one (shown below).

Please note that the html5 Server must have network access to this URL. The App URL must be prefaced with "webkit:" which tells the CTVP this is an html5 application. The CTVP will automatically insert the "webkit:" preface into the URL when you click the Play button.

app-url

App URL pulldown menu

When clicked three options are presented (shown below):

  • Add Current To Application Bookmarks — This will add the current App URL to the Application bookmarks.
    *Note: This is only available to the http, rfbtv, and https protocols. Application URLs are not used for bcp or ictvprot protocols.
  • Show Application Bookmarks — This will bring up a dialog showing saved Application bookmarks
  • Protocol Advanced — this screen becomes enabled when either ICTVProt or BCP protocol is selected. For details, see the description of either ICTVProt or BCP under the Preferences > Protocols tab, below.

app-url2

Play/Stop button

CloudTV Play Button

This multi state button Plays/Stops the content stream to the html5 Server.

"Play" makes a connection to the Server URL entered and plays the application located at the URL entered in the App URL field. If any errors occur, a message displays in the status bar explaining the problem.

Home Button

This button loads the default Server URL and App URL defined in the Preferences and triggers the app to begin playing.

Status Bar

The status bar at the bottom of the CloudTV Player interface contains the following information:

  • Session State ("streaming" in the example below)
  • Video format (h264 in the example)
  • Audio format (ac3 in the example)
  • Streaming protocol (http in the example)
  • Bandwidth in kbps (462.15 in the example)
  • Video frames per second (30 fps in the example)
  • The native video resolution (1280x720 in the example)

The Status Bar will also indicates "VR" (video recording), "VP" (video playback), "SR" (script recording), and "SP" (script playback) functions when they are enabled or working.

At the far right end of the Status bar, the Content pane size is indicated. In this example it reads 1280x720. If the window were to be resized, it would reflect the resized window which could be something like 609x634.

status-bar 3-6

Content Pane

This pane displays the video stream from the CloudTV System. The pane can change size, but the aspect ratio of the stream will always be maintained.

Click operations on the Content Pane:

Double-Click — toggles the Content Pane between full screen view (only the content pane will be shown) and normal view.

Right-Click — opens a menu with the following two options:

Toggle Full Screen — toggles the Content Pane between full screen view (only the content pane will be shown) and normal view.

Properties — opens a dialog with the following stream information

  • Video Format — Format of the video (h264, mpeg2 etc.)
  • Audio Format — Format of the audio (ac3 etc.)
  • Native Size — Native size of the video coming into the CTVP.
  • Scaled Size — If the Content Pane is resized, this will show the new video size (taking the aspect ratio into account).
  • Content Area Size — Size of the Content Pane.

Remote Pane

The buttons on the remote control transmit key presses in the format that was specified by the connection. There are currently five remote types available:

  • Full Remote — This remote has most of the buttons found on both Cable/Satellite remotes and remotes that accompany connected consumer electronic devices.
  • Cable/Satellite Remote — This remote has most of the buttons found on Cable/Satellite remotes.
  • Common Remote — This remote has the buttons that are commonly shared between Cable/Satellite remotes and CE remotes.
  • Common Remote — Displays a virtual copy of the Charter Cable remote.
  • Custom Remote — Displays a customizable grid of remote buttons that can be assigned to a number of commands based on the user's needs.

To change the remote type, right-click the remote and select the desired type. The remote can also be changed via Preferences > Display > Remote Type.

Output Pane

The output pane has five tabs: Logging, Bandwidth, CPU, and Memory. The main purpose with the output pane is to display session information from the CloudTV system.

Output Pane: Logging

All console logs and any application errors will show up in the logging window. As keys or buttons are pressed to go up, down, left, or right, and OK, the events are logged. The messages will contain the severity, line number, and the file that caused the log message. Error messages appear in red text; other messages are black.

  • You can search the output using the text input field and the Find button.
  • Enable Match Case or Whole Word to refine your search.
  • The log window can be cleared at any time using the Clear button. The log window will also be cleared automatically on every new connection.

Output Pane: Bandwidth Usage

The bandwidth tab shows a graph of the bandwidth usage of the current application in kilobits-per-second (kbps) over a period of approximately the past 40 seconds. Black vertical lines indicate the key presses that were made. It also shows the last recorded bandwidth value as well as the max and the average. The bandwidth values and graphs will clear on every new connection. The bandwidth tab will alert the user if the max bandwidth value entered in the Preferences > General tab is exceeded.

  • Click on the text boxes to the right to select/deselect graphs to view: blue (bandwidth) or green (1 second rolling average) or both.
  • Click Key Down to view key presses.

 

bandw-1 3-6

 

Output Pane: System Load

The System Load tab shows a graph of the System Load as a percentage over the past 10 minutes. It also shows the last measured level, as well as the max and the average levels. The System Load values and graphs will clear on every new connection. The System Load values are reported by the html5 Server and sent to the CloudTV Player in the private data stream.

  • Click to view System Load (red), divided into three buckets: low, medium, and high. Low load is using less than 33% of CPU, medium uses between 33 and 75%, and high uses more than 75% of CPU.

systemload2 3-6

 

Output Pane: Memory Usage

The Memory tab shows a graph of the Memory usage in MB over the past 10 minutes. It also shows the last recorded Memory value as well as the max and the average. The Memory values and graphs will clear on every new connection. The Memory values are reported by the html5 Server and sent to the CloudTV Player in the private data stream.

  • Click to view Memory Usage (green), which is expressed MB values.

mem-usage 3-6

Output Pane: Internal Logging

The Internal Logging tab log events pertaining to CloudTV Player. This tab can be used to assist in debugging and troubleshooting.

Output Pane: Audio/Video Debug

If enabled in the Preferences > Advanced tab, the Audio/Video Debug tab will also be present in the Output pane. This is a feature that will rarely need to be used. In the event that this info is needed, the Audio/Video debug tab includes the following information:

  • [AV Sync Video Delay [count/s]]
  • [Under Low Audio WM [count/s]]
  • [Over High Audio WM [count/s]]
  • [No Audio Data [count/s]]
  • [New AV Data [kbps]]
  • [Video Buffer [kB]]
  • [Audio Buffer [kB]]
  • [Displayed Frames [count/s]]
  • [Dropped Frames [count/s]]
  • [Framebuffer Size [count]]
  • [Audio Reads [count/s]]Avg. Total Time

The Audio/Video debug tab includes a graph that illustrates Decoder Information in Events Per Second “EPS”.

The menu bar on Mac and Windows differ slightly. On Windows the menu is part of the main window and on Mac it is located on the top (left) part of the screen.

Mac OS Menu Bar
menu

Windows Menu Bar
menu win 3-6

The menu includes the following choices:

File

Here you will find three options. Open, Preferences and Close.

  • Open will open a previously recorded video file. The Video File to Play dialog will prompt you to select the video file.
  • Preferences will open the preferences menu. See Preferences, below.
  • Close will close the CloudTV Player application.

Stream

The Stream menu includes three options.

  • Play — like the Play button, makes a connection to the Server URL entered and play the application located at the URL entered in the App URL field.
  • Stop — like the Stop button, ends a session that is currently playing.
  • Set Protocol — like Set Protocol in the Server URL pulldown menu, you can select http, rfbtv, ictvprot, https, or bcp protocol. For example, selecting http from the Set Protocol menu will add “http://” to the beginning of the server URL or IP address, and the default port value defined in the http protocol settings will be appended to the end of the entered string, if no port is included in the string (in this case, “:8080”).
  • Home — like the Home button, connects to the Server URL and App URL that has been configured as the "Home" connection. This can be set in Preferences > General.
  • Configure Current Protocol — links directly to the protocol options window for the protocol type currently shown in the server url field. This can be set in Preferences > Protocols.

View

The View menu includes various options to select how the video to be streamed will display within the Content pane, as well as the ability to toggle display of various application panes.

  • Full Screen — forces the video being streamed to fill the entire computer display screen or TV screen. Note that the app may appear somewhat pixellated depending on the difference between the resolution of the app and that of the screen. The Esc key will then stop the session and return CloudTV Player to view.
  • Safe Area — displays outlines of both Action Safe and Title Safe areas while a session is streaming within the content pane. The Title Safe area indicates the portion of the screen that can be seen on any tv. The Action Safe area indicates the portion of the screen that could possibly be seen on the tv. Try to keep your objects inside the ActionSafe area. The colors of these outlines can be set in the Preferences > Color Options menu.
  • Dirty Area — displays areas of "dirty rectangles" as content is changed within the stream playing in the content pane. This can be a helpful tool for improving efficiency and scalability of the application by monitoring cache hits and misses within an application. There are color options for this feature within the Preferences menu.
    Dirty Rectangles are momentary rectangular areas highlighting objects on the screen that are refreshed as a result of key presses or selections. This is useful in the effort to optimize the application, reducing the amount of objects that need to be refreshed following each action. For example, if changing the focus of a single button results in the entire screen being refreshed, that is an inefficient use of bandwidth that can be corrected by altering the coding of the app.
  • Macroblock Grid — displays a 16px x 16px macroblock grid that can be used as a visual aid for aligning video and other elements to the mpeg macroblock grid.
  • Screen Size — allows you to select a particular screen resolution to set the size of the Content Pane to. Size options are:
    • Auto Native Size - This will size the Content Pane to the resolution defined on the server you connect to.
    • NTSC 4X3 (640x480)
    • NTSC 16X9 (840x480)
    • PAL 4X3 (720x576)
    • PAL 16X9 (720x576)
    • HD 720 (1280x720)
    • HD 1080 (1920x1080)
    • Manual - This will allow you to manually adjust the size of the Content Pan and overall CloudTV Player window.
    • Native Size - This is an additional selection that is only available if "Manual" or "Auto Native Size" are selected in the Screen Size Menu.
  • Navigation Bar — toggles view of the Navigation bar on and off.
  • Remote Pane — toggles view of the Remote pane on and off.
  • Output Pane — toggles view of the Output pane on and off.

Tools

  • Screenshot — makes a screenshot of the content screen and saves it to a bmp file. The file location defaults to the desktop, but can be changed in the Preference dialog. If multiple screenshots are taken, the system will increment the filenames, such as screenshot1, screenshot2, etc.
  • Start Record To File — records a session to a “ts” file onto the hard drive. After selecting Start Record to File from the Tools menu, you must click the Start or Home button to begin the recording process. Then a dialog box like the following will prompt you for a filename for the recording, which must be set before the session starts. The file location defaults to the desktop, but can be changed in the Preferences dialog or by clicking the browse button in this dialog box and choosing another location. After configuring the filename (and directory) for the recording, click Record to begin recording.

    record

    The Start Record To File option is only active when a session is NOT playing in CloudTV Player. This means that if there is an application currently playing within CTVP, the Start Record To File menu option will not be active. When Start Record To File is active/enabled, there will be a "VR" indicator in the right side of the Status Bar at the bottom of the CTVP screen, indicating that Video Recording is currently enabled. Video files previously recorded from CTVP can be opened and played from within CTVP (see File > Open, above). When a video file is being played back within CTVP, there will be a "VP" indicator in the right side of the Status Bar, indicating that Video Playback is currently running. Note that the recorded file includes both the video and audio from the session.

    To stop recording, in the Tools menu, click Stop Record to File. The recording function remains active until stopped in this manner. Stopping the session ends recording of that session and stores the file, but the recording function remains activated and will restart when a session is again started. So it must be separately stopped.

  • Mute— allows audio to be muted while testing applications.
  • Bookmarks — from the sub-menu, select Show Application Bookmarks, Show Server Bookmarks, Add Current to Application Bookmarks, or Add Current to Server Bookmarks. Bookmarks consist of the URLs of previously addressed servers or apps. The "Show" options display a dialog box with two tabs for the two types of bookmarks: Server and Application. The Import/Export pulldown menu offers the ability to import or export bookmarks for either tab. In order to import bookmarks, the bookmarks file must have previously been exported (such as in copying from one computer to another, or in exporting to a network location for sharing by other developers). When a set of bookmarks are imported, they will replace all the existing bookmarks (for that server).

    Click the + button to add a bookmark. You will be prompted for a bookmark name and URL. The buttons with symbols activate Add, Delete, Edit, Move Up, and Move Down functions that act upon bookmarks.
    *Note: Application URLs can only be added for http, rfbtv, and https protocols. Application URLs are not used for bcp or ictvprot protocols.

    bookmarks

    The "Add Current" options display nearly identical dialog boxes that are used to add the current application or server URL to the respective bookmarks listing. The example below shows the Add Current to Server Bookmarks dialog box. Both fields can be edited before saving.

    add-bookmark

  • Start Record to Script — allows Set-top Stress scripts to be recorded to an "sss" file onto the hard disk, as an application session is running. This is used primarily to record a session for troubleshooting or other analysis purposes.

    The Start Record To Script File option is only active when a session is NOT playing in CTVP. If there is an application currently playing within CTVP, the Start Record To Script File menu option will not be active. After selecting Start Record to Script from the Tools menu, you must click the Play button to activate the recording activity. Then a dialog box like the following will prompt you for a filename for the recording, which must be set before the session starts. The file location defaults to the desktop, but can be changed in the Preferences dialog or by clicking the file browse button in this dialog box and choosing another location. Then click Record to continue.

    script-record

    As you navigate throughout the app by pressing the keys, it records every key click and every delay to a file, which will allow you replay the exact same session with the exact same timing. Scripts recorded from sessions will record the following commands in Set-top Stress format:

      • connectex
      • sleepms
      • presskey
      • disconnect

    When Start Record To Script File is active/enabled, there will be an "SR" indicator in the right side of the Status Bar, indicating that Script Recording is currently enabled. Scripts may be recorded while connected with any protocol, however the connectex command will only be filled out properly if the session protocol is ictvprot at the time of recording.

    Press the Stop key to stop the app, then in the Tools menu, click Stop Record to Script File.

  • Play Script File — (Only supported for ICTVProt session) Allows previously recorded scripts to be played back within CloudTV Player.
    If the script was recorded in a non-ICTVProt session, it will not play back, but will display a dialog like the one below.

    script player error

    The default Script File location can be changed within the location field by clicking the file browse button. When the desired file has been selected, click the Play button to begin playing the script. The Advanced ICTVProt settings window will display, for configuring additional settings and information specific to the ICTVProt protocol.

    When the script is playing, the Pause button becomes active. Clicking the Pause button will pause playback of the script in its current location. Clicking Play again will resume playback from this point.

    There is a script command viewer within the window that displays commands from within the script as the script is playing.

    When a script file is being played back within CloudTV Player, there will be an "SP" indicator in the right side of the Status Bar, indicating that the Script Player is currently running.

  • Key Input Tester — The Key Input Tester window will be displayed when this option is clicked. This allows the user to send keys to the application at a predetermined speed and sequence.

    keyinputtester

    The window includes a field for selecting a Key Value, which specifies the key that will be sent. This field includes all of the following options:

    The window includes these fields:

      • Number of Repeats — The number of times the above key will be sent.
      • Time Between Repeats (ms) — The time between each key sequence is being sent, in milliseconds.

        The window also includes the ability to select the following key events to associate with the Key Values:
        • KeyDown — The KeyDown command will be sent to the server as part of one key sequence. Please note that if the protocol does not support this key event, the event will be dropped.
        • KeyPress — The KeyPress command will be sent to the server as part of one key sequence. Please note that if the protocol does not support this key event, the event will be dropped.
        • KeyUp— The KeyPress command will be sent to the server as part of one key sequence. Please note that if the protocol does not support this key event, the event will be dropped.

    The text box will show the commands being executed. Press the Clear button to clear the text box.

    Multiple key events may be selected, in which case, the key sequences will cycle through the selected key events, sending one of each key event per cycle.The window also includes a dialog window that displays the commands being executed.

     

  • Set-top Commands
    • Send Passthrough Response — from the Set-top Commands submenu, select Send Passthrough Response. The Passthrough Response window will be displayed (shown below) when the Send Passthrough Response option is clicked. It is used to enable apps to send messages to the set-top box without having to make changes to the CloudTV server. The window includes a field for entering a Protocol ID value and a field for entering a Message. Clicking the Send button will submit the ID and Message entered in the fields.


    passthru

    • Send Suspend — Selecting this option from the Set-top Commands menu will open a dialog that gives you the option to resume or stop the execution of your application. Selecting stop will stop the session. Selecting resume will resume the session. To launch the session again press the play button. This command is only available on the rfbtv protocol and can only be used while a session is running.

    • Send Refresh Stream — Selecting this option from the Set-top Commands menu will send a request to the server to deliver an iframe for the stream. This command is only available on the rfbtv protocol and can only be used while a session is running.

 

  • Binary Message Editor — Opens the Binary Message Editor window

    binary editor

    Click the + button to add a message. The Binary message creator window will then be displayed.
    The buttons next to the + are associated with Delete, Edit, Move Up, and Move Down and Copy functions that act upon listed/saved messages.
    There is also an option to Import or Export a selected Binary message.

  • Custom Remote Editor — Opens the Remote Editor Window

    remote editor

    Select a button on the Custom Remote that you'd like to assign a command to. The selected button will be shaded green. You can then enter text in the "Button Display String" field. The entered text will be displayed on the selected button. There is typically a maximum of five characters for these button labels. You can then select a command to assign to the button by selecting a Key Description from the "Key Description" field.

    Once you have added all of the desired buttons, you can click Save to Save your custom remote. This customized remote will be displayed when "Custom Remote" is selected as the remote type in the Remote Pane.

Help

The Help menu is only available on the Windows version.

      • About — displays CloudTV Player version information.
      • CloudTV Player Help — opens online user guide.

 

Preferences

The Preferences dialog can be accessed from the File menu and consists of five tabs: General, Display, Color Options, Protocols, and Advanced.

All persistent preferences can be modified and saved using the Preferences dialog. If changes are made, click the OK button to save them.

General

general prefs 3-6

Field Definitions

Home Server URL

The default Server URL that will display when the CloudTV Player first launches.
It is also the Server URL that will be used when the Home key is pressed.

Home App URL

The default App URL that will show when the CTVP first launches. It is also the Server URL that will be used when the Home key is pressed.

Screenshot Directory

The directory on the hard drive that the screenshot bmp files will be saved to.
The default location is the user’s desktop, but can be changed in this field. Use the file browser button or type a differerent path.. Screenshots are saved sequentially as
“shot.bmp,” “shot-1.bmp,” “shot-2.bmp,” etc.

Session Record File

The file name that the session video will be saved to. The default filename is "recorded_session.ts".
Please note that the video file will be overwritten if a new session is recorded using the same filename.
The default location is the user’s desktop, but can be changed in this field. Use the file browser button or type a differerent path.

Device Language

A string sent to the system server indicating the language used by the client. This only affects an application that has been coded to respond to a language input. This does not affect the CTVP itself.

CA Certificate File

Allows the user to specify a particular Certificate Authority certificate file to be used for https session.

CA Client Cert File

Allows the user to specify a particular Certificate Authority certificate file for CloudTV Player to use as the client.

Private Key File

Selecting a Private Key File allows for connections across SSL.

Internal Log File

Specifies the location to write the Internal Log file. This file stores events from teh previous CloudTV Player session that may be useful for troubleshooting in the rare occasion that the CloudTV Player application may crash.

Max Bandwidth (kbps)

kilobits-per-second

The bandwidth tab within the Output pane will alert the user if the max bandwidth value entered here is exceeded.

Setting the value for Max Bandwidth to 0, or leaving it blank, will disable this feature. The Max Bandwidth can be set while a session is running.

Crash Reports

The Crash Reports option selected here will determine how CTVP handles crash report information. Select from pulldown menu:

  • Ask before sending reports
  • Always send reports
  • Never send reports

Send Crash Reports (button) — Use this feature, if needed, to submit a crash report from a recent session to ActiveVideo for investigation. This is useful for troubleshooting.

Send Crash Reports

A button that can be used to manually submit the crash report in the event that the option to send crash reports was disabled.

Add “webkit:” prefix to app URL

 

If checked, all app URLs starting with http:// will get an added prefix of "webkit:". The "webkit:" prefix is
required by the system to identify html5 apps. If unchecked, the app URL will be used as entered by the user, even if it begins with http://.

 

Order keypad keys like a remote control

Reverse the mapping order of the numeric keys on the user’s keyboard to match a TV remote. Enabling this option will map the keyboard numeric pad keys as follows:
1 key = 7 command
2 key = 8 command
3 key = 9 command
4 key = 4 command
5 key = 5 command
6 key = 6 command
7 key = 1 command
8 key = 2 command
9 key = 3 command

Clear Server URLs

Clears all the saved Server URLs in the Server URL dropdown box on the Navigation Bar.

Clear App URLs

Clears all the saved App URLs in the App URL dropdown box on the Navigation Bar.

Clear Cookies

Clears all cookies.

Restore All Settings To Default

Return all preference settings to their original default values.

 

Display

The Display tab is used to select the TV Format and the Remote Type.

display prefs 3-6

Field Definitions

Remote Type

The type of remote that is displayed in the Remote Pane.

Full Remote — This remote has most of the buttons found on both Cable/Satellite remotes and CE remotes.

Cable/Satellite Remote — This remote has most of the buttons found on Cable/Satellite remotes.

Common Remote — This remote has the buttons that are shared between Cable/Satellite remotes and CE remotes.

 

Color Options

The Color Options tab is used to define color in several areas, such as: Dirty Rectangles, Safe Areas, Macrobloc Grid and Background. The color options can be changed while a session is running.

coloroptions prefs 3-6

The example below shows the Title Safe and Action Safe areas (turned on in the View menu) based on the Color Options settings above.

coloroptions2

Field Definitions

Dirty Rectangles Colors

Dirty Rectangles are momentary rectangular areas highlighting objects on the screen that are refreshed as a result of key presses or selections. This is useful in the effort to optimize the application, reducing the amount of objects that need to be refreshed following each action. For example, if changing the focus of a single button results in the entire screen being refreshed, that is an inefficient use of bandwidth that can be corrected by altering the coding of the app.

Stream — Specifies the color of stream (video) dirty rectangles. Clicking the button will present a color dialog.

Missed Cache — Specifies the color of Missed Cache dirty rectangles (The screen update had to be encoded). Clicking the button will present a color dialog

Cache — Specifies the color of Cache dirty rectangles (the screen update was taken from the cache). Clicking the button will present a color dialog.

Color Representation — There are two modes for the color representation of the dirty rectangles.

  • Bits Changed Color Scale — When this option is selected the color represents number of bits changed in the rectangle. The scale starts with blue (few bits) -> green -> Yellow -> Red (lots of bits changed). When this option is selected, the buttons for Stream, Missed Cache, and Cache buttons are disabled.
  • Cached Status Color — When this option is selected the color represents the Cache status. The colors can be configured with the buttons.

Fade Time (ms) — The time it will take the dirty rectangle to fade out in ms.

Start Opacity (20-100) — This is the opacity value that the dirty rectangle will start its fading at (100 means it will start with no transparency).

Rectangle Format

There are two options for how the rectangles that represent the dirty area are displayed

  • Solid Rectangles  Rectangles are displayed as color-filled rectangles that fade over time.
  • Outlined Rectangles  Only the outlines of the rectangles are displayed.

Safe Area Colors

Title Safe — Indicates the Title Safe area color when displayed on the content pane. The Title Safe area indicates the portion of the screen that can be seen on any tv.

Action Safe — Indicates the Action Safe area color when displayed on the content pane. The Action Safe area indicates the portion of the screen that could possibly be seen on the tv. Try to keep your objects inside the Action Safe area.

Macrobloc Grid Color

Specifies the color of the 16px by 16px Macrobloc Grid when enabled in the View menu.

Background Color

The background color when the video stream does not cover the entire content pane.

 

Protocols

The Protocols tab is itself subdivided into six sub-tabs: http, rfbtv, ictvprot, bcp, https, and General.

protocols prefs 3-6

http

Key send timeout (seconds)

The number of seconds before a key send times out when using the HTTP protocol.

http default server port

The default port value defined in the http protocol settings (8080) will be appended to the end of the entered string (Server URL) if no port is included in the string.

https default server port

The default port value defined in the https protocol settings (443) will be appended to the end of the entered string (Server URL) if no port is included in the string.

Client ID

A string that will be sent to the system identifying the client. Values entered here should match devices that are defined on the server that CloudTV Player is targeting.

Client ID Format

Select a format:

  • Use Client ID Only — Client ID is used as typed.
  • Client ID + host Mac Address — CTVP will add the Mac Address for the computer it is running on, to the end of the typed Client ID.
  • Client ID + Random Mac Address — CTVP will add a random Mac Address to the end of the typed Client ID. This must be used when the user wants to run more than one instance of the CTVP on the same computer.

 

rfbtv

Stream UDP port

The port on which the RFB-TV protocol will listen for the video stream, when UDP is used. (RFBTV supports both UDP and HTTP.)

  • Use Random — If checked, enables random assignment of the UDP Port. This will use a random available port on which to receive the UDP stream.

IP for UDP stream

This is the IP address (interface) that CTVP will bind to for the UDP stream.

  • Use Default IP — If checked, assigns the UDP Stream to the default IP. CTVP will attempt to find the right interface to bind to.

Stream to external device

If checked, this will send the return stream from the Compositor to the specified stream IP address and Port. CTVP will control the session, but the video stream will be sent to the device (not visible in CTVP) that is configured with the IP address and port entered in the above preferences.

Smartcard ID

If a string is entered, it will be sent to the system. This is part of the RFBTV protocol spec.

VOD Serving Group

If a string is entered, it will be sent to the system. This is part of the RFBTV protocol spec.

Launch Method

If a string is entered, it will be sent to the system. This is part of the RFBTV protocol spec.

Firmware Version

If a string is entered, it will be sent to the system. This is part of the RFBTV protocol spec.

Previous Channel

If a string is entered, it will be sent to the system. This is part of the RFBTV protocol spec.

rfbtv default server port

The default port value (8095) defined in the rfbtv protocol settings will be appended to the end of the entered server URL  string if no port is included in the string.

rfbtvs default server port

The default port value (8495) defined in the rfbtvs protocol settings will be appended to the end of the entered server URL string if no port is included in the string.

Client ID

This Client ID field is specific to the rfbtv protocol and will not be referenced if CTVP connects to a session with a different protocol.

Client ID Format

Select a format:

  • Use Client ID Only — Client ID is used as typed.
  • Client ID + host Mac Address — CTVP will add the Mac Address for the computer it is running on to the end of the typed Client ID.
  • Client ID + Random Mac Address — CTVP will add a random Mac Address to the end of the typed Client ID. This must be used when the user wants to run more than one instance of the CTVPon the same computer.

 

ictvprot

Stream UDP port

(50000) The port on which the ICTVProt protocol will listen for the video stream, when UDP is used.

  • Use Random — If checked, enables random assignment of the UDP Port. This will use a random available port on which to receive the UDP stream.

IP for UDP stream

This is the IP address (interface) that CTVP will bind to for the UDP stream.

  • Use Default IP — If checked, assigns the UDP Stream to the default IP. CTVP will attempt to find the right interface to bind to.

Stream to external device

If checked, will send the return stream from the Compositor to the specified stream IP address and Port. CTVP will control the session, but the video stream will be sent to the device (not visible in CTVP) configured with the IP address and port entered in the above preferences.

Run as QAM session

If checked, will run the session as a QAM session. When checked, the Service Group Id field is enabled. 

Service Group Id

Only available for entering values if the Run as QAM box is checked.  This field allows for specification of a particular QAM Service Group Id.

Config port

The port number (8088) that the system uses to get the launch method information.

Default server port

The default port value (5000) defined in the ictvprot protocol settings will be appended to the end of the entered string if no port is included in the string.

Client ID

Brings up specific settings on the server.

  • User Defined Mac Address — If checked, the Mac Address that is typed/entered in the Settop ID Hex field will be used.
  • Use Local Mac Address — If checked, the MAC address the computer running CTVP will be used.
  • Use Random Mac Address — If checked, CTVP will assign a random Mac Address to the Set-top ID Hex field. This must be used when the user wants to run more than one instance of CTVP on the same computer.

Server Specific Settings

The App URL drop down menu will be limited to the launch methods available to the targeted Server. This button is only enabled/active when a valid ictvprot url is entered in the Server URL field. Clicking on the Server Specific Settings button will open the Advanced ICTVProt Settings window.

 

bcp

Stream UDP port

 

(50000) The port on which the ICTVProt protocol will listen for the video stream, when UDP is used.

  • Use Random — If checked, enables random assignment of the UDP Port. This will use a random available port on which to receive the UDP stream.

IP for UDP stream

The IP address (interface) that CTVP will bind to for the UDP stream.

  • Use Default IP — If checked, assigns the UDP Stream to the default IP. CTVP will attempt to find the right interface to bind to.

Service Group Type

Allows for a selection of one of three Service Group Types:

  • 0 — Frequency Plan
  • 1 — Service Group Id
  • 2 — IP Session

Config Freq Plan

This button is only available if option "0 - Frequency Plan" is selected as the Service Group Type. Clicking the active button will open the Frequency Plan editor window. This editor allows for defintion of Streaming Zone (default value is '0'). The editor also enables creation and management of TSID and EIA channels.

Config Service Group ID

This button is only available if option "1 - Service Group Id" is selected as the Service Group Type. Clicking the active button will open the Service Group ID editor window where a particular Service Group IDvalue can be entered.

Launch Parameters

If Enable Launch Param is checked, this will enable/activate the Launch Parameters field, which is used for text that will indicate launch parameters. Binary messages can be managed by clicking the "..." button to the right of the Launch Parameters list box.

Handoff Response Errors

If Handoff Response Errors is checked, the list box will become active, allowing for selection of a particular response error. There are four errors to choose from:

  • 1 — URL not understood
  • 2 — required media player not found
  • 3 — player error
  • 4 — unspecified error (if no other applies)

When option "3 — player error" is selected, an additional entry field will become active, allowing for entry of a specific error message.

Stream to external device

If checked, will send the return stream from the Compositor to the specified stream IP address and Port. CTVP will control the session, but the video stream will be sent to the device (not visible in CTVP) configured with the IP address and port entered in the above preferences.

Default server port

The default port value (5001) defined in the bcp protocol settings will be appended to the end of the entered string if no port is included in the string.

Resolution

The session will not exceed the requested resolution, but may provide a resolution lower than the specified value. The specific SD resolution is deployment-specific. A client that is not authorized or not able (that is, not using HD capable video output) to display an HD stream should specify a SD resolution. 
Select from pulldown list: SD 4:3, SD 16:9, HD 720p, or HD 1080p

Video Codec

Select from pulldown list: MPEG-2 or H.264

Language

Select from pulldown list of multiple languages. If the client does not support the language setting, it shall set this field to 0. The value in this field is overridden by the language_ex and country_code fields, if those fields are present.

Key Map

Select from pulldown list: X11 Key Codes or Motorola STB Remote

Clear Cookies

If checked, the server should clear any cookies associated with this client. If persistent storage is available, the client may choose to use this flag to clear cookies when the storage is at the factory defaults. After a successful session launch, the client shall store the state so that the clear_cookies flag can be set to 0 for subsequent sessions. If the end-user or other procedure resets the box to factory defaults, this should allow the client to clear cookies when the box is transferred to another end-user.

Tuner Index

The tuner index this session will use. Select from pulldown list: 0, 1, 2, or 3. The client may only run a single session on a single tuner at a time. If the client only supports a single simultaneous session, it shall set this field to 0.

Use Random Client Session ID

If checked, will use a randomly generated client ID that is generated by the client. Normally the ID is automatically assigned as 0 for the first session. However this will not work when we have multiple CTVP sessions running at the same time, for this we need to have randomly generated Client IDs.

Mac Address

There are three additional options for defining th Mac Address:

  • Random — The Mac Address sent to the server is random
  • Local — The Mac Address of the computer CTVP is running on will be used
  • Defined — When Defined is selected an additional entry field will be enabled that allows for a specific Mac Address string to be entered and used

Server Specific Settings

When bcp is selected as the streaming protocol, the url in the App URL window will change to reflect the configured launch methods available on the selected server. This button is only enabled/active when a valid bcp url is entered in the Server URL field. The button provides access to the Advanced BCP Protocol settings.

Config Port

A server-specific Port value can be entered here.

Enable Ext. Fields


If Enable Ext. Fields is checked, this will enable/activate the Various Extended Fields to make them available for editing.

Client ID Type

Select from pulldown list: 0) No client ID is specified, 1) Included manufacturer and model fields, or 2) Included client ID length and client ID fields.

Client ID

Enter data. This field is only enabled if “Included client ID length and client ID fields” (option 2) is selected. Otherwise, this field is disabled.

Smart Card ID

Enter data. This field is only active if the Enable checkbox is checked. Otherwise, this field is disabled.

Language Ex

If enabled, this input field indicates the Preferred language for the session. The value is a two or three letter language code as specified in ISO 639-1 or ISO 639-2 represented using three 5-bit values. The most significant 5 bits is the first character, the next 5 bits is the second character, and the least significant 5 bits is the third character. Each 5 bit value is the ASCII value of the letter minus 0x60. If the third digit is 0, the value is the two letter ISO 639-1 code.
This value overrides any value specified in the language field.

Country Code

If enabled, this input field is the 2-character country code specified in ISO 3166-1. This value overrides any implied value in the language field.

Client Version

If enabled, this field will be included in the Exended Fields section.

Client IP

If enabled, this input field is the IPv4 address of the client. If not present, the server uses the IP address of the computer running CTVP. This field is not normally provided by the client.

Client Port

If enabled, the port to use to send messages to the client. If not present, the server uses the port of the source. This field is not normally provided by the client.

SRM IP

If enabled, this field allows for specifying a particular SRM IP

Audio Codec

If enabled, a specific Audio Codec can be selected from the list of: 0 - MPEG-2 audio; 1 - AAC; 2 - AC3

 

General

Verify server SSL certificate

If checked, this option will verify the SSL certificate on the server. If this option is not enabled, the SSL certificate will not be verified.

H5 CloudTV Server Version

Allows you to specifiy a server version in order to remain compatible with a change to the BCP protocol that became effective with the 1.11 SR3 release. Options for selection are: 1.11 SR3 or newer; 1.11 SR2 or older

 

Protocol Advanced ICTVProt

The Advanced ICTVProt Settings window includes settings and information specific to the ICTVProt protocol. Once an editable field has been changed, the Apply button will become active. The OK button will save all settings/changes made and close the window.

adv-ictv1

Launch Methods

Launch methods are defined on the system that you are trying to connect to. When you type in the server ip, CloudTV Player automatically connects to the server and downloads the defined settings. You can select each method and see what values are associated with launch method.Displays all the configured launch methods for the ictvprot protocol on the targeted server. The list includes:

Launch Method Name

Program Name

Program URL

Launch Method Name Name of the selected Launch Method.
Launch Channel

The channel which the set-top is viewing at the time the session is launched.
This value is used by the backend to further refine launch methods.

Launch Source

The source of the action that triggered the request message. The supported values are:
0 - Direct Channel
1 - Menu
2 - Direct Hot Key
3 - Hot Key from Keyboard
4 - Guide

The backend will try to match this with the launch source specified in launch methods.

Launch Mode

The launch mode used to trigger this request in the context of the launch source.
For example, if launch source 0 is used, then the launch mode indicates the channel from which the
session was launched but if the launch source is 2, the launch mode indicates the code of the hot key (or button) which was pressed.
The hot key codes for the A, B and C buttons on a GI remote control are, respectively, 23, 39 and 40.

Guide ID The software guide (or software platform) installed on the set-top.

Some of the supported values are:
0 - Standalone
1 - TvGuide
2 - Pioneer
3 - Pioneer 2.5
4 - SARA
5 - OpenTV
6 - Unknown

MPEG Port The port on the set-top where the MPEG-2 data will be streamed to.
Node Info The node information available to the set-top. This number may represent a different concept depending on the type of set-top and the software platform running on it. For example, an SA set-top would report a service group ID and a GI set-top would report a combination of the upstream and downstream IDs.
Extended Data Depending on the request type selected, this value will be included in the request message as the URL (for older types) or as extended data (for newer versions).
Add button will create a new Custom Launch method within the list and make the preceding fields (except Guide ID and MPEG Port) available for editing. This is used mostly for testing error conditions.
Settings

Manufacturer ID — A list of set-top box manufacturers to choose from. Manufacturer ID and Model ID can be used to simulate different settop boxes.

Model ID — A list of set-top box models to choose from that are related to the selected manufacturer.

Connect Request — The following selectable options: Extended9, Extended8, Extended7. The type of request message to be sent to the server. The specific request types supported can vary from one installation to the next. Unsupported request types will be ignored.

 

Protocol Advanced BCP

The Advanced BCP Settings window includes settings and information specific to the BCP protocol. Once an editable field has been changed, the Apply button will become active. The OK button will save all settings/changes made and close the window.

adv-bcp 3-6

Launch Methods

Displays all the configured launch methods for the bcp protocol on the targeted server. The list includes:

Launch Method Name

Program Name

Program URL

Launch Method Name For the selected Launch Method
Launch Channel For the selected Launch Method
Launch Source For the selected Launch Method
Launch Mode For the selected Launch Method
Launch ID For the selected Launch Method
Add button Will create a new Custom Launch method within the list and make the preceding 5 fields available for editing
Delete button Will delete the the selected Launch Method. Note that only custom Launch Methods created in CTVP can be deleted from this window. The delete button will be inactive when a server-defined Launch Method is selected. 
Settings

Manufacturer ID — a list of set-top box manufacturers to choose from

Model ID — a list of set-top box models to choose from that are related to the selected manufacturer

Launch ID

Allows for selection between: Use Triplet or Use Launch ID

 

Advanced

The Advanced tab is where some additional features are configured.

advanced prefs 3-6

Field Definitions

PID to read session data from

This is PID that all the log, CPU, Memory and dirty rectangle information is sent on from the system. This number must match with number specified on the system.

Calculate Key Latency

 

Enable AV Debug tab

If checked, allows Audio/Video Debug tab to be toggled ON within the Output Pane. However this will significantly slow down the performance. The “Enable A/V Debug Tab” option can be turned on or off while a session is actively running.

Display Internal Log Tab

If checked, the Internal Log Tab is added to the Output Pane

Log internal messages to file

If checked, this will log internal CTVP application messages to a file that can then be shared for troubleshooting purposes.

Do audio video sync

If checked, toggles audio/video sync ON in CTVP. Enabling this introduces ~100ms of latency.

Simulate key repeat If checked, toggles Simulated Key Repeat ON in CTVP. When enabled, the key repeats generated by the physical keyboard and OS will be sent to the server. However, any events received that are not supported by the active protocol will be dropped.
Send Mouse Events If checked, toggles ON the ability for CTVP to send mouse events to the server. Mouse events are only supported by the http and rfbtv protocols. Mouse events include clicks and mouse wheel movement. When enabled, you can click and mouse-wheel on a video feed or a live website.
Display Overlays

If checked, client-side overlays will be rendered within CTVP. This will allow content to be displayed as overlays on top of video elements.

*Note that overlays are only supported within RFBTV sessions, and that screen captures will not include overlay elements since they are not part of the video stream being sent to CTVP.

Max Mouse Moves (per second)

This option will work in concert with the Send Mouse Events option, when enabled, to indicate how many mouse move events will be sent to the server per second. 

Bandwidth Sample Rate (ms)

Allows the ability to alter the bandwidth sampling frequency.

 

Appendixes

The following tables are included below:

Keyboard Shortcuts for PC

Both the Human Interface Guidelines (HIG) published by Apple, as well as the Keyboard Shortcut documentation published by Microsoft were considered in the mapping of the following keyboard shortcuts. Efforts were made to avoid conflicting with commonly used keyboard shortcuts on the two operating systems.

CloudTV Player environment Shortcuts

Shortcut (PC)

Resulting Action

<Ctrl>+Q

Close application

<Ctrl>+R

Connect or Reconnect

<Esc>

Stop

<Tab>

Cycles through Server/App URL areas

<Ctrl>+M

Minimize Application Window

<Ctrl>+<Shift>+F

Full Screen

Double-click (left mouse button)

Full screen
*Only works if "Send Mouse Events" Advanced Option is disabled.

<Ctrl>+S

Screenshot

Key Mappings During Connected Session Playback

Shortcut (PC)

Virtual Remote Key Mapping

<up>

The 'up' key

<down>

The 'down' key

<left>

The 'left' key

<right>

The 'right' key

<return>, <enter>, <space>

The 'ok' or 'enter' or 'select' key

<backspace>

The 'back' key

<page up>

The 'Page Up' key

<page down>

The 'Page Down' key

'0'

The number '0'

'1'

The number '1'

'2'

The number '2'

'3'

The number '3'

'4'

The number '4'

'5'

The number '5'

'6'

The number '6'

'7'

The number '7'

'8'

The number '8'

'9'

The number '9'

<Shift>+<page up>

The 'channel up' key

<Shift>+<page down>

The 'channel down' key

Keyboard Shortcuts for Mac

Both the Human Interface Guidelines (HIG) published by Apple, as well as the Keyboard Shortcut documentation published by Microsoft were considered in the mapping of the following keyboard shortcuts. Efforts were made to avoid conflicting with commonly used keyboard shortcuts on the two operating systems.

Shortcut (Mac)

Resulting Action

<Cmd>+Q

Close application

<Cmd>+R

(re)Connect

<Esc>

Stop

Cmd+Shift+H

Home

Double-click (left mouse button)

Full Screen
*Only works if "send Mouse Events" Advanced Option is disabled.

<Tab>

Cycles through Server/App URL areas

<Cmd>+M

Minimize Application Windowt

<Cmd>+Shift+F

Full Screen

<Cmd>+S

Screenshot

Key Mappings During Connected Session Playback

Shortcut (Mac)

Virtual Remote Key Mapping

<up>

The 'up' key

<down>

The 'down' key

<left>

The 'left' key

<right>

The 'right' key

<return>, <enter>, <space>

The 'ok' or 'enter' or 'select' key

<backspace>

The 'back' key

<page up>

The 'Page Up' key

<page down>

The 'Page Down' key

'0'

The number '0'

'0'

The number '0'

'1'

The number '1'

'2'

The number '2'

'3'

The number '3'

'4'

The number '4'

'5'

The number '5'

'6'

The number '6'

'7'

The number '7'

'8'

The number '8'

'9'

The number '9'

<Shift>+<page up>

The 'channel up' key

<Shift>+<page down>

The 'channel down' key

VK_code Values

The following is a list of the VK_code values that the H5 platform will return to the html application, regardless of the protocol used to connect to the platform. This table is provided as a point of reference for testing and development purposes.

Key on Remote

Description

VK_code

Keyboard Mapping

Up

The 'Up' key

38

<up>

Down

The 'Down' key

40

<down>

Left

The 'Left' key

37

<left>

Right

The 'Right' key

39

<right>

OK/Select/Enter

The 'OK' or 'Select' or 'Enter' key

13

<return>, <enter>, <space>

Back/Cancel

The 'Back' or 'Cancel' key

8

<backspace>

Play

The 'Play' key to start a media asset

415

 

Stop

The 'Stop' key to stop a media asset

413

 

Pause

The 'Pause' key to pause a media asset

19

 

Forward

The 'Fast Forward' key to fast forward in a media asset.

417

 

Rewind

The 'Rewind' key to rewind in a media asset.

412

 

Skipfwd

The 'skip forward' button

1806

 

Replay

The 'replay' button

1807

 

Next

The 'Next' key to play the next item in a playlist.

425

 

Prev

The 'Prev' key to play the previous item in a playlist.

424

 

Last

The 'Last' button

8

<backspace>

Setup

The 'Setup' key

1801

 

End

The 'End' button

35

<end>

Settings

The 'Setup' or 'Settings' key

4109

 

Exit

The 'Exit' button

1158

 

Menu

The 'Menu' button

462

 

NetTV

The 'Net TV' button

1803

 

Top Menu

The 'Top Menu' button

1802

 

On Demand/PPV

The 'On Demand' or 'PPV' button

1805

 

My DVR

The 'My DVR' button or similar button that launches a DVR browser

1181

 

Live

The 'Live' or 'live TV' button

1157

 

Media

the 'Media' button

1804

 

Page Up

The 'Page Up' button

33

<page up>

Page Down

The 'Page Down' button

34

<page down>

0

The number '0'

48

'0'

1

The number '1'

49

'1'

2

The number '2'

50

'2'

3

The number '3'

51

'3'

4

The number '4'

52

'4'

5

The number '5'

53

'5'

6

The number '6'

54

'6'

7

The number '7'

55

'7'

8

The number '8'

56

'8'

9

The number '9'

57

'9'

Channel Up

The 'Channel Up' key

427

<Shift>+<page up>

Channel Down

The 'Channel Down' key

428

<Shift>+<page down>

Red

The Red color button

403

 

Green

The Green color button

404

 

Yellow

The Yellow color button

405

 

Blue

The Blue color button

406

 

Info

The 'Info' button

457

 

Help

The 'Help' or '?' button

156

 

Record

The 'Record' button to start recording

416

 

Guide

The 'Guide' or 'EPG' button

458

 

Home

The 'Home' button

36

 

A

The 'A' button

4111

 

B

The 'B' button

4112

 

C

The 'C' button

4113

 

D

The 'D' button

4114

 

Fav

The 'Fav' or 'Favorites' button

171

 

List

The 'List' button

1808

 

Dayup

The 'day up' button

1809

 

Daydown

The 'day down' button

1810

 

Playpause

The 'play/pause' button

1811

 

Virtual Remote Keys (Cable/Satellite)

The keys in the following table shall be made available on a virtual remote in order to emulate sessions on a Cable/Satellite provider’s set-top box. These keys represent commonly used or standard keys found on physical remote control devices provided by Cable and Satellite Operators.

Key on Remote

Description

Keyboard Mapping

Up

The 'Up' key

<up>

Down

The 'Down' key

<down>

Left

The 'Left' key

<left>

Right

The 'Right' key

<right>

OK/Select/Enter

The 'OK' or 'Select' or 'Enter' key

<return>, <enter>, <space>

Back/Cancel

The 'Back' or 'Cancel' key

<backspace>

Play

The 'Play' key to start a media asset

 

Stop

The 'Stop' key to stop a media asset

 

Pause

The 'Pause' key to pause a media asset

 

Forward

The 'Fast Forward' key to fast forward in a media asset.

 

Rewind

The 'Rewind' key to rewind in a media asset.

 

Last

The 'Last' or 'end' button

 

Setup

The 'Setup' or 'Settings' key

 

Exit

The 'Exit' button

 

Menu

The 'Menu' button

 

On Demand/PPV

The 'On Demand' or 'PPV' button

 

My DVR

The 'My DVR' button or similar button that launches a DVR browser

 

Live

The 'Live' or 'live TV' button

 

Page Up

The 'Page Up' button

<page up>

Page Down

The 'Page Down' button

<page down>

0

The number '0'

'0'

1

The number '1'

'1'

2

The number '2'

'2'

3

The number '3'

'3'

4

The number '4'

'4'

5

The number '5'

'5'

6

The number '6'

'6'

7

The number '7'

'7'

8

The number '8'

'8'

9

The number '9'

'9'

Channel Up

The 'Channel Up' key

<Shift>+<page up>

Channel Down

The 'Channel Down' key

<Shift>+<page down>

Info

The 'Info' button

 

Help

The 'Help' or '?' button

 

Record

The 'Record' button to start recording

 

Guide

The 'Guide' or 'EPG' button

 

A

The 'A' button

 

B

The 'B' button

 

C

The 'C' button

 

Fav

The 'Fav' or 'Favorites' button

 

List

The 'List' button

 

Virtual Remote Keys (Connected Device)

The keys in the following table shall be made available on a virtual remote in order to emulate sessions on a connected device, such as a connected Blu-ray player or connected TV. These keys represent commonly used or standard keys found on physical remote controls provided by manufacturers of connected devices.

Key on Remote

Description

Keyboard Mapping

Up

The 'Up' key

<up>

Down

The 'Down' key

<down>

Left

The 'Left' key

<left>

Right

The 'Right' key

<right>

OK/Select/Enter

The 'OK' or 'Select' or 'Enter' key

<return>, <enter>, <space>

Back/Cancel

The 'Back' or 'Cancel' key

<backspace>

Play

The 'Play' key to start a media asset

 

Stop

The 'Stop' key to stop a media asset

 

Pause

The 'Pause' key to pause a media asset

 

Forward

The 'Fast Forward' key to fast forward in a media asset.

 

Rewind

The 'Rewind' key to rewind in a media asset.

 

Next

The 'Next' key to play the next item in a playlist.

 

Prev

The 'Prev' key to play the previous item in a playlist.

 

Menu

The 'Menu' button

 

Top Menu

The 'Top Menu' button

 

0

The number '0'

'0'

1

The number '1'

'1'

2

The number '2'

'2'

3

The number '3'

'3'

4

The number '4'

'4'

5

The number '5'

'5'

6

The number '6'

'6'

7

The number '7'

'7'

8

The number '8'

'8'

9

The number '9'

'9'

Channel Up

The 'Channel Up' key

<Shift>+<page up>

Channel Down

The 'Channel Down' key

<Shift>+<page down>

Red

The Red color button

 

Green

The Green color button

 

Yellow

The Yellow color button

 

Blue

The Blue color button

 

Info

The 'Info' button

 

Home

The 'Home' button

 

Error Messages

Error messages differ depending on the protocol.

HTTP Error Messages

150: insufficient bandwidth

170: latency too large

400: session open client id missing or not understood

401: session open credentials are missing

404: session open specified default application not found

500: session open internal server configuration error

503: session open no resources to support session

404: session close no session found for the specified client id

404: keystroke no session found for the specified client id

  • Monday, 28 July 2014

Your destination to find out more about just how easy it is to develop advanced applications that leverage the “write-once, deploy-everywhere” content creation environment of ActiveVideo’s CloudTV™ platform. You will be able to significantly reduce app time-to-market for connected devices of all types, as well as cable settop boxes that have no additional connectivity. Manufacturers and virtual service providers, as well as cable and IPTV operators around the world are currently benefiting from the advantages of ActiveVideo’s CloudTV platform.

© 2017 Active Video Networks. All Rights Reserved