在本页

VideoTrack

单个 VideoTrack 的表示。

构造函数

new VideoTrack(options可选)

创建此类的实例。

参数

名称类型属性默认描述

选项

对象

<可选>

{}

选项名称和值的对象

属性

名称	类型	属性	默认	描述
`类型`	字符串	<可选>	''	一个有效的 VideoTrack~Kind
`ID`	字符串	<可选>	'vjs_track_' + Guid.newGUID()	此AudioTrack的唯一ID。
`标签`	字符串	<可选>	''	此轨道的菜单标签。
`语言`	字符串	<可选>	''	有效的两位字符语言代码。
`选中`	布尔值	<可选>		如果此轨道是当前正在播放的轨道。

源: tracks/video-track.js, 第11行
参见: 规范

继承

Track

成员

(受保护) allowedEvents_

一个对象，其中包含事件名称作为键，布尔值作为值。

注意：如果此处将事件名称设置为true，EventTarget#trigger将具有额外功能。有关更多信息，请参阅该函数。

属性

名称	类型	描述
`EventTarget.prototype.allowedEvents_`

覆盖: Track#allowedEvents_
源: event-target.js, 第190行

(只读) id :字符串

此轨道的ID。创建后无法更改。

类型

字符串

覆盖: Track#id
源: tracks/track.js, 第50行

(只读) kind :字符串

此轨道的类型。创建后无法更改。

类型

字符串

覆盖: Track#kind
源: tracks/track.js, 第59行

label :字符串

此轨道的标签。创建后无法更改。

类型

字符串

覆盖: Track#label
源: tracks/track.js, 第87行

触发

Track#event:labelchange

(只读) language :字符串

此轨道的两位字母语言代码。创建后无法更改。

类型

字符串

覆盖: Track#language
源: tracks/track.js, 第68行

selected :布尔值

此 VideoTrack 是否被选中。设置此属性时，如果选中状态发生变化，将触发 VideoTrack#selectedchange 事件。

类型

布尔值

源: tracks/video-track.js, 第43行

触发

VideoTrack#event:selectedchange

方法

addEventListener()

EventTarget#on 的别名。允许 EventTarget 模拟标准 DOM API。

覆盖: Track#addEventListener
源: event-target.js, 第199行
参见: EventTarget#on

any(type, fn)

此函数将添加一个 事件监听器，该监听器只触发一次，并从所有事件中移除。这类似于使用 EventTarget#on 添加一个 事件监听器 数组，在首次触发时对所有事件调用 EventTarget#off。

参数

名称	类型	描述
`类型`	字符串 \| 字符串数组	一个事件名称或事件名称数组。
`函数`	函数	为每个事件名称调用一次的函数。

覆盖: Track#any
源: event-target.js, 第83行

dispatchEvent()

EventTarget#trigger 的别名。允许 EventTarget 模拟标准 DOM API。

覆盖: Track#dispatchEvent
源: event-target.js, 第217行
参见: EventTarget#trigger

off(type, fn)

从EventTarget实例中移除特定事件的事件监听器。这使得当指定事件发生时，事件监听器将不再被调用。

参数

名称	类型	描述
`类型`	字符串 \| 字符串数组	一个事件名称或事件名称数组。
`函数`	函数	要移除的函数。

覆盖: Track#off
源: event-target.js, 第48行

on(type, fn)

向EventTarget实例添加一个事件监听器。事件监听器是一个函数，当某个名称的事件被触发时，该函数将被调用。

参数

名称	类型	描述
`类型`	字符串 \| 字符串数组	一个事件名称或事件名称数组。
`函数`	函数	使用`EventTarget`s调用的函数。

覆盖: Track#on
源: event-target.js, 第28行

one(type, fn)

此函数将添加一个 事件监听器，该监听器只触发一次。首次触发后，它将被移除。这类似于使用 EventTarget#on 添加一个 事件监听器，该监听器会对自己调用 EventTarget#off。

参数

名称	类型	描述
`类型`	字符串 \| 字符串数组	一个事件名称或事件名称数组。
`函数`	函数	为每个事件名称调用一次的函数。

覆盖: Track#one
源: event-target.js, 第62行

removeEventListener()

EventTarget#off 的别名。允许 EventTarget 模拟标准 DOM API。

覆盖: Track#removeEventListener
源: event-target.js, 第208行
参见: EventTarget#off

trigger(event)

此函数会触发一个事件的发生。这将导致所有等待该事件的事件监听器被调用。如果事件没有事件监听器，则什么都不会发生。

如果正在触发的事件名称在EventTarget.allowedEvents_中，Trigger 还会调用 on + uppercaseEventName 函数。

示例：'click' 在EventTarget.allowedEvents_中，因此，如果存在，Trigger 将尝试调用 onClick。

参数

名称	类型	描述
`事件`	字符串 \| EventTarget~事件 \| 对象	事件的名称，一个`Event`对象，或一个其类型键设置为事件名称的对象。

覆盖: Track#trigger
源: event-target.js, 第108行

类型定义

类型

所有可能的 VideoTrackKind

源: tracks/track-enums.js, 第5行
参见: https://html.whatwg.com.cn/multipage/embedded-content.html#dom-videotrack-kind

事件

标签变化

当此轨道上的label属性更改时触发的事件。

注意：这不是规范的一部分！

类型

Event

覆盖: Track#event:labelchange
源: tracks/track.js, 第103行

选中状态变化

当此轨道的选中状态发生变化时触发的事件。这使得包含此轨道的 VideoTrackList 能够相应地进行操作。

注意：这不是规范的一部分！原生轨道将在内部完成此操作，无需事件。

类型

Event

源: tracks/video-track.js, 第63行