The ChannelList class
Support in HbbTV
Available since: HbbTV 1.0 (ETSI TS 102 796 V1.1.1, OIPF DAE V1.1)
The getChannelBySourceID() method is not included.
Comment
Broadcast-related
typedef Collection<Channel> ChannelList
A ChannelList represents a collection of Channel objects. See Annex K for the definition of the collection template.
In addition to the methods and properties defined for generic collections, the ChannelList class supports the additional properties and methods defined below
Methods
|
Channel getChannel( String channelID )
|
|
Description
|
Return the first channel in the list with the specified channel identifier. Returns null if no corresponding channel can be found.
|
|
Arguments
|
channelID
|
The channel identifier of the channel to be retrieved, which is a value as defined for the ccid and ipBroadcastID properties of the Channel object as defined in section 7.13.11.
|
|
Channel getChannelByTriplet( Integer onid, Integer tsid, Integer sid, Integer nid )
|
|
Description
|
Return the first (IPTV or non-IPTV) channel in the list that matches the specified DVB or ISDB triplet (original network ID, transport stream ID, service ID).
Where no channels of type ID_ISDB_* or ID_DVB_* are available, or no channel identified by this triplet are found, this method SHALL return null.
|
|
Arguments
|
onid
|
The original network ID of the channel to be retrieved.
|
|
tsid
|
The transport stream ID of the channel to be retrieved. If set to null the client SHALL retrieve the channel defined by the combination of onid and sid. This makes it possible to retrieve the correct channel also in case a remultiplexing took place which led to a changed tsid.
|
|
sid
|
The service ID of the channel to be retrieved.
|
|
nid
|
An optional argument, indicating the network id to be used select the channel when the channel list contains more than one entry with the same onid, tsid and sid.
|
|
Channel getChannelBySourceID( Integer sourceID )
|
|
Description
|
Return the first (IPTV or non-IPTV) channel in the list with the specified ATSC source ID.
Where no channels of type ID_ATSC_* are available, or no channel with the specified source ID is found in the channel list, this method SHALL return null.
|
|
Arguments
|
sourceID
|
The ATSC source_ID of the channel to be returned.
|
