学员端课程学习 - 智萃分段视频

当视频任务为智萃分段（activity_video.mediaSource=segment）时，GET /api/app/course/{courseId}/task/{taskId}/learning 的 activity.media 会额外返回以下字段，供播放器定位分段区间。

分段视频 media 扩展字段

字段	类型	说明
startAt	number	分段起始时间（毫秒），在整视频中的相对位置
endAt	number	分段结束时间（毫秒），在整视频中的相对位置
segmentId	number	分段 ID（course_video_segment.id）
headerLength	number/null	片头时长（秒），仅在开启片头功能且片头视频存在且转换成功时返回，否则为 null

说明

• 非分段视频（mediaSource=self、livereplay 或外链）不返回上述字段（或为 null）
• initPos、rememberLastPos、mediaLength 沿用原有逻辑，播放器根据 startAt、endAt 自行折算分段内的进度与时长
• 分段视频与整视频共用同一视频文件，播放器需根据 startAt、endAt 限制播放区间
• 弹题不在本响应，走 /task/{taskId}/marker/...，见 marker-task-list.md

响应示例（分段视频）

{
  "url": "https://cdn.example.com/video.mp4",
  "resNo": "abc123def456",
  "token": "token123456",
  "mediaSource": "segment",
  "fileStorage": "cloud",
  "fileConvertStatus": "success",
  "startAt": 0,
  "endAt": 60000,
  "segmentId": 101,
  "playerWatermarkTxt": ["用户名", "2025-01-01"],
  "playerWatermarkColor": "#000000",
  "playerWatermarkAlpha": 80,
  "enablePlaybackRates": true,
  "cloudSdkBaseUri": "https://sdk.example.com",
  "watchTimeReportCycle": 60
}