Introduction
The Amino H200 STBs work with the OAK remote by default. This remote has several keys that can be customized at the STB side to ensure full compatibility with your TV APP.
By default, most of these keys are global - meaning they are raised to the Android system and handled by any APP that might recognize the action. However, these can be customized to act directly on your APP as we will describe in this article.
Key handling integration
As Global keys will most likely not cover all the needed actions, we provide two different ways of customizing their behaviour:
- Defining Function Keys in the Amino Device Management System (INI parameters);
- Receiving the global key and handling them directly in your APP.
Global key - Define the function
Using a default configuration, your Android STB will raise the keys as global, which means they will be processed either by Android itself or by any foreground APP that can process it.
Here's a list of all the keys available as Global keys:
Remote Key | Android Key Code | Global key configuration |
AV | KEYCODE_DVR | globalkey.dvr |
Guide | KEYCODE_GUIDE | globalkey.guide |
Menu | KEYCODE_MENU | globalkey.option |
Red | KEYCODE_PROG_RED | globalkey.red |
Green | KEYCODE_PROG_GREEN | globalkey.green |
Blue | KEYCODE_PROG_BLUE | globalkey.blue |
Yellow | KEYCODE_PROG_YELLOW | globalkey.yellow |
Customized key handling
Amino provides the capability of customizing the behaviour of a big part of the Oak remote keys. There are three different ways these keys can work:
- Trigger Deeplink;
- Trigger an APP, based on package ID;
- Trigger a specific Activity within an APP;
In order to switch from the default Global key to one of the three options above, the following INI parameters need to be added:
Remote key | INI parameter |
AV | key.link.dvr |
Guide | key.link.guide |
Menu | key.link.option |
RED | key.link.red |
GREEN | key.link.green |
YELLOW | key.link.yellow |
BLUE | key.link.blue |
These should then point to one of the three preferred actions, as shown:
Use case | INI format | Example |
Trigger Deeplink | URI |
https://www.amino.tv or |
Trigger APP, based on package ID | pkg://<app_package_id> | pkg://com.aminocom.settingsmenu |
Trigger specific Activity within an APP | pkg://<app_package_id>?cls=<activity_class_name> | pkg://com.android.tv.settings?cls=com.android.tv.settings.MainSettings |
More documentation on Deep-links can be found on the Android documentation: https://developer.android.com/training/app-links
Comments
0 comments
Article is closed for comments.