Launcher additional properties

The OpenTV ION launcher supports custom content items defined by additional properties as it has greater access to the device system.

Application launch

To add an item to the DISCOVER screen that launches an installed application on the device:

Select the DISCOVER screen template and then the appropriate layout.
If there is no app launcher rail, add a new rail called AppLaunch. If it already exists, click and then click Edit Properties.
For each additional property you want to add, click Add Property and enter the details as explained in the table below.
Click Save Rail.
In the confirmation dialog that is displayed, click Continue to save the rail.

Key item	Description
`title`	The name of the asset shown on the Discover Screen	Mandatory
`app_id`	The Android Bundle ID of the application to launch.	Mandatory
`image`	Defines the source of the image to show for the application logo in Discover. The available values are as follows: `app_bundle` – the application logo is used as seen in the apps & games section. `URI` – image is retrieved from the URI provided in the `image_uri` variable. `ion_bundle` – the application logo is taken from a library of images stored in OpenTV ION (used for custom integrations for specific third-parties).	Mandatory
`image_uri`	The URI OpenTV ION should request the application logo from if `image` is set to `uri`.	Dependant on image
`tile_background`	The hex colour value to be used for the item background if the image used is transparent.	Optional
`scale_factor`	Provides the ability to adjust the size of the image used. Only applicable when `image` is set to `ion_bundle`.	Optional
`deeplink_uri`	You can define a URI that the third-party application should open when launched. Allowing specific content inside a third-party app to be defined and launched.	Optional

This enables you to add a logo to the title of a rail or in the top right-hand corner of the content.

Adding the values to the rail section puts the logo in front of the Rail title.

To add a logo to the title of a rail:

Click on the rail that you want to add a logo to and then click Edit Rail Properties.
Click Add Property for each property you need to add and enter the details as explained in the table below.
Click Save.
In the confirmation dialog that is displayed, click Save Rail to save the rail.

Key item

Description

app_id

The Android Bundle ID of the application to launch.

Mandatory

image

Defines the source of the image to badge the Rail or the Content with in Discover.

app_bundle – the application logo is used as seen in the apps & games section.
uri – image is retrieved from the URI provided in the logo_uri variable.
ion_bundle – the application logo is taken from a library of images stored in OpenTV ION (used for custom integrations for specific third-parties).

Mandatory

logo_uri

The URI OpenTV ION should request the application logo from if image is set to uri.

Dependent on image

Adding the values to a Pre-Curated section overlays the logo on the image of the content in the section.

To add a logo to content:

Select the template and the appropriate layout.
On the rail that you want to add overlay logos to, and then click Manage Content.
Click Custom > Pre Curated Section.
Select the external Provider and content list.
Click to add the content to the rail.
In the right pane, for the rails section you just added, click Edit Properties.
Referring to the table above, enter the required details.
Click Save.
Click Save Unsaved Changes.
In the confirmation dialog that is displayed, click Continue to save the rail.