实时追踪器

一个用于检查实时当前时间并确定播放器何时处于或落后于直播边缘的类。

构造函数

new LiveTracker(player, options可选)

创建此类的实例。

参数
名称类型属性描述
播放器播放器

此类应附着到的Player

选项对象<可选>

播放器选项的键/值存储。

属性
名称类型属性默认描述
追踪阈值数字<可选>
20

媒体需要具备的直播窗口(可搜索结束时间 - 可搜索开始时间)秒数,达到此值后才会显示直播UI。

直播容差数字<可选>
15

落后于直播多少秒后,我们才会被视为非直播。请注意,这仅在播放处于直播边缘时使用。这允许大的可搜索结束时间变化不影响我们是否处于直播状态。

方法

atLiveEdge() → {布尔值}

确定当前时间是否处于直播边缘,并且不会在每次可搜索结束时间改变时落后。

返回

播放是否处于直播边缘

类型: 
布尔值

behindLiveEdge() → {布尔值}

如果我们当前落后于直播边缘,即当前时间将在可搜索结束时间改变时落后。

返回

如果我们落后于直播边缘

类型: 
布尔值

dispose()

销毁 liveTracker

handleDurationchange()

处理播放器上的 durationchange 事件并相应地开始/停止追踪。

handleFirstTimeupdate()

如果 live tracker 开始追踪时播放器尚未播放,则处理播放器上的首次 timeupdate。

handlePlay()

处理播放器上的首次播放,并确保我们直接跳到直播边缘。

handleSeeked()

记录搜索开始的时间,并监听 seeked 事件以找到搜索结束的位置。

isLive() → {布尔值}

确定播放器是否处于直播状态,仅检查此组件是否正在追踪直播播放。

返回

liveTracker 是否正在追踪

类型: 
布尔值

isTracking()

live tracker 当前是否正在追踪。

liveCurrentTime() → {数字}

获取我们期望的实时当前时间

返回

期望的实时当前时间

类型: 
数字

liveWindow() → {数字}

获取直播时间窗口,即可搜索开始时间和实时当前时间之间的时间量。

返回

直播视频中可搜索的秒数。

类型: 
数字

nextSeekedFromUser()

下一个 seeked 事件来自用户。这意味着任何搜索

落后直播2秒将被真正视为落后直播,并且 liveTolerance 将被忽略。

pastSeekEnd() → {数字}

可搜索结束时间改变后经过的秒数。一旦可搜索结束时间改变,此值将重置为0。

返回

超过当前可搜索结束时间的秒数

类型: 
数字

reset_()

停止追踪,并将所有内部变量设置为其初始值。

seekToLiveEdge()

如果我们落后于直播边缘,则跳到直播边缘。

seekableEnd() → {数字}

一个获取播放器可搜索结束时间的辅助函数,这样我们就无需到处进行空值检查。

返回

最远的可搜索结束时间或无穷大。

类型: 
数字

seekableStart() → {数字}

一个获取播放器可搜索开始时间的辅助函数,这样我们就无需到处进行空值检查。

返回

最早的可搜索开始时间或0。

类型: 
数字

startTracking()

开始追踪直播播放

stopTracking()

停止追踪直播播放

toggleTracking()

开始/停止追踪

trackLive_()

所有用于追踪可搜索结束时间何时改变以及我们应该超出可搜索结束时间多远的功能。