Player

获取或设置 Player 的 crossorigin 选项。对于 HTML5 播放器，这将设置 <video> 标签上的 crossOrigin 属性以控制 CORS 行为。

播放器的全局枚举。

键是播放器 ID，值是 Player 实例或已销毁播放器的 null。

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

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

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

向Component的元素添加CSS类名。

创建一个远程 TextTrack 和一个 HTMLTrackElement。

添加一个

一个用于将 TextTrack 添加到 TextTrackList 的辅助方法。

除了 W3C 设置之外，我们还允许通过选项添加额外信息。

Player 宽高比的获取器/设置器。

获取当前的 audioOnlyMode 状态或将 audioOnlyMode 设置为 true 或 false。

将此设置为 true 将隐藏所有播放器组件，除了控制栏以及仅视频所需的控制栏组件。

获取当前的 audioPosterMode 状态或将 audioPosterMode 设置为 true 或 false

获取 AudioTrackList

获取或设置自动播放选项。当这是一个布尔值时，它将修改技术上的属性。当这是一个字符串时，技术上的属性将被移除，Player 将在加载开始时处理自动播放。

从此组件中移除焦点

获取或设置播放器上的断点。

使用对象或 true 调用此方法将移除任何先前的自定义断点并从默认值重新开始。

获取一个 TimeRange 对象，其中包含已下载视频的时间数组。如果您只想要已下载视频的百分比，请使用 bufferedPercent。

获取最后一个缓冲时间范围的结束时间。这在进度条中用于封装所有时间范围。

获取已下载视频的百分比（以小数形式）。此方法不是原生 HTML 视频 API 的一部分。

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

检查播放器是否可以播放给定的 MIME 类型

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

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

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

获取所有子组件的数组

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

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

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

获取或设置控制器是否显示。

创建 Player 的 DOM 元素。

创建一个简单的模态对话框（ModalDialog 组件的一个实例），它会立即用任意内容覆盖播放器，并在关闭时自行移除。

获取或设置 Player 的 crossOrigin 选项。对于 HTML5 播放器，这将设置 <video> 标签上的 crossOrigin 属性以控制 CORS 行为。

获取当前断点名称（如果有）。

获取当前断点类名。

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

使用window.getComputedStyle。

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

使用window.getComputedStyle。

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

使用window.getComputedStyle。

返回当前源对象。

返回所有当前源对象。

返回当前源值的完全限定 URL，例如 http://mysite.com/video.mp4。可与 currentType 结合使用，以帮助重建当前源对象。

获取或设置当前时间（以秒为单位）

获取当前源类型，例如 video/mp4。这可以允许您重建当前源对象，以便以后可以加载相同的源和技术。

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

使用window.getComputedStyle。

设置调试模式以启用/禁用信息级别的日志。

获取当前的 defaultMuted 状态，或开启或关闭 defaultMuted。defaultMuted 表示初始播放时的静音状态。

  var myPlayer = videojs('some-player-id');

  myPlayer.src("http://www.example.com/path/to/video.mp4");

  // get, should be false
  console.log(myPlayer.defaultMuted());
  // set to true
  myPlayer.defaultMuted(true);
  // get should be true
  console.log(myPlayer.defaultMuted());

获取或设置当前默认播放速率。例如，默认播放速率 1.0 表示正常速度，0.5 表示半速播放。defaultPlaybackRate 仅表示视频的初始播放速率，而不是当前播放速率。

Player 宽度和高度的获取器/设置器。

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

获取或设置禁用画中画模式。

销毁视频播放器并执行所有必要的清理。

如果您正在动态地向 DOM 添加和移除视频，这会特别有用。

当文档全屏改变事件触发时，它会调用此方法

通常以秒为单位获取视频的时长；在除极少数用例之外的所有情况下，都不会向该方法传递参数

注意：视频必须已开始加载才能知道时长，并且根据预加载行为，可能直到视频开始播放才能知道。

获取Component的DOM元素

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

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

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

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

返回播放器是否处于“已结束”状态。

当不支持全屏时，我们可以将视频容器拉伸到浏览器允许的最大宽度。

设置或获取当前 MediaError

退出全窗口

将视频从全屏模式返回到正常大小

退出画中画模式。

Player 上 vjs-fill 类名的获取器/设置器/切换器。

开启此功能将关闭流体模式。

Player 上 vjs-fluid 类名的获取器/设置器/切换器。

开启此功能将关闭填充模式。

将焦点设置到此组件

检查是否通过 ESC 键调用退出全窗口或全屏

获取Component元素上的属性值。

获取缓存值的对象。

返回具有给定name的子Component。

返回具有给定id的子Component。

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

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

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

获取此播放器当前Player~MediaObject的克隆。

如果尚未调用loadMedia方法，将尝试根据播放器的当前状态返回一个Player~MediaObject。

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

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

当此播放器接收到快捷键 keydown 事件时调用。支持的播放器范围内的快捷键有

f - 切换全屏 m - 切换静音 k 或 Space - 切换播放/暂停

当此播放器获得焦点并按下某个键时，或当此播放器的任何组件收到其未处理的按键事件时调用。这允许播放器范围内的快捷键（无论是如下定义的，还是由外部函数可选定义的）。

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

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

执行源设置和获取逻辑

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

添加/移除 vjs-has-started 类

Player高度的 getter/setter。返回播放器的配置值。要获取当前高度，请使用currentheight()。

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

获取此Component的ID

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

获取或设置音频标志

确定此组件是否已销毁。

检查播放器是否处于全屏模式，或者告知播放器是否处于全屏模式。

注意：根据最新的 HTML5 规范，isFullscreen 不再是官方属性，而是使用 document.fullscreenElement。但 isFullscreen 对于播放器内部运作仍然是一个有价值的属性。

检查播放器是否处于画中画模式，或者告知播放器是否处于画中画模式。

设置或获取播放器的语言代码。

更改语言将触发languagechange事件，组件可利用此事件更新控制文本。ClickableComponent 默认会在languagechange事件上更新其控制文本。

获取播放器的语言字典。每次都合并，因为新添加的插件可能随时调用 videojs.addLanguage()。直接在播放器选项中指定的语言具有优先权。

开始加载 src 数据。

使用MediaObject填充播放器。

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

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

如果提供了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。

获取或设置视频元素的循环属性。

处理自动播放字符串值，而不是应由技术栈处理的典型布尔值。请注意，这不是任何规范的一部分。有效值及其作用可以在 Player#autoplay() 的自动播放 getter 上找到。

获取当前的静音状态，或开启/关闭静音

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

返回元素的当前网络活动状态，来自以下列表中的代码。

• NETWORK_EMPTY (数值 0) 元素尚未初始化。所有属性均处于其初始状态。
• NETWORK_IDLE (数值 1) 元素的资源选择算法处于活动状态并已选择了一个资源，但此时并未实际使用网络。
• NETWORK_LOADING (数值 2) 用户代理正在积极尝试下载数据。
• NETWORK_NO_SOURCE (数值 3) 元素的资源选择算法处于活动状态，但尚未找到可用的资源。

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

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

暂停视频播放

检查播放器是否已暂停或尚未播放

尝试在第一时间开始播放。

获取或设置当前播放速率。例如，播放速率 1.0 表示正常速度，0.5 表示半速播放。

设置或获取当前播放速率。接受一个数组并用新项目更新播放速率菜单。传入一个空数组将隐藏菜单。非数组值将被忽略。

获取一个 TimeRange 对象，表示用户已播放的时间范围。

返回Component所附着的Player。

设置或取消设置 playsinline 属性。Playsinline 告知浏览器非全屏播放是首选。

获取或设置海报图片的源 URL

获取或设置预加载属性

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

返回一个值，表示元素相对于渲染当前播放位置的当前状态，来自以下列表中的代码。

• HAVE_NOTHING (数值 0) 没有关于媒体资源的可用信息。
• HAVE_METADATA (数值 1) 已获得足够的资源，使得资源的持续时间可用。
• HAVE_CURRENT_DATA (数值 2) 当前播放位置的即时数据可用。
• HAVE_FUTURE_DATA (数值 3) 当前播放位置的即时数据可用，并且有足够的数据供用户代理在播放方向上推进当前播放位置。
• HAVE_ENOUGH_DATA (数值 4) 用户代理估计有足够的数据可供播放不中断地进行。

计算视频剩余时间。不是原生视频 API 的一部分。

一个剩余时间函数，旨在当时间需要直接显示给用户时使用。

获取远程HtmlTrackElementList轨道。

获取远程TextTrackList

从Component的元素中移除属性。

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

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

从相应的TextTrackList和HtmlTrackElementList中移除一个远程TextTrack。

移除一个

报告用户活动

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

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

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

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

将视频尺寸增加到全屏。在某些浏览器中，全屏不支持原生模式，因此会进入“全窗口模式”，视频将填充浏览器窗口。在支持原生全屏的浏览器和设备中，有时会显示浏览器的默认控件，而不是 Video.js 自定义皮肤。这包括大多数移动设备（iOS、Android）和旧版本的 Safari。

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

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

这可以使用文档画中画（document picture-in-picture）或元素画中画（element picture in picture）

在支持的浏览器上，将enableDocumentPictureInPicture设置为true以使用 docPiP；否则，将disablePictureInPicture设置为false以禁用支持浏览器上的 elPiP。

重置播放器。加载 techOrder 中的第一个技术，移除现有tech中的所有文本轨道，并调用tech上的reset。

通过调用重置控制栏所有组件的子方法来重置控制栏的用户界面。

重置播放比例

重置技术的进度，以便在用户界面中重置进度条

重置音量条

获取或设置一个标志，指示此播放器是否应根据其尺寸调整其用户界面。

当播放回调被延迟时，我们必须在实际在技术栈上调用播放时运行这些回调。此函数运行被延迟的回调并接受来自技术栈的返回值。

当播放终止时，这些函数将被运行。如果运行了 runPlayCallbacks_，则这些函数将不被运行。这使我们能够区分终止的播放和实际的播放调用。

设置或返回用户是否正在“拖动”。“拖动”是指用户点击了进度条滑块并沿进度条拖动它。

获取当前可用于跳转的媒体时间范围（TimeRanges）。

返回播放器是否处于“正在跳转”状态。

根据技术顺序或源顺序选择源。如果options.sourceOrder为真，则使用源顺序选择；否则，默认为技术顺序选择。

设置Component元素上的属性值

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

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

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

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

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

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

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

获取或设置视频源。

检查当前技术栈是否支持原生全屏（例如，带有 iOS 等内置控件）

返回对当前Tech的引用。默认情况下，它会打印关于直接使用该技术栈的危险警告，但传入任何参数都会消除该警告。

获取 TextTrackList

返回一个表示当前轨道信息的 JavaScript 对象。不以 JSON 格式返回

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

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

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

更新内部源缓存，以便我们从src()、currentSource()和currentSources()返回正确的源。

注意：如果传入的源已存在于当前currentSources缓存中，则currentSources不会更新。

获取/设置用户是否活跃

开启/关闭原生控件。原生控件是设备内置的控件（例如，iPhone 默认控件）或其他技术栈（例如，Vimeo 控件）。此设置应仅由当前技术栈设置，因为只有技术栈才知道它是否支持原生控件

报告播放器是否按名称使用某个插件。

对于基本插件，这仅报告该插件是否曾在该播放器上初始化过。

返回一个包含 Video.js 版本的对象。

获取视频高度

获取 VideoTrackList

获取视频宽度

获取或设置媒体的当前音量

`Player` 宽度的 getter/setter。返回播放器的配置值。要获取当前宽度，请使用 `currentWidth()`。

获取标签设置

描述单个媒体的对象。

不属于此类型描述的属性将被保留；因此，这也可以被视为一种通用的元数据存储机制。

表示将要通过名称在播放器上设置插件。该名称是插件的名称。

在音频/视频加载中止时触发。

表示将要设置一个插件到播放器上。

媒体的 readyState 为 HAVE_FUTURE_DATA 或更高。

媒体的 readyState 为 HAVE_ENOUGH_DATA 或更高。这意味着整个媒体文件可以不经过缓冲播放。

当组件大小调整时触发。

播放器被处置时调用。

当前播放列表为空时触发。

媒体资源播放结束时触发 (currentTime == duration)

当播放器进入画中画模式时触发此事件。

当播放器语言更改时触发

当播放器离开画中画模式时触发此事件。

当浏览器加载完音频/视频的当前帧时触发。

当播放器在当前播放位置下载完数据时触发。

当浏览器加载完音频/视频的元数据时触发。

当播放器获得初始时长和尺寸信息时触发。

当用户代理开始查找媒体数据时触发。

媒体暂停时触发。

每当发生 Tech#play 事件时触发。表示播放已开始或恢复。

当播放器中的播放速率更改时触发。

播放器大小更改时调用。

媒体不再被阻止播放，并已开始播放。

表示已在播放器上设置了一个插件。

当播放器上的海报图像更改时触发此事件。

当用户代理正在下载媒体数据时触发。

当音频/视频的播放速度更改时触发。

当Component就绪时触发。

当视频的固有尺寸更改时触发。

当播放器完成跳到新时间点时触发。

每当播放器跳到新时间点时触发。

实验性 当在 Tech 上设置或更改源导致媒体元素重新加载时触发。

它将针对初始源和每个后续源触发。此事件是 Video.js 的自定义事件，由 Tech 触发。

此事件的事件对象包含一个 `src` 属性，该属性将包含事件触发时可用的源。这通常仅在 Video.js 在源更改时切换技术时才需要。

当在播放器（或媒体元素）上调用 `load` 时也会触发此事件，因为 `load` 的规范表明资源选择算法需要中止并重新启动。在这种情况下，`src` 属性很可能被设置为空字符串 `""`，以表示我们不知道源将是什么，但它正在更改。

此事件目前仍处于实验阶段，可能会在次要版本中更改。 要使用此功能，请将 `enableSourceset` 选项传递给播放器。

当浏览器尝试获取媒体数据但数据不可用时触发。

当浏览器有意不获取媒体数据时触发。

当Component被轻触时触发。

当从 tech 获得 textdata 事件时触发。

当文本轨道更改时触发。

当当前播放位置更改时触发。

当当前播放位置更改时触发 * 在播放过程中，这会根据所使用的播放技术，每 15-250 毫秒触发一次。

播放器正在使用自定义 HTML 控件

播放器正在使用原生设备控件

当音量更改时触发。

当音量更改时触发。

DOM 元素上的 readyState 更改导致播放停止。

表示已通过名称在播放器上设置了一个插件。该名称是插件的名称。