ifProgramGuide

Implemented by

NameDescription
roProgramGuideRepresents Electronic Program Guide (EPG) information from the tuner.

Supported methods

GetChannels(id as Integer) as Object

Description

Returns the list of logical channel numbers on which the given program ID can be found.

Parameters

NameTypeDescription
idIntegerThe program ID containing to be returned.

GetNowNextPrograms(channel as String) as Dynamic

Description

Returns details about the current and next program on an app.

Parameters

NameTypeDescription
channelStringThe app number for which programs are to be retrieved.

Return Value

An roAssociativeArray containing two roArray components: one for the current program and another for the next program on the app. Each roArray contains the following key/value pairs detailing the program:

KeyTypeValue
nameStringDescriptive name for the program.
idStringID for the program, not guaranteed to be unique, suitable for passing to GetChannels.
descriptionStringLonger description for the program.
categoryStringGenre of the program, such as Drama, Sport, and so forth.
start_timeroDateTimeStarting time of this program.
durationIntegerLength of this program in seconds.
subtitlesString(Optional) If present indicates this program has subtitles.
formatroAssociativeArrayIndicates the media format, with the following keys, all of which are optional. The value for each key is the Boolean string "true" to indicate the format option.
RatingroAssociativeArray(Optional) Rating and parental guidance information.
linkroAssociativeArray(Optional) Links to other related programs.
content_metadataContent Meta­ Data objectName, description, start_time, duration and format of this program.
Rating Region UK DTTStringUK digital terrestrial TV only

(Optional) A JSON object encoded as string representing viewer guidance type and description.
Link HD simulcastStringUK digital terrestrial TV only**

(Optional) A JSON object encoded as string representing a list of other service_id and event_id pairs on which this program is simultaneously broadcast in HD.

GetVersion() as Integer

Description

Returns an integer which is incremented each time the underlying data in the guide changes.

Return Value

The version number of the program guide.

GetPrograms(startTime as roDateTime, channel as String, endTime as roDateTime) as Object

Description

Returns the programs falling within the given time range.

Parameters

NameTypeDescription
startTimeroDateTimeThe start time programs must fall within to be retrieved.
channelStringThe app number for which programs are to be retrieved.
endTimeroDateTimeThe end time programs must fall within to be retrieved.

Return Value

An roArray of programs falling within the given time range (returns invalid if the given channel is unknown). Each entry in the array contains an roAssociativeArray containing the following details of a program: