Interface GroupProgress

组级（整组连续播放）进度聚合 —— 加法式新增，不替换章节级 V2Progress。 由「各章节 duration 的累计（getGroupChapterTimeMap）」+「当前章节 index」+「当前章节内时间」派生。 字段语义与 Legacy GlobalProgress 对齐，使展示端进度条 UI 可平滑复用。

interface GroupProgress {
    currentChapterIndex: number;
    currentChapterTime: number;
    currentChapterTotalTime: number;
    groupCurrentTime: number;
    groupTotalTime: number;
    percentage: number;
    totalChapters: number;
}

Properties

currentChapterIndex currentChapterTime currentChapterTotalTime groupCurrentTime groupTotalTime percentage totalChapters

Properties

currentChapterIndex

currentChapterIndex: number

当前章节索引（0-based；无当前章节为 -1）

currentChapterTime

currentChapterTime: number

当前章节内时间(ms)（即 V2Progress.currentTime）

currentChapterTotalTime

currentChapterTotalTime: number

当前章节总时长(ms)（即 V2Progress.totalTime）

groupCurrentTime

groupCurrentTime: number

组级当前时间(ms) = 先序章节 duration 之和 + 当前章节内 currentTime（钳制）

groupTotalTime

groupTotalTime: number

组级总时长(ms) = 所有章节 duration 之和

percentage

percentage: number

组级进度百分比 [0,100] = groupCurrentTime / groupTotalTime * 100（groupTotalTime=0 时为 0）

totalChapters

totalChapters: number

章节总数

Settings

Member Visibility

On This Page

Properties