video object

Specifies the video content to be played in a document.

HTML5 A vocabulary and associated APIs for HTML and XHTML, Section 4.8.6Internet Explorer 9

DOM Information

Inheritance Hierarchy

 Node
  Element
   HTMLElement
    HTMLMediaElement
      video

Members

The video object has these types of members:

Events

The video object has these events.

EventDescription
canplay

Occurs when playback is possible, but would require further buffering.

canplaythrough

Occurs when playback to end is possible without requiring a stop for further buffering.

durationchange

Occurs when the duration attribute is updated.

emptied

Occurs when the media element is reset to its initial state.

ended

Occurs when the end of playback is reached.

loadeddata

Occurs when media data is loaded at the current playback position.

loadedmetadata

Occurs when the duration and dimensions of the media have been determined.

loadstart

Occurs when Internet Explorer begins looking for media data.

pause

Occurs when playback is paused.

play

Occurs when the play method is requested.

playing

Occurs when the audio or video has started playing.

progress

Occurs to indicate progress while downloading media data.

ratechange

Occurs when the playback rate is increased or decreased.

seeked

Occurs when the seek operation ends.

seeking

Occurs when the current playback position is moved.

stalled

Occurs when the download has stopped.

suspend

Occurs if the load operation has been intentionally halted.

timeupdate

Occurs to indicate the current playback position.

volumechange

Occurs when the volume is changed, or playback is muted or unmuted.

waiting

Occurs when playback stops because the next frame of a video resource is not available.

 

Methods

The video object has these methods.

MethodDescription
addTextTrack

Create a new TextTrack object to add to an HTML5 video.

canPlayType

Returns a string that specifies whether the client can play a given media resource type.

load

Resets the audio or video object and loads a new media resource.

pause

Pauses the current playback and sets paused to true. This can be used to test whether the media is playing or paused. You can also use the pause or play events to tell whether the media is playing or not.

play

Loads and starts playback of a media resource.

 

Properties

The video object has these properties.

PropertyAccess typeDescription

autobuffer

Use the preload element instead. The autobuffer property was initially listed in the W3C spec, but has been dropped. No version of Internet Explorer supports it.

autoplay

Gets or sets a value that indicates whether to start playing the media automatically.

buffered

Gets a collection of buffered time ranges.

controls

Gets or sets a flag that indicates whether the client provides a set of controls for the media (in case the developer does not include controls for the player).

currentSrc

Gets the address or URL of the current media resource (video,audio) that is selected by IHTMLMediaElement.

currentTime

Gets or sets the current playback position, in seconds.

defaultPlaybackRate

Gets or sets the default playback rate when the user is not using fast forward or reverse for a video or audio resource.

duration

Returns the duration in seconds of the current media resource. A NaN value is returned if duration is not available, or Infinity if the media resource is streaming.

ended

Gets information about whether the playback has ended or not.

error

Returns an object representing the current error state of the audio or video element.

height

Gets or sets the height of the video element.

initialTime

Gets the earliest possible position, in seconds, that the playback can begin.

loop

Gets or sets a flag to specify whether playback should restart after it completes.

msIsBoxed

Gets or sets when the video player control is in boxed ( letterbox or pillarbox) mode.

msKeys

Read-only

Gets the MSMediaKeys object, which is used for decrypting media data, that is associated with this media element.

muted

Gets or sets a flag that indicates whether the audio (either audio or the audio track on video media) is muted.

networkState

Gets the current network activity for the element.

paused

Gets a flag that specifies whether playback is paused.

playbackRate

Gets or sets the current rate of speed for the media resource to play. This speed is expressed as a multiple of the normal speed of the media resource.

played

Gets TimeRanges for the current media resource that has been played.

poster

Gets or sets a URL of an image to display, for example, like a movie poster. This can be a still frame from the video, or another image if no video data is available.

preload

Gets or sets a hint to how much buffering is advisable for a media resource, even if autoplay isn't specified.

readyState (media, audio, video)

Read-only

Gets the current state of the media resource.

seekable

Returns a TimeRanges object that represents the ranges of the current media resource that can be seeked.

seeking

Gets a flag that indicates whether the the client is currently moving to a new playback position in the media resource.

src

The address or URL of the a media resource (videoaudio) that is to be considered.

textTracks

Read-only

Returns a list of TextTrack objects from a video object.

videoHeight

Gets the intrinsic height of a video in CSS pixels, or zero if the dimensions are not known.

videoWidth

Gets the intrinsic width of a video in CSS pixels, or zero if the dimensions are not known.

volume

Gets or sets the volume level for audio portions of the media element.

width

Gets or sets the width of the video element.

 

Standards information

Remarks

Note  If you are developing locally or on an intranet and have rendering issues for HTML5, you can add a "meta http-equiv-'X-UA-Compatible' content= " meta command, followed by "IE=edge" to the <head> block of a webpage to force Internet Explorer to use the latest standards. For more information about document compatibility, see Defining Document Compatibility.

Beginning with Windows Internet Explorer 9, any audio or video content needs the correct mime type set on the server, or the files won't play. Internet Explorer 9 supports MP3 audio, and MP4 audio and video. WebM audio and video files can be supported by installing the WebM components from The WebM project. The following table shows the required settings for your web server to host these files correctly.

Media file to serveExtension settingMime type setting
Audio mp3mp3audio/mpeg
Audio mp4 m4aaudio/mp4
Audio WebMwebmaudio/webm
Video mp4mp4video/mp4
Video webmwebmvideo/webm

 

Examples

This example shows how to play a video by using HTML5.

Using one of the following formats, type the name of an MP4-format video file into the text box:

  • Local file syntax: "file://C:\yourfilepath.mp4"
  • Web file syntax: "http://webfilepath.mp4"

<html>
  <head>
    <title>Simple Video Example</title>
     <script type="text/javascript">
         function playVideo() {
             var oInput = document.getElementById('videoFile');   //text box
             var oVideo = document.getElementById('video1');      //video element
             oVideo.src = oInput.value;
             oVideo.play();
         }

         function pauseVideo() {
             var oVideo = document.getElementById('video1');
             oVideo.pause();
         }         
     </script>
</head>
<body>
<video id="video1" >HTML5 video is not supported</video>
<br />
<!-- Preload a video into the text field -->
<input type="text" id="videoFile" style="width:600px" value="http://ie.microsoft.com/testdrive/ieblog/2011/nov/pp4_blog_demo.mp4"/>
<button onclick="playVideo();">Play</button> <button onclick="pauseVideo();">Pause</button>
</body>
</html> 


See also

How to use HTML5 to play video files on your webpage
HTMLVideoElement
Building a simple MPEG-DASH streaming player

 

 

Show:
© 2014 Microsoft