HTML+TIME: Media

DHTML文档教程

---

introduction to html+time provides extensive support for media playback through media container elements, a unified timeline model, a variety of media-specific attributes and properties, and system test attributes. these features make it easy for web authors to provide tightly synchronized multimedia presentations, and to coordinate media with animation, without using script.

the following links provide access to the object model exposed by the time2 behavior.

overviews

about content selection: system test attributes and t:switch

html+time 2.0 provides authors with the option to display different elements based on system settings.

Seeking With HTML+TIME

In HTML+TIME (Timed Interactive Multimedia Extensions) various types of media, animation, and other time elements can be played over a period of time. It is often desirable to be able to jump to any point on this time line. This process of jumping to different points on a time element's time line is called seeking.

Using the HTML+TIME Document Object Model (DOM)

All HTML+TIME objects are accessible through script at run time. This article introduces you to the HTML+TIME objects, methods, events, and properties available to your Web pages.

Tutorials

Incorporate the time2 Behavior

This tutorial explains how to incorporate the time2 behavior in your Web pages so you can begin using timelines, multimedia, and animation with HTML elements.

Media Elements and Objects

animation

Defines a timed animation element in an HTML document.

audio

Defines a timed audio element in an HTML document.

currTimeState

Contains information about an HTML+TIME timeline.

img

Defines a timed image element in an HTML document.

media

Defines a generic, timed media element in an HTML document.

playItem

Represents an individual media file in a playlist collection.

ref

Defines a reference to a generic timed element in an HTML document.

video

Defines a timed video element in an HTML document.

Attributes and Properties

abstract

Retrieves a description of the media file.

Abstract

Retrieves the Abstract content of the entry banner in an Advanced Stream Redirector (ASX) file using the event object.

accelerate

Sets or retrieves a value that applies an acceleration to an element's timeline.

activeDur

Retrieves the total duration of the timeline.

activeTime

Retrieves the current point in time along the total active timeline, including repeats and time spent in reverse mode.

activeTrack

Sets or retrieves the track, or playitem object, that is currently active in the playlist collection.

author

Retrieves the name of the media file's author.

autoReverse

Sets or retrieves whether the timeline on an element begins playing in reverse immediately after completing in the forward direction.

Banner

Retrieves the Banner content of an entry in an ASX file using the event object.

Banner

Retrieves the Banner content of an entry in an ASX file.

BannerAbstract

Retrieves the BannerAbstract content of an entry in an ASX file.

BannerMoreInfo

Retrieves the bannermoreinfo content of an entry in an asx file.

begin

Sets or retrieves the delay time before the timeline begins playing on the element.

bufferingProgress

Retrieves a value that indicates the current percentage of buffering completed.

canPause

Retrieves a value that indicates whether the media file can be paused.

canSeek

Retrieves a value that indicates whether the media file is capable of locating a specific time in the media's duration.

clipBegin

Sets or retrieves the beginning point of a sub-clip of a continuous media object.

clipEnd

Sets or retrieves the end point of a sub-clip of a continuous media object.

copyright

Retrieves the copyright information associated with a media file.

currentFrame

Retrieves a value that indicates the currentframe of the object.

decelerate

Sets or retrieves a value that applies a deceleration to the end of a simple duration.

downloadCurrent

Retrieves a value that indicates the current number of bytes downloaded from streaming content.

downloadTotal

Retrieves a value that indicates the total size of the file (in bytes) downloaded.

dur

Sets or retrieves a value indicating the amount of time the element remains active or displayed.

end

Sets or retrieves a value indicating the end time for the element, or the end of the simple duration when the element is set to repeat.

fill

Sets or retrieves the action an element takes if its timeline ends before the timeline on its parent element ends.

hasAudio

Retrieves a Boolean value that indicates whether the media contains audio.

hasDownloadProgress

Retrieves a Boolean value that indicates whether a media file has begun to download.

hasMedia

Retrieves a Boolean value that indicates whether the element is an Introduction to HTML+TIME media element.

hasPlayList

Retrieves a Boolean value that indicates whether the element has a playList collection.

hasVisual

Retrieves a Boolean value that indicates whether the element can draw on the screen.

index

Retrieves the index value of the playItem object in the playList collection.

isActive

Retrieves a value that indicates whether the element is currently active on the timeline.

isMuted

Retrieves a value indicating whether the element's audio is currently muted.

isOn

Retrieves a value that specifies whether the element is active or holding on the timeline in its current state.

isPaused

Retrieves a value that specifies whether the element is paused on the timeline.

latestMediaTime

Retrieves a value that indicates the amount of time it takes for a media object to begin playing.

mediaDur

Retrieves the duration of the element's media file.

mediaHeight

Retrieves the height of the element.

mediaWidth

Retrieves the width of the element.

mimeType

Retrieves the MIME content-type of the object.

MoreInfo

Retrieves the MoreInfo content of an entry banner in an ASX file through the event object.

mute

Sets or retrieves a value that indicates whether the audio is turned on or off.

parentTimeBegin

Retrieves the current element's begin time as an offset from the parent element's begin time.

parentTimeEnd

Retrieves the current element's end time as an offset from the parent element's begin time.

player

Sets or retrieves the object used to render the media associated with this element.

playerObject

Retrieves the object that plays media files.

progress

Retrieves the current progress of the element's timeline.

rating

Retrieves the rating of the media file.

repeatCount

Retrieves the current iteration in the repetition loop.

repeatCount

Sets or retrieves the number of times an element's timeline repeats.

repeatDur

Sets or retrieves the number of seconds that an element's timeline repeats.

restart

Sets or retrieves the conditions under which an element can be restarted on a timeline.

segmentDur

Retrieves the duration of an element on a timeline in seconds, including autoreverse.

segmentTime

Retrieves the current point in time along a segment of time.

simpleDur

Retrieves the duration of a repeat iteration.

simpleTime

Retrieves an object's current point along its timeline from zero to its dur value.

speed

Sets or retrieves the playback speed of an element relative to its parent time container.

speed

Retrieves the playback speed of an element at run time, which includes the cascading effect of the speed set for the parent time container.

src

Sets or retrieves the source URL of the media.

state

Retrieves the current state of the element's timeline.

stateString

Retrieves the current state of the element's timeline.

syncBehavior

Sets or retrieves a value that indicates the synchronization rules for the element's timeline.

syncMaster

Sets or retrieves whether the time container must synchronize playback to this element.

syncTolerance

Sets or retrieves the time variance allowed on a timeline with locked synchronization.

timeAction

Sets or retrieves what action is taken on the element while the timeline is active.

timeContainer

Sets or retrieves the type of timeline associated with an element.

timeParent

Retrieves the parent time container element of the current element.

title

Retrieves the title of the media file.

type

Sets or retrieves the MIME type of the media object referenced by the src attribute.

updateMode

Specifies or retrieves a value that indicates how the object is to be updated.

URL

Retrieves the URL specified by the Advanced Streaming Format (ASF) file script command after the onurlflip event is fired.

volume

Sets or retrieves the volume of the media file.

volume

Retrieves the playback volume of an element at run time.

Methods

activeTimeToParentTime

Converts a value in the element's active timeline to the corresponding point in the parent timeline.

activeTimeToSegmentTime

Converts a value in the element's active timeline to the corresponding point in the segment timeline.

beginElement

Starts the element on the timeline.

beginElementAt

Starts an element's timeline at the specified time.

documentTimeToParentTime

Converts a value in the document timeline to the corresponding point in the element's parent timeline.

endElement

Stops the element on the timeline.

endElementAt

Ends an element's timeline at the specified time.

parentTimeToActiveTime

Converts a value in the parent timeline to the corresponding point in the element's active timeline.

parentTimeToDocumentTime

Converts a value in the element's parent timeline to the corresponding point in the document timeline.

pauseElement

Stops playing an element's timeline at the current point.

resetElement

Removes any changes made to the element and returns the element to its original state.

resumeElement

Restarts the element's timeline from a paused state.

seekActiveTime

Locates a specified point on the element's active timeline and begins playing from that point.

seekTo

Locates a specified point on the element's segment timeline, including repetitions, and begins playing from that point.

seekToFrame

Locates a specified frame in the object.

segmentTimeToActiveTime

Converts a value in the element's segment timeline to the corresponding point in the element's active timeline.

segmentTimeToSimpleTime

Converts a value in the element's segment timeline to the corresponding point in the element's simple timeline.

simpleTimeToSegmentTime

Converts a value in the element's simple timeline to the corresponding point in the element's segment timeline.

Events

onbegin

Fires when the timeline starts on an element.

onend

Fires when the timeline stops on an element.

onmediacomplete

Fires when the element's associated media finish loading.

onmediaerror

Fires when an element's media file causes any error.

onoutofsync

Fires when the element loses synchronization with its associated timeline.

onpause

Fires when the timeline on an element pauses.

onrepeat

Fires when the timeline repeats on an element, beginning with the second iteration.

onreset

Fires when the timeline reaches the value of the begin attribute or when the resetelement method is called on the element.

onresume

Fires when an element's timeline resumes from a paused state.

onreverse

Fires when the timeline on an element begins to play backward.

onseek

Fires whenever a seek operation is performed on the element.

onsyncrestored

Fires when synchronization is resumed between the element and its associated timeline.

ontimeerror

Fires whenever a time-specific error occurs, usually as a result of setting a property to an invalid value.

ontrackchange

The event fires when a track changes in a playList defined in an ASX file.

onURLFlip

This event fires when an ASF file, played by a HTML+TIME?A href="../time2/elements/media.html">media tag, processes script commands embedded in the asf file.

collections

playList

Retrieves a collection of playItem objects.