智萃分段视频预览

GET /api/admin/course/essence/{courseId}/preview_segment_video
权限 ADMIN_COURSE_MANAGE

按分段 ID 返回播放所需字段及分段在视频中的起止时间（startAt、endAt，毫秒），供智萃预览页直接播放分段视频。

路径参数

参数	类型	必填	说明
courseId	number	是	课程 ID

查询参数

参数	类型	必填	说明
segmentId	number	是	分段 ID

响应

字段	类型	说明
type	string	文件类型，如 video
url	string/null	播放 URL（云存储为 null，需通过 SDK 生成）
token	string	访问 token
resNo	string	资源编号
cloudPlayServer	string	云播放服务器地址
cloudSdkBaseUri	string	云 SDK 基础地址
fileStorage	string	文件存储类型：cloud / local
fileConvertStatus	string	文件转换状态：success / waiting / doing / none / error
startAt	number	分段起始时间（毫秒）
endAt	number	分段结束时间（毫秒）
mediaLength	number	媒体时长（秒）
subtitles	SubtitleItem[]	字幕列表，字幕条目的时间在分段 [startAt, endAt] 范围内

SubtitleItem

字段	类型	说明
startAt	number	字幕起始时间（毫秒）
endAt	number	字幕结束时间（毫秒）
content	string	字幕内容

异常

错误码	HTTP	说明	触发条件
COURSE_NOT_FOUND	404	课程不存在	课程 ID 无效或课程已删除
COURSE_NOT_ESSENCE	403	当前课程不是智萃课程	课程未绑定智萃视频
ESSENCE_NOT_PROCESSED	400	智萃尚未完成，无法预览	智萃视频仍在处理中或处理失败
ESSENCE_SEGMENT_NOT_FOUND	404	分段不存在或不属于该课程	segmentId 无效或不属于该课程的 essence 版本
FILE_NOT_FOUND	404	文件不存在	智萃关联的视频文件已被删除