Page 30
|
ZvMXE User ’s Manual
www.zeevee.com
ZvMXE User ’s Manual
|
Page 31
9 Channel Guide File Specification
The Channel Guide file is an XML files that describes the program
information to be displayed as part of the channel guide to the ZvMXE user.
Basic File Format:
IP channel stream information will be describe with the following XML
syntax.
<?xml version=”1.0” encoding=”UTF-8”?>
<ZVIP type=[“guide” | “guideonly”] >
<CHAN>
<ip>streamIPAddr</ip>
<port>streamPort</port>
<tstype>[tsoverudp | tsoverrtp | http]</tstype>
<name>shortChanName</name>
<icon>webLink</icon>
<pnum>channelNumber</pnum>
</CHAN>
...
</ZVIP>
Header Line:
<?xml version=”1.0” encoding=”UTF-8”?>
The header line defines the file type and must appear exactly as shown as
the first line in the file.
ZVIP Type Line:
The second line must be the Type line and defines attributes that apply to
the entire guide.
<ZVIP type=[“guide” | “guideonly”] >
type is a required tag and must have one of the
following options
“guide” - channels described are added to auto
discovered channels to form ZVMXE channel list.
For duplicate channel descriptions(same stream
address and port), the data in the guide file will
supersede data from auto discovery.
“guideonly” - Disable auto discovery of Zeevee
channels on the network. Only channels described
in guide file will be presented in channel list of
the ZVMXE.
Channel Guide Information Block:
The following represents a block of data that would describe the associated
guide information for a given stream.
<CHAN>
<ip>streamIPAddr</ip>
<port>streamPort</port>
<tstype>[tsoverudp | tsoverrtp | http]</tstype>
<name>shortChanName</name>
<icon>webLink</icon>
<pnum>channelNumber</pnum>
</CHAN>
Note that there can be as many <CHAN> … </CHAN> blocks in a Channel
Guide file as the user wishes to add to the guide.
In the case of Additive operation (the
type
field set to
guide
) only those
streams that are desired to be included that are not sourced by ZeeVee
equipment need be described. The rest can be auto-discovered and the
guide information included as it is delivered in the channel beacons.
Alternately, if is desired to override the information that arrives in the
ZeeVee source beacons, the information contained in the Channel Guide
files will supersede the beacon data.
In the case of Exclusive operation (the
type
field set to
guideonly
) only
those channels explicitly listed in the Channel Guide file will be included in
the channel list presented to the ZvMXE user. None of the auto-discovered
beaconed channels will appear in the user list.