H200 Zapper Application Guide

Introduction

This is a user guide for the Amino H200 zapper application. This is also the default browser-based application started by the H200 when the following deivce parameters are not provisioned to the H200 STB,

• webapp.homepage - for assigning a web application to the H200 browser.
• tvapp.package_id - for assigning an Android application to start with the H200 device.

This guide assumes that the user has the knowledge to provision the H200 STB, which is covered in the H200 Quick Start Guide.

Target audience

Users who are interest in deploying the H200 zapper application for simple video playback purposes.

Steps to deploy the H200 zapper

1. Prepare a channel lineup file that serves as an input for the zapper application.
2. Place the channel lineup file on a HTTP server.
3. Add the device parameter "webapp.lineup_url" to the device configuration of the H200.
4. Set the URL of the channel lineup file as the value of the "webapp.lineup_url" parameter.
   
   Example 1 (Orchestrate group application settings)
   
   
   Example 2 (H200 configuration file)
   webapp.lineup_url="http://test/media/lineup.json"
   
   
5. Reboot the H200 or use Orchestrate to provision the H200 with the new configuration parameters.

Channel lineup file format and examples

It is a JSON format file which contains the configuration details of each channel included in the file.

The player supports media sources provided in the following formats: 

{
  "name": "100",
  "desc": "Clear Dash Stream",
  "url": "http://www.domain.com/manifest.mpd"
}

{
  "name": "101",
  "desc": "Encrypted Dash Stream",
  "url": "http://www.domain.com/encrypted/manifest.mpd",
  "encrypting_server": "http://www.domain.com/AcquireLicense",
  "encryption_type": "com.widevine.alpha",
  "encrypting_request_header": {
  "X-AxDRM-Message": "..."
  }
}

{
  "name": "102",
  "desc": "Encrypted Dash Stream with persistent license",
  "url": "http://www.domain.com/encrypted/manifest.mpd",
  "encrypting_server": "http://www.domain.com/AcquireLicense",
  "encryption_type": "com.widevine.alpha",
  "drm_session_type": "persistent"
}

{
  "name": "200",
  "desc": "RTSP stream",
  "url": "rtsp://www.domain.com:554/stream.ts"
}

{
  "name": "312",
  "desc": "SRT stream with id and pw",
  "url": "srt://1.2.3.4:8888?streamid=3&password=777",
}

{
  "name": "300",
  "desc": "Unicast UDP stream",
  "url": "udp://10.0.0.2:8110"
}

{
  "name": "311",
  "desc": "Multcast UDP stream",
  "url": "udp://239.1.1.1:8110?prog_id=2&disable_av_sync=true&disable_audio=true"
}

{
  "name": "321",
  "desc": "IGMPv3 stream",
  "url": "igmpv3://239.1.1.2:8110?mcast=asm",
}

{
  "name": "323",
  "desc": "IGMPv3 stream",
  "url": "igmpv3://192.168.1.1:8110?
  mcast=ssm_include&src_addr=192.168.1.30&
  src_addr=192.168.1.32"
}

{
  "name": "324",
  "desc": "IGMPv3 stream",
  "url": "igmpv3://192.168.1.1:8110?
  mcast=ssm_exclude&src_addr=192.168.1.30&
  src_addr=192.168.1.32"
}

{
  "name": "350",
  "desc": "mp4 media file",
  "url": "http://www.domain.com/file.mp4"
}

{
"name": "351",
"desc": "HLS stream",
"url": "https://www.domain.com/index.m3u8"
}

Example channel lineup file 

{
  "DTV": [
  {
   "name": "IGMPv2 multicast",
   "desc": "233.22.133.1:8110",
   "url": "udp://233.22.133.1:8110",
  },
  {
   "name": "2",
   "desc": "RTSP",
   "url": "rtsp://10.0.32.36:554/Queen5Min.ts"
  },
  {
   "name": "3",
   "desc": "SRT",
   "url": "srt://video-server.entone.com:11935?streamid=output/live/test"
  },
  {
   "name": "4",
   "desc": "Clear DASH",
   "url": "http://10.0.34.24/dash/zattoo/sd/manifest.mpd"
  },
  {
   "name": "5",
   "desc": "HTTPS HLS",
   "url": "https://hls-test.entone.com/hlsvod_20110923/HD_C/Live_Test_Babe_HD.m3u8"
  },
  {
   "name": "6",
   "desc": "HTTP HLS",
   "url": "http://192.168.1.97/hlsvod_20110923/HD_C/Live_TestIMAXHubble.m3u8"
  }
 ]
}

Zapper application features

Remote Control Of The Device Over A Network 

It is possible to control the H200 Zapper application via REST API. For details please refer to H200 Enable Enterprise Local Management (EELM) Server.

Following table lists all the keycodes that can be sent to control the H200 Zapper application.

Audio Language Selection

Toggling Through Available Audio Languages in Video Player Application

Pressing the “Media” button on the remote control brings up the list of available Secondary audio languages available in the video stream. Successive pressing will toggle through or you can use “Up”/”Down” and “Ok” to select.

Closed Captions or Subtitles Selection

Toggling Through Subtitle/Caption Languages in Video Player Application

Pressing the “Red” button on the remote control, brings up the list of available Closed-Captions/Subtitles available in the current stream. Successive pressing will toggle through or you can use “Up”/”Down” and “Ok” to select.

Watermark / On Screen Display of Device Info

For some Digital Signage customers there may be a need to have some type of watermark able to be displayed which is unique per STB, to this end there are some relevant Amino Orchestrate parameters which allow you to enable a watermark and select the data and colour of the data that will be displayed.

• browser.osd_info.argb requires an RGB colour code and this will determine the colour of the on screen text.
• browser.osd.info.enable is the main setting to turn on the watermark feature and has a drop down of on/off value
• browser.osd.info.mask determines which information will be displayed, the 1 or 0 in the 4 digits will determine if that data is displayed. The information for each digit equates to :

• • Serial Number
  • Mac Address
  • ChipID
  • IP address

In the example below 1101 will show SN, Mac and IP.

Watermark Display

Starting Channel

You can program which channel should be the first channel to load when a device is turned on. This channel is known as the Starting Channel. This can be done by setting a “starting” property to value “true” in the channel lineup configuration file as shown below:

Example of starting channel

{ "type": "udp", "name": "12", "desc": "UDP stream", "starting": true, "addr": "233.22.133.12", "port": "8110" },

If more than one starting channel is specified, the 1st appearance will be selected.

Save Last Channel

If you prefer that the Video Player starts on the channel which was last viewed you can add the INI parameter webapp.save_last_channel to your device group on Orchestrate and enable it by setting the value to “true”. If set then it will take priority over any starting channel that was set.