<media>

Attribute

Data Type

Required?

Default

Description

expr

CDATA

no

NA

ECMAScript expression that evaluates to the URI (location) of the media file. Programmable Media Platform proprietary. Use the v_ovl_def parameter following the media file to specify:

• a URI (in http:// or file:/// format) to an XML file that defines a text overlay or image overlay.

• an XML string that defines a text overlay or image overlay inline.

fetchhint

{prefetch | safe}

no

NA

Specifies when the VoiceXML Interpreter context should retrieve content from the server. Valid values:

• prefetch = Fetch the resource when the page is loaded.

• safe = Fetch the resource when it is specifically called by the application.

fetchtimeout

CDATA

no

NA

Time interval to wait for the content to be returned before throwing an error.badfetch event. Use s for seconds (for example, 1s) and ms for milliseconds (for example, 1ms).

maxage

CDATA

no

NA

Maximum acceptable age, in seconds, of a resource being fetched from the cache. Setting maxage to 0 means that a cached version is never considered fresh.

maxstale

CDATA

no

NA

Maximum acceptable staleness, in seconds, of the resource being fetched, if the fetched resource is cached and expired.

offset

CDATA

no

NA

The offset (in s or ms) at which to play the media file.

This attribute is supported for:

• HTTP or local files that reference a 3GP file

• HTTP or local audio-only files

• Audio-only files streamed by an RTSP server

• 3GP files streamed by an RTSP server

The behavior of the offset attribute for HTTP or local files that reference a 3GP file differs, depending on the presence of a sync point table and a matching I-frame. For information, see the Details.

Note: The offset attribute is not supported for live RTSP presentations.

offsetexpr

CDATA

no

NA

ECMAScript expression that evaluates to the offset. This can be used in conjunction with the lastresult$.bargeintime variable to let the application play a media file from the point at which the user barged in, and not have to start from the beginning again. This attribute is especially useful for long media files.

src

CDATA

no

NA

URI of the media file. Use the v_ovl_def parameter following the media file to specify:

• a URI (in http:// or file:/// format) to an XML file that defines a text overlay or image overlay.

• an XML string that defines a text overlay or image overlay inline.

type

CDATA

no

NA

Preferred media type of the requested resource. This can differ from the actual media type of the resource. The VoiceXML Interpreter currently ignores this attribute, determining the media type during HTTP content negotiation or content introspection.

If the Referenced 3GP File...

And...

Then the VoiceXML Interpreter...

Contains a sync point table.

There is an I-frame that corresponds to the specified offset.

Plays the file from that I-frame.

The specified offset does not match an I-frame.

Plays the file from the next I-frame after the specified offset.

There is no next I-frame.

Does not play the file.

Does not contain a sync point table.

NA

Ignores the offset attribute and plays the file from the beginning.