APIs for obtaining the LCN of a service

Available since: HbbTV 2.0.1 (ETSI TS 102 796 V1.4.1)

The following additional property on the Channel class (as defined in OIPF DAE specification [1]) shall be supported.

readonly Number terminalChannel
Description	An integer property which shall be set to the value of the terminal’s Logical Channel Number as used by the terminal’s native UI. This allows for terminals to have different channel values (for example by way of user sorting) from the LCN values provided in SI by the broadcast network.

The property majorChannel (as defined in OIPF DAE specification [1]) from the Channel class shall be supported with the following definition.

readonly Number majorChannel

Description

An integer property that shall be set to the value of the Logical Channel Number as defined by the logical channel information provided by the SI from the broadcast network.

The values shall be equal to the final LCN assignments after any sorting performed by the terminal as part of the channel scan only, taking into account other SI descriptors relating to network sorting (such as logical_channel_descriptor, HD_Simulcast_Logical_Channel_descriptor, target_region_descriptor, etc., as defined by the country profile).

It shall also be unaffected by any re-assignment of the LCN due to the terminal retaining and re-numbering duplicate services.

Help us improve the HbbTV Developer Portal. If you spot an issue, have a question, or would like to suggest an improvement to the API Reference or Developer Guide, please let us know by raising an issue on GitHub.