AudioTrack

单个AudioTrack的表示。如果它是AudioTrackList的一部分,则列表中只有一个AudioTrack会被同时启用。

构造函数

new AudioTrack(options可选)

创建此类的实例。

参数
名称类型属性默认描述
选项对象<可选>
{}

选项名称和值的对象

属性
名称类型属性默认描述
类型AudioTrack~类型<可选>
''

有效的音频轨道类型

ID字符串<可选>
'vjs_track_' + Guid.newGUID()

此AudioTrack的唯一ID。

标签字符串<可选>
''

此轨道的菜单标签。

语言字符串<可选>
''

有效的两位字符语言代码。

已启用布尔值<可选>

如果此轨道是当前正在播放的轨道。如果此轨道是AudioTrackList的一部分,则只会启用一个AudioTrack

参见

继承

成员

(受保护的) allowedEvents_

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

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

属性
名称类型描述
EventTarget.prototype.allowedEvents_

enabled :布尔值

AudioTrack是否已启用。设置此属性时,如果enabled的状态发生改变,将触发AudioTrack#enabledchange事件。

类型
  • 布尔值
触发

(只读) id :字符串

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

类型
  • 字符串
覆盖

(只读) kind :字符串

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

类型
  • 字符串

label :字符串

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

类型
  • 字符串
触发

(只读) language :字符串

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

类型
  • 字符串

方法

addEventListener()

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

any(类型, 函数)

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

参数
名称类型描述
类型字符串 | 字符串数组

一个事件名称或事件名称数组。

函数函数

为每个事件名称只调用一次的函数。

覆盖

dispatchEvent()

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

off(类型, 函数)

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

参数
名称类型描述
类型字符串 | 字符串数组

一个事件名称或事件名称数组。

函数函数

要移除的函数。

覆盖

on(类型, 函数)

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

参数
名称类型描述
类型字符串 | 字符串数组

一个事件名称或事件名称数组。

函数函数

要调用的函数。

覆盖

one(类型, 函数)

此函数将添加一个只触发一次的事件监听器。首次触发后,它将被移除。这就像使用EventTarget#on添加一个事件监听器,该监听器会自行调用EventTarget#off

参数
名称类型描述
类型字符串 | 字符串数组

一个事件名称或事件名称数组。

函数函数

为每个事件名称只调用一次的函数。

覆盖

removeEventListener()

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

trigger(事件)

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

如果正在触发的Event的名称在EventTarget.allowedEvents_中。Trigger还将调用on + uppercaseEventName函数。

示例:'click'在EventTarget.allowedEvents_中,因此,如果存在onClick,触发器将尝试调用它。

参数
名称类型描述
事件字符串 | EventTarget~事件 | 对象

事件名称,一个Event,或者一个将类型键设置为事件名称的对象。

类型定义

类型

所有可能的AudioTrackKind

事件

enabledchange

当此轨道上的enabled属性更改时触发的事件。这使得持有此轨道的AudioTrackList能够相应地做出响应。

注意:这不是规范的一部分!原生轨道将在内部执行此操作,而无需事件。

类型

labelchange

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

注意:这不是规范的一部分!

类型