External portal loading
IPTV set-top boxes MAG allow users to receive third-party audiovisual content (such as television channels, movies, series, etc.). Set-top box (STB) does not contain any pre-loaded content. In order to get access to content, you should turn to a local operator (owner of the OTT / IPTV platform) that provides respective services. STB manufacturer does not distribute any content and is not responsible for quality of content-provision services. On all issues relating to the operation of the External Portal and, in particular, about troubles with the content, it is necessary to contact your service provider.
While using STB, please take into account that the content received may be subject to copyright or related rights protection, and distribution of such content may be exercised solely upon the authorisation of rights holder.
External OTT / IPTV portal
External OTT / IPTV portal (hereinafter referred to as External Portal) is designed to allow STB users access to services provided by a particular OTT / IPTV platform.
Example of IPTV/OTT project on base of Ministra TV-Platform - Magic Solution.
Connection to External Portal may include authentification stage: to access the portal, user should enter, in proposed Authentication form, personal log-in and password that were got from the operator (service provider).
After STB connected to Portal, user can accesses certain OTT / IPTV services (audio-video content play back, recording / playback services, access to games and other applications and etc.).
External Portal of certain OTT / IPTV platform has original User Interface (UI). Portal's UI is designed on Desktop environment principle and contains general tools of service management and portal settings like windows, icons, folders, menu, etc. The following example demonstrates the UI of MW Ministra portal - Main menu and Settings:
Interaction of certain STB model and Middleware server gets enable after preliminary mutual integration. List of OTT / IPTV platforms that supported by STB is indicated in technical specifications of STB - for example, see MAG322 spec (see Middleware supported option). STB models of MAG family are integrated with Ministra TV platform.
Specifying of External portal in Software image and in System Settings
In closed platform STB models, as a rule, URL of IPTV operator portal is specified in STB software (firmware) and access to Embedded STB portal is blocked. The portal of IPTV operator, that was specified this way, is loaded in STB automatically.
In open platform STB models, access to external and embedded portals can be configured in following ways:
- Portal URL is specified by operator in STB software during creating software image. This variant is used only for STB software that operator creates, - operator and custom software images. After SW update this portal will automatically load in STB. In addition, during image creation you can block ability to display and make changes of Portal section, as well as to disable ability to enter the Embedded portal - see Instruction.
- Portal URL is manually configured by user in Portal section. In operator and custom STB software image, this feature may be opened or blocked (depending on Operator settings in STB software - see Instruction). In public and factory images those are provided by STB manufacturer, this feature is available by default.
How to configure portals settings in software image
Instruction on how to configure portals settings when building software image:
- Рortal address (URL) is specified in environment variables file (env.txt) - see Key points section of Operator utilities and instructions for assembling the software image:
- For example, for Portal 1 to set the address http://example.com - in env.txt file there should be next line: portal1=http://example.com - this portal will be automatically loaded in STB.
- To hide (not to display) Portals section in Embedded portal (System settings ⇒ Servers ⇒ Portals) - in env.txt file there should be next line: custom_url_hider=true
- It is recommended to perform check variables procedure, to control unauthorized changes of variables - see Checking of variables during STB / portal start
- How to block access to Embedded portal - see Disabling items of System settings, Settings. Disabling entering to embedded portal and other
- How to disable remote access to file system of STB (via SSH protocol) - see SSH - change password, port, disabel/enable
Manual configuring portals in Embedded portal
How to manually configure external portals by user is described in next sections: How to add external portal in Settings of Embedded portal and Portals Setting. When manually configuring portals, one of the portals can be loaded automatically, or user can be proposed to choose which of the portal to load - see Select a portal for loading.
How to add external portal in Settings of Embedded portal
For example, to add Portal 1 (Name: stalker, URL: http://10.1.3.1/stalker_portal/c):
Basic configuring External portal (the case of setting information is entered by the on-screen keyboard):
- In Embeded portal open: System settings ⇒ Servers ⇒ Portals.
- Call up screen keyboard (with KB button on RC).
- Specify Portal 1 name value (do not click Enter). In example: stalker.
Note.Portal name - is a not mandatory value (this option may be skipped). - Remove the keyboard (with KB button on RC).
- Go to Portal 1 URL option (with Down button on RC).
- Call up screen keyboard (with KB button on RC).
- Specify Portal 1 URL value. In example: http://10.1.3.1/stalker_portal/c/.
Note. The value of Portal URL has format of http page.
If incorrect value is specified, the appropriate notice will be display when attempt to save. - After completing click Enter on keyboard to save entered data.
- Exit from Portal settings. To check connection to Portal 1, restart portal: System settings ⇒ Restart Portal. The specified portal must be auto loaded.
Additional configuring of Portal:
- In Embeded portal open: System settings ⇒ Servers ⇒ Portals.
- Click More (F1 on RC). In appeared Multiportal mode option set ON. This opens additional Portals options:
- In Portal select requiered portal to be edited;
- Select value of Portal load delay option;
- Select default portal in Default Portal option;
- Make sure that option Use portal is set to ON (if Portal should be used).
- Save the changes with command Save (OK on RC).
- If necessary, similarly described in item a-e make additional settings for other portals
- To connect required Portal, restart Embedded portal: System settings ⇒ RestartPortal;
How to set Portal autoloading
One of portals registered in STB can be assigned with autoloading mode. When portal loading happens, this portal will load after set delay time. For example, in order to set Portal 1 autoloading for the above algorithm:
- for item 5 - in Portal load delay option set one of delay value (1 s, 5 s, ..., 2 min).
- for item 6 - select Portal 1 in Default Portal option.
When portal loading happens
Portal loading starts in the following cases:
- on exit from Embedded portal (i.e. exit from Main menu - use Exit on RCU);
- on exit from some External portal (if this option is enabled, in SW image, bу operator);
- after restart of Embedded portal;
- after STB reboot (including after the SW update).
Portal auto loading
Auto loading of certain portal can be set in STB software image or in System settings of Embeded portal (see How to set Portal autoloading).
If autoloading is set for certain portal, the message "Loading portal..." appears on the screen when portal has to be loaded. Duration of this message displaying before start portal loading is specified in advanced portal setting (in Portal load delay option). After the delay time, the portal autoloading starts.
If during "Loading portal..." message being displayed user presses Menu on the remote control, the loading stops and Select a portal for loading window opens.
Select a portal for loading
Select a portal for loading window may be displayed on the screen on stage of portal loading in STB. Select a portal for loading window is displayed if at least one external portal is specified in STB and, the same time, autoloading
feature is not activated for any portals.
The window allows to select manually the portal to be loaded (embedded or external one). Moreover, user can make changes of Portal settings (System settings ⇒ Servers ⇒ Portals) or other parameters of System settings before start Portal loading.
Page loading error
If STB fails to load some external portal, then Page loading error window (page 404) displays. It contains Try again command (retrying connection to the portal) and other commands those are similar to commands of Select a portal for loading window.
If Page loading error window is displayed, user may:
- Select from list different external portal to load (if this portal was pre-registered in STB) in Select a portal for loading window.
- Enter to System settings, change portals settings, and then back to Select a portal for loading window (use Back button on RCU) to load the portal again.
- Check network connection status in Select a portal for loading window. To recover connection, change settings (in System Settings) and reboot STB.
- Load Embedded portal.
Portals Setting
Portal section
Network address (URL) of external portals are set in Embedded portal: System settings ⇒ Servers ⇒ Portals.
In Portals window by default it is possible to specify data (name, URL) of two external portals. However, STB can store information about more (up to 8) external portals - see Extended portal Settings.
Extended Portals settings
Supplementary Portals settings are configured in Portal / More section. More window consists additional rules of loading media-portal in STB (default loaded portal, type of loading - automatic or manual selection of portal, etc.). Moreover, additional (more than two) external media-portals can be edited.
- Open System settings ⇒ Servers ⇒ Portals ⇒ More (F1 on RC).
- Set option Multiportal mode to ON.
Options | Descriptions |
---|---|
Multiportal mode |
ON - enable editing, OFF - disable editing. Value ON opens (gets enable) additional options to set up the portal loading mode and to add additional external portals. |
Default portal |
Default portal - which automatically loads in STB (see description of Portal load delay option). User can set embedded or external portal as default portal. The external portal must first be configured (see options Portal N, Use portal, URL N). |
Portal load delay |
Option values:
|
Portal N |
The number (N = 1 ... 8) of external portal whose parameters are currently displayed and are available for editing in Portals window. |
Use portal N |
If option is set to ON then this portal (N-th) can be used to load in STB (it is displayed in Select a portal for loading window). |
Name N |
Name of external portal to be added (N-th). |
URL N |
Address (URL) of external portal to be added (N-th). |
DHCP portal
It is possible to specify, from DHCP server, the external portal to be loaded in STB. This feature is called DHCP portal and is configured in the next section: System settings ⇒ Servers ⇒ More.
If DHCP portal option is enabled, then STB, at booting stage, retrieves external portal address from DHCP server. For this purpose the DHCP server must be pre-configured properly - see an example. The value of DHCP portal is set in STB environment variables as Portal 1. Accordingly, this value displays in Portals and Select a portal for loading window as Portal 1.
Discription of window options - see in Servers section of System Rettings.