目录

HTMLMediaElement

 

HTML媒体元素接口在属性和方法中添加了 HTML元素来支持基础的媒体相关的能力,就像 <audio><video> 一样。HTML 视频元素和 HTML 音频元素元素都继承自此接口。

HTMLMediaElement()

继承层次

Object.prototype
 Function.prototype
  EventTarget
   Node
    Element
     HTMLElement
      HTMLMediaElement

构造函数

程序不能直接调用该构造函数,否则将会产生异常。

属性列表

属性说明
--

方法列表

语法说明
--

HTMLMediaElement.prototype

继承层次

Object.prototype
 EventTarget.prototype
  Node.prototype
   Element.prototype
    HTMLElement.prototype
     HTMLMediaElement.prototype

属性列表

从父元素继承的属性, HTML 元素。

属性说明
audioTracksAudioTrackList类型,表示在该元素中包含的AudioTrack对象列表。
autoplayBoolean 类型,表示autoplay的HTML属性,表明在视频加载可用时是否不中断地自动播放资源。
buffered 只读,TimeRanges 类型,在访问缓冲属性时, 浏览器已缓冲的媒体源的范围 (如果存在)。返回的 TimeRanges 对象已规范化。
controllerMediaController类型,表示与元素关联的媒体控制器, 如果没有链接, 则为 null。
controlsBoolean类型,反映 controls html 属性, 指示是否应显示用于控制资源的用户界面项。
crossOriginDOMString, 此图像元素的 cors 设置。
currentSrc 只读,DOMString, 所选媒体资源的绝对 url (例如, 如果服务器基于用户显示的分辨率选择一个媒体文件), 或者如果 networkState 为空, 则为空字符串。
currentTimedouble类型,当前播发时间,单位为秒。为其赋值将会使媒体跳到一个新的时间。
defaultMutedBoolean类型,反映muted html 属性, 指示默认情况下是否应为媒体元素的音频输出静音。此属性没有动态效果, 要静音和取消静音音频输出, 请使用静音属性。
defaultPlaybackRatedouble类型, 媒体的默认回放速率。1.0 是 “正常速度”, 数值低于1.0媒体播放速度比正常慢, 更高的值使其播放速度更快。0.0值为无效并引发 NOT_SUPPORTED_ERR 异常。
duration只读,double类型,媒体的长度以秒为单位, 如果没有可用的媒体数据, 则为零。 如果媒体数据可用, 但长度未知, 则此值为 NaN。 如果媒体是流式的并且没有预定义的长度, 则该值为 Inf。
ended只读,Boolean类型,指示媒体元素是否已结束回放。
error只读,MediaError类型,最近错误的 MediaError 对象, 如果没有出错, 则为 null。
loopBoolean类型,反映循环 html 属性, 指示媒体元素是否应在到达结束时开始。
mediaGroupDOMString, 反映 mediagroup html 属性, 指示它所属的元素组的名称。一组媒体元素共享一个通用控制器。
mutedBoolean类型,如果音频为静音, 则为 true, 否则为 false。
networkStateunsigned short 类型, 通过网络获取媒体的当前状态。
paused 只读,Boolean类型,指示媒体元素是否已暂停。
playbackRatedouble类型,媒体回放的当前速率。这用于实现快速向前、慢动作等用户控件。正常回放速率乘以此值以获取当前速率, 因此, 值为 “a” 表示正常速度。
played只读,TimeRanges类型,浏览器播放的媒体源的范围 (如果存在)。
preloadDOMString类型,反映预加载 html 属性, 指示应预先加载的数据 (如果存在)。可能的值是: none, metadata, auto。
readyState 只读,unsigned short类型, 媒体的准备状态。
seekable 只读,TimeRanges类型,用户可以寻求的时间范围 (如果存在)。
seeking 只读,Boolean类型,指明媒体是否正在寻求新的位置。
srcDOMString类型,反映 src html 属性, 其中包含要使用的媒体资源的 url。Gecko 实现了类似的功能流: mozSrcObject。
textTracksTextTrackList 类型, 表示元素中包含的 TextTrack 对象的列表。
videoTracksVideoTrackList 类型,表示元素中包含的 VideoTrack 对象的列表。
volumedouble 类型,音频音量, 从 (无声) 到 (最大声).

方法列表

没有特殊的方法; 继承了父对象 HTMLElement 的方法。

语法说明
canPlayType() 确定是否可以回放指定的媒体类型。
fastSeek()直接寻求给定的时间。
load()重置媒体元素并重新开始选择媒体资源。 任何未决事件都将被丢弃。 获取的媒体数据的多少仍然受预加载属性的影响。 在删除任何 src 属性和源元素后代后, 此方法对于释放资源非常有用。 否则, 通常不需要使用此方法, 除非在动态更改后重新扫描源元素子级。
pause()暂停媒体播放。
play()开始播放媒体。

HTMLMediaElement实例

不存在 HTMLMediaElement 接口的直接实例。

参考

相关页面

外部链接