Html5

布尔值，指示 HTML5 技术当前是否支持在进入全屏时自动调整媒体大小。

布尔值，指示 Tech 是否支持音量静音。

布尔值，指示 Tech 是否支持原生 TextTrack。如果浏览器支持原生 TextTrack，这将有助于我们与它们集成。

布尔值，指示 Tech 是否支持改变视频播放速度。示例：

• 将播放器设置为 2 倍（两倍）速播放
• 将播放器设置为 0.5 倍（一半）速播放

布尔值，指示 HTML5 技术当前是否支持 progress 事件。如果为 false，则将触发手动 progress 事件。

布尔值，指示 Tech 是否支持 sourceset 事件。

一个技术（Tech）应将此设置为 true，然后在获取新源后，尽早使用 Tech#triggerSourceset 触发 Tech#event:sourceset。

布尔值，指示 HTML5 技术当前是否支持 timeupdate 事件。如果为 false，则将触发手动 timeupdate 事件。

HTML5 元素是否支持 requestVideoFrameCallback

布尔值，指示 Tech 是否支持音量控制。

布尔值，指示 HTML5 技术当前是否支持媒体元素在 DOM 中移动。如果在 iOS 中移动媒体元素会导致崩溃，因此在此处将其设置为 false。在其他地方，此值应为 true。

Html5 的原生源处理程序，仅将源传递给媒体元素。

查找匹配selector的单个DOM元素。这可以在Component的contentEl()中或另一个自定义上下文中进行。

查找匹配selector的所有DOM元素。这可以在Component的contentEl()中或另一个自定义上下文中进行。

在当前Component中添加一个子Component。

向Component的元素添加CSS类名。

创建远程文本轨道对象并返回一个 HTML 轨道元素。

将一个源元素添加到媒体元素。

创建并返回一个远程 TextTrack 对象。

如果需要，使用 vtt.js 模拟 TextTrack

获取 AudioTrackList

获取媒体元素的 autoplay 值。autoplay 指示媒体应在页面准备就绪后立即开始播放。

从此组件中移除焦点

获取媒体元素的 buffered 值。buffered 是一个 TimeRange 对象，表示媒体中已下载并可供播放的部分。

获取当前视频已缓冲的百分比。

构建默认的DOM类名。应由子组件覆盖。

检查技术是否支持给定的 MIME 类型。

基础技术不支持任何类型，但源处理程序可能会覆盖此功能。

取消传递给Component#requestAnimationFrame (rAF) 的排队回调。

如果你通过 Component#requestAnimationFrame 队列了一个 rAF 回调，请使用此函数而不是 window.cancelAnimationFrame。否则，你的销毁监听器将不会在 Component#dispose 之前被清理！

如果存在，取消当前的命名动画帧。

原生或回退的 requestVideoFrameCallback

获取所有子组件的数组

移除通过 addRemoteTextTrack 添加的，并标记为自动垃圾回收的任何 TextTrack。

清除通过 window.setInterval 或 Component#setInterval 创建的间隔。如果你通过 Component#setInterval 设置了间隔，请使用此函数而不是 window.clearInterval。否则，你的销毁监听器将不会在 Component#dispose 之前被清理！

清除通过 window.setTimeout 或 Component#setTimeout 创建的超时。如果你通过 Component#setTimeout 设置了超时，请使用此函数而不是 window.clearTimout。否则，你的销毁监听器将不会在 Component#dispose 之前被清理！

根据其名称清除单个 TrackList 或 TrackLists 数组。

注意：没有源处理程序的技术应在视频和音频源之间调用此函数。你不想在轨道之间使用它们！

返回Component的DOM元素。子项将插入到此处。这通常与Component#el中返回的元素相同。

获取媒体元素的 controls 值。controls 指示是否应显示或隐藏原生媒体控件。

创建 Html5 技术（Tech）的 DOM 元素。

根据 featuresNativeTextTracks 的值，创建原生 TextTrack 或模拟的 TextTrack。

获取媒体元素的 crossOrigin 值。crossOrigin 指示浏览器应将 Cookie 与不同资产/播放列表的请求一起发送。

获取组件元素的计算宽度或高度。

使用window.getComputedStyle。

获取一个包含组件元素计算宽度和高度值的对象。

使用window.getComputedStyle。

获取组件元素的计算高度。

使用window.getComputedStyle。

获取 HTML5 Tech 上的当前源。如果失败，则回退到从 HTML5 媒体元素获取源。

获取媒体元素的 currentTime 值。currentTime 指示媒体在播放中的当前秒数。

获取组件元素的计算宽度。

使用window.getComputedStyle。

获取媒体元素的 defaultMuted 值。defaultMuted 指示媒体是否应默认静音。仅更改媒体的默认状态。muted 和 defaultMuted 可以有不同的值。Html5#muted 指示当前状态。

获取媒体元素的 defaultPlaybackRate 值。defaultPlaybackRate 指示媒体当前的播放速率。此值在播放开始后将不再指示当前的 playbackRate，请使用 Html5#playbackRate 获取。

示例

• 如果 defaultPlaybackRate 设置为 2，媒体将以两倍速度播放。
• 如果 defaultPlaybackRate 设置为 0.5，媒体将以一半速度播放。

获取或设置Component元素的宽度或高度。这是Component#width和Component#height的共享代码。

需要了解的事项

• 如果宽度或高度是数字，这将返回以“px”为后缀的数字。
• 如果宽度/高度是百分比，这将返回以“%”为后缀的百分比
• 隐藏元素的宽度通过 window.getComputedStyle 获取时为 0。此函数默认为 Component 的 style.width，如果失败则回退到 window.getComputedStyle。有关更多信息，请参阅此链接。
• 如果您想要组件的计算样式，请使用Component#currentWidth和{Component#currentHeight

同时设置Component元素的宽度和高度。

获取视频元素的 'disablePictureInPicture' 值。

销毁 HTML5 媒体元素并移除所有轨道。

获取 HTML5 媒体元素的当前持续时间。

获取Component的DOM元素

检测到触摸事件支持时发出“tap”事件。这用于通过轻触视频来支持切换控件。它们之所以启用，是因为否则每个子组件都会有额外的开销。

模拟文本轨道

此函数在触摸事件发生时报告用户活动。这可以被任何希望触摸事件以其他方式运行的子组件关闭。

当发生触摸事件时报告用户触摸活动。用户活动用于确定何时显示/隐藏控件。对于鼠标事件来说很简单，因为任何鼠标事件都应显示控件。因此，我们捕获冒泡到播放器的鼠标事件，并在发生时报告活动。对于触摸事件，它不像 touchstart 和 touchend 切换播放器控件那么简单。因此，触摸事件也无法在播放器级别帮助我们。

用户活动是异步检查的。因此可能发生的情况是，视频上的轻触事件关闭了控件。然后 touchend 事件冒泡到播放器。如果它报告了用户活动，就会立即重新打开控件。我们也不想完全阻止触摸事件冒泡。此外，touchmove 事件和除轻触之外的任何事件，都不应重新打开控件。

获取媒体元素的 ended 值。ended 指示媒体是否已达到末尾。

请求 HTML5 Tech 进入全屏。

获取媒体元素的 error 值。error 指示播放期间可能发生的任何 MediaError。如果 error 返回 null，则没有当前错误。

请求 HTML5 Tech 退出全屏。

将焦点设置到此组件

获取Component元素上的属性值。

返回具有给定name的子Component。

返回具有给定id的子Component。

返回遵循给定后代 names 的后代 Component。例如，['foo', 'bar', 'baz'] 将尝试获取当前组件上的 'foo'，'foo' 组件上的 'bar'，以及 'bar' 组件上的 'baz'，如果其中任何一个不存在则返回 undefined。

确定此组件是否当前可见/启用/等...

确定此组件是否可被视为可聚焦组件。

检索组件元素的位置和大小信息。

获取 W3C 媒体播放质量 API 指定的可用媒体播放质量指标。

当此Component接收到一个它不处理的keydown事件时，它会将该事件传递给Player进行处理。

许多组件曾有一个 handleKeyPress 方法，其命名不当，因为它监听的是 keydown 事件。此方法名现在委托给 handleKeyDown。这意味着任何调用 handleKeyPress 的人不会看到他们的方法调用停止工作。

处理组件中播放器的语言变化。应由子组件覆盖。

如果 loadstart 事件已触发，但在 video.js 准备好之前，这将触发。发生这种情况的两个已知示例如下：

1. 如果我们在播放对象开始加载后才加载它
2. 媒体已在播放（通常是自动播放），然后

此函数将触发另一个 loadstart，以便 video.js 可以跟上。

检查组件元素是否具有CSS类名。

获取 HTML5 媒体元素的当前高度。

如果Component的元素当前正在显示，则通过向其添加“vjs-hidden”类名来隐藏它。

获取此Component的ID

根据选项添加和初始化默认子Component。

开启 VideoTrackList、AudioTrackList 和 TextTrackList 事件的监听器。

这将为 addtrack 和 removetrack 添加 EventTarget~EventListeners。

确定此组件是否已销毁。

媒体元素 load 函数的包装器。这将调用 HTML5 媒体元素的 load 函数。

给定英文字符串，将字符串本地化。

如果提供了令牌，它将尝试对提供的字符串进行简单的令牌替换。它查找的令牌看起来像{1}，其中索引是令牌数组中的1-indexed。

如果提供了 defaultValue，则在提供的语言文件中找不到值时，将使用该 defaultValue 而非 string。这对于您希望拥有一个描述性的键进行令牌替换，但又希望拥有一个简洁的本地化字符串且不需要包含 en.json 的情况很有用。

目前，它用于进度条计时。

{
  "progress bar timing: currentTime={1} duration={2}": "{1} of {2}"
}

然后像这样使用

this.localize('progress bar timing: currentTime={1} duration{2}',
              [this.player_.currentTime(), this.player_.duration()],
              '{1} of {2}');

输出类似：01:23 of 24:56。

获取媒体元素的 loop 值。loop 指示媒体在到达末尾时应返回媒体开头并继续播放。

关闭在 Tech#manualProgressOn 中创建的 progress 事件的 polyfill。

为不支持原生 progress 事件的浏览器实现 polyfill。

关闭在 Tech#manualTimeUpdatesOn 中创建的 timeupdate 事件的 polyfill。

为不支持 timeupdate 事件的浏览器实现 polyfill。

获取媒体元素的 muted 值。muted 指示媒体的音量应设置为静音。这实际上不会改变 volume 属性。

获取Component的名称。该名称用于引用Component并在注册期间设置。

获取媒体元素的 networkState 值。networkState 指示当前网络状态。它返回以下列表中的一个枚举：

• 0: NETWORK_EMPTY
• 1: NETWORK_IDLE
• 2: NETWORK_LOADING
• 3: NETWORK_NO_SOURCE

通过调用 Tech#duration 在 durationchange 事件上更新我们的内部持续时间。

使用新选项深度合并选项对象。

注意：当obj和options都包含其值为对象的属性时。这两个属性将使用module:obj.merge合并

尝试强制覆盖原生音频轨道。

尝试强制覆盖原生视频轨道。

媒体元素 pause 函数的包装器。这将调用 HTML5 媒体元素的 pause 函数。

获取媒体元素的 paused 值。paused 指示媒体元素当前是否暂停。

媒体元素 play 函数的包装器。这将调用 HTML5 媒体元素的 play 函数。

获取媒体元素的 playbackRate 值。playbackRate 指示媒体当前的播放速率。示例：

• 如果 playbackRate 设置为 2，媒体将以两倍速度播放。
• 如果 playbackRate 设置为 0.5，媒体将以一半速度播放。

获取媒体元素的 played 值。played 返回一个 TimeRange 对象，表示媒体时间线中已播放的部分。

返回Component所附着的Player。

获取媒体元素的 playsinline 值。playsinline 指示浏览器在全屏播放是原生默认行为时（例如在 iOS Safari 中），优先选择非全屏播放。

获取媒体元素的 poster 值。poster 指示当没有媒体数据可用时可以/将显示的图像文件 URL。

获取媒体元素的 preload 值。preload 指示媒体在互动前应下载什么。它可以有以下值：

• none: 不下载任何内容
• metadata: 海报和媒体的前几帧可能会被下载，以获取媒体尺寸和其他元数据
• auto: 允许在互动前下载媒体和媒体的元数据

将监听器绑定到组件的就绪状态。与事件监听器不同，如果就绪事件已经发生，它将立即触发函数。

获取媒体元素的 readyState 值。readyState 指示媒体元素的当前状态。它返回以下列表中的一个枚举：

• 0: HAVE_NOTHING
• 1: HAVE_METADATA
• 2: HAVE_CURRENT_DATA
• 3: HAVE_FUTURE_DATA
• 4: HAVE_ENOUGH_DATA

获取远程 HtmlTrackElementList 元素

获取远程 TextTrackList 元素

从Component的元素中移除属性。

从此Component的子项列表中移除子Component。同时从此Component的元素中移除子Component的元素。

从Component的元素中移除CSS类名。

从 TextTrackList 对象中移除远程 TextTrack

从媒体元素中移除一个源元素。

将回调排队传递给requestAnimationFrame (rAF)，但有一些额外的优点

• 通过回退到Component#setTimeout来支持不支持rAF的浏览器。

• 回调被转换为Component~GenericCallback（即绑定到组件）。

• 如果组件在调用之前被销毁，则会自动取消rAF回调。

请求一个动画帧，但只排队一个命名动画帧。在前面的动画帧完成之前，永远不会添加另一个。

创建一个浮动视频窗口，始终置于其他窗口之上，以便用户在与设备上的其他内容网站或应用程序交互时，可以继续观看媒体。

如果浏览器/技术支持，则使用原生 requestVideoFrameCallback，否则回退。当 DRM 播放时，不要在 Safari 上使用 rVCF，因为它不会触发。这需要在构造函数之后检查。对于 Fairplay 源之后加载的清晰源，这会是一个误报。

通过移除所有源然后调用 Html5.resetMediaElement 来重置技术（Tech）。

获取是否正在快进/倒退。

获取媒体元素的 seekable 值。seekable 返回一个 TimeRange 对象，指示当前可跳转到的时间范围。

获取媒体元素的 seeking 值。seeking 指示媒体当前是否正在跳转到新位置。

设置Component元素上的属性值

在媒体元素上设置 autoplay 值。autoplay 指示媒体应在页面准备就绪后立即开始播放。

为 HTML5 媒体元素设置 controls 属性。

设置媒体元素的 crossOrigin 值。crossOrigin 指示浏览器应将 Cookie 与不同资产/播放列表的请求一起发送。

为 HTML5 技术（Tech）设置当前时间。

在媒体元素上设置 defaultMuted 值。defaultMuted 指示当前音频级别应为静音，但只会影响初始播放时的静音级别。

在媒体元素上设置 defaultPlaybackRate 值。defaultPlaybackRate 指示媒体在初始启动时的播放速率。视频开始播放后更改此值将无效。您应该改用 Html5#setPlaybackRate。

示例值

• 如果 playbackRate 设置为 2，媒体将以两倍速度播放。
• 如果 playbackRate 设置为 0.5，媒体将以一半速度播放。

防止浏览器建议画中画上下文菜单或在某些情况下自动请求画中画。

向另一个元素或组件添加SVG图标元素。

创建一个每x毫秒运行一次的函数。此函数是window.setInterval的包装。但仍有一些原因选择使用此函数。

1. 当Component#dispose被调用时，它通过Component#clearInterval被清除。
2. 函数回调将是Component~GenericCallback

在媒体元素上设置 loop 值。loop 指示媒体在到达末尾时应返回媒体开头并继续播放。

在媒体元素上设置 muted 值。muted 指示当前音频级别应为静音。

在媒体元素上设置 playbackRate 值。playbackRate 指示媒体的播放速率。示例：

• 如果 playbackRate 设置为 2，媒体将以两倍速度播放。
• 如果 playbackRate 设置为 0.5，媒体将以一半速度播放。

设置媒体元素的 playsinline 值。playsinline 指示浏览器在全屏播放是原生默认行为时（例如在 iOS Safari 中），优先选择非全屏播放。

在媒体元素上设置 poster 值。poster 是一个图像文件的 URL，当没有媒体数据可用时可以/将显示。

在媒体元素上设置 preload 值。preload 指示媒体在互动前应下载什么。它可以有以下值：

• none: 不下载任何内容
• metadata: 海报和媒体的前几帧可能会被下载，以获取媒体尺寸和其他元数据
• auto: 允许在互动前下载媒体和媒体的元数据

设置我们是否正在快进/倒退。这用于决定我们是否应使用 fastSeek。fastSeek 用于在 Safari 浏览器上提供跳跃播放。

在媒体元素上设置 src 值。src 指示媒体的当前 Tech~SourceObject。

创建一个在x毫秒超时后运行的函数。此函数是window.setTimeout的包装。但仍有一些原因选择使用此函数

1. 当Component#dispose被调用时，它通过Component#clearTimeout被清除。
2. 函数回调将被转换为Component~GenericCallback

注意：您不能对此函数返回的 ID 使用 window.clearTimeout。这将导致其销毁监听器无法被清理！请改用 Component#clearTimeout 或 Component#dispose。

在媒体元素上设置 volume 值。volume 指示当前音频级别，以小数百分比形式表示。这意味着 1 为 100%，0.5 为 50%，依此类推。

修改媒体元素，以便我们可以检测到源何时更改。在源更改后立即触发 sourceset。

如果Component的元素被隐藏，则通过从其移除“vjs-hidden”类名来显示它。

Html5 技术（Tech）源对象的 getter/setter。

注意：请使用 Html5#setSource

停止在 Tech#trackCurrentTime 中创建的间隔函数，以便不再触发 timeupdate 事件。

关闭在 Tech#manualProgressOn 中创建的 progress 事件的 polyfill。通过清除在 Tech#trackProgress 中设置的间隔来停止手动跟踪 progress 事件。

检查视频元素是否支持全屏。

获取 TextTrackList

向组件的元素添加或移除CSS类名。

• 当Component#hasClass返回false时，添加classToToggle。
• 当Component#hasClass返回true时，移除classToToggle。

设置一个间隔函数，用于跟踪当前时间并每 250 毫秒触发 timeupdate。

这用于在缓冲百分比改变时触发 progress 事件。它设置一个间隔函数，该函数将每 500 毫秒调用一次，以检查缓冲结束百分比是否已改变。

此函数由 Tech#manualProgressOn 调用。

触发此Component的所有就绪监听器。

一个特殊函数，以允许播放器在播放器或技术尚未准备好时重新触发的方式触发源设置。

获取视频元素的 videoHeight 值。videoHeight 指示视频的当前高度（以 CSS 像素为单位）。

获取 VideoTrackList

获取视频元素的 videoWidth 值。videoWidth 指示视频的当前宽度（以 CSS 像素为单位）。

获取媒体元素的 volume 值。volume 指示媒体的当前音频播放音量。volume 的值范围为 0（静音）到 1（最大和默认）。

获取 HTML5 媒体元素的当前宽度。

检查此浏览器/设备中是否可以更改播放速率。

检查此浏览器/设备中是否可以更改音量。许多移动设备无法更改音量。具体来说，在 iOS 上无法将音量从 1 更改。

检查此浏览器/设备中是否可以静音。某些设备（例如 iOS）不允许更改音量，但允许静音/取消静音。

检查我们是否可以使用 Object.defineProperty 覆盖视频/音频元素的属性。

检查技术是否支持给定源

检查技术是否支持给定类型

检查此浏览器/设备是否支持 HTML5 媒体。

检查此浏览器/设备是否支持原生 AudioTrack。

检查此浏览器/设备是否支持原生 TextTrack。

检查此浏览器/设备是否支持原生 VideoTrack。

当 Tech AudioTrackList 上添加或移除轨道时触发。

当组件大小调整时触发。

当Component被销毁时触发。

参见 Player#progress

当Component就绪时触发。

当在技术上设置源导致媒体元素重新加载时触发。

当Component被轻触时触发。

当 Tech TextTrackList 上添加或移除轨道时触发。

触发 timeupdate 事件，因为我们已完成查找且时间已更改。这在播放器暂停以同步时间显示时特别有用。

当 Tech 上的音轨被添加或移除时触发 VideoTrackList

当 vtt.js 加载时触发。