Enhancement Announcement Format
[This is preliminary documentation and subject to change.]
Enhancement announcements are formatted using Session Description Protocol (SDP). For more information, see Announcement Format. This topic discusses only the SDP fields used by enhancement announcements.
The following is a sample enhancement announcement for a future show:
v=0
o=enhfilt 248 56132 IN IP4 157.55.106.31
s=Time & Again Interactive
c=IN IP4 231.31.17.1
t=31557167 31449234
a=EnhID:{9E2E8B20-083E-11d1-898F-00C04FBBDEBC}
a=ShowRef:1997/7/29!26673/7175/9690!0:30!0!0!0!0!9690!9690!4096!7040!''!'MSNBC'!3!54!'Time & Again'
a=PreloadURL:show\default.htm
a=FutureEnh:
m=data 3456 udp 0
where
-
v =
-
Announcement protocol version.
-
o =
-
Owner of the announcement, in this case the enhancement filter, and session identifier.
-
s =
-
Name of the enhancement. This string should be used as the enhancement title in any user interface relating to the enhancement.
-
c =
-
Connection information.
-
t =
-
Time the session is active.
-
a =
-
Attribute fields, of which there can be zero or more. The enhancement announcement format specifies the following attribute fields:
-
a = EnhID
-
Identifies the announcement as an enhancement announcement and specifies a unique identifier for the enhancement.
-
a = ShowRef
-
Specifies the show reference of the interactive episode or episodes. This field is required for future announcements. If this field is not present, the filter assumes the announcement is for a current broadcast. For more information, see Show Reference Format.
-
a = PreLoad
-
Specifies the Uniform Resource Locator (URL) of the Hypertext Markup Language (HTML) file that contains the starting enhancement page. This field is optional for a future announcement and is not used for current announcements. If you do not specify a complete path, such as C:\MyEnhance\, the URL is resolved relative to C:\Program Files\TV Viewer\Layouts. For example, if you specify TVShow\TVShow.htm, this path is resolved to C:\Program Files\TV Viewer\Layouts\TVShow\TVShow.htm.
-
a=FutureEnh
-
Indicates that the announcement is for a future enhancement. This field is required for future enhancements and is not used for current enhancements.
-
m =
-
Specifies the media name and transport address.