音频轨道列表

媒体文件的当前音频轨道列表。

构造函数

new AudioTrackList(tracks可选)

创建此类的实例。

参数
名称类型属性默认描述
轨道数组。<音频轨道><可选>
[]

用于实例化列表的音频轨道列表。

参见

继承

成员

(受保护) allowedEvents_

可以通过 on + eventName 调用的事件。参见 EventHandler。

属性
名称类型描述
TrackList#allowedEvents_对象

length :数字

此 Tracklist 中当前 Track 的数量。

类型
  • 数字

方法

addEventListener()

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

addTrack(track)

将一个音频轨道添加到AudioTrackList

参数
名称类型描述
轨道AudioTrack

要添加到列表的音频轨道

any(type, fn)

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

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

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

函数函数

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

dispatchEvent()

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

off(type, fn)

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

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

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

函数函数

要移除的函数。

on(type, fn)

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

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

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

函数函数

使用EventTargets调用的函数。

one(type, fn)

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

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

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

函数函数

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

removeEventListener()

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

removeTrack(rtrack)

TrackList中移除一个轨道

参数
名称类型描述
rtrack轨道

要从列表中移除的音频、视频或文本轨道。

trigger(event)

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

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

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

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

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

事件

添加轨道

当轨道被添加到轨道列表时触发。

类型
属性
名称类型描述
轨道轨道

被添加轨道的引用。

改变

当选择/启用不同轨道时触发。

类型

移除轨道

当轨道从轨道列表中移除时触发。

类型
属性
名称类型描述
轨道轨道

被移除轨道的引用。