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.