直播结束后,观看时长和回放视频如何沉淀?

0 阅读8分钟

直播结束后,观看时长和回放视频如何沉淀?

一场直播结束,系统至少要回答两个问题:谁看过、看了多久;这场直播的录像,能不能继续作为课程素材使用。

如果只在直播表里写一个“已结束”,学习进度无法结算;如果只保存厂商返回的回放 URL,地址过期后,平台也就失去了可复用的视频资产。

织码在线教育系统原有方案把问题拆成两条链路:用 LiveBroadcastRecord 记录一次开播,用 LiveUserRecord 记录人和场次之间的观看;回放生成后,再把厂商文件转存到点播平台,创建 Material,最后回写 Live.materialId。

本文按原文所述版本讲解这套结构,代码片段是为说明设计整理的示意,不是当前工作区的完整源码审计。

1. 先分清:一场开播,和一个人的观看不是一张表

一次直播可能有多个观看者,一个用户也可能中途退出后再次进入。把两类数据放在同一张表里,很快就会遇到覆盖、重复和统计口径混乱。

在这里插入图片描述

图 1:LiveBroadcastRecord 记录场次,LiveUserRecord 记录人和场次中的一段观看。

记录表关键字段作用
一次开播live_broadcast_recordliveId、sessionId、channelId、开始/结束时间确定场次生命周期
一段观看live_user_recordbroadcastId、userId、guid、studyDuration记录某个用户的一次观看片段

broadcastId 将观看记录关联到开播记录;guid 由前端带入,可作为同一观看片段的幂等标识;studyDuration 以秒保存。

这种模型允许同一用户在同一场直播产生多条记录。结算时按 userId 累加,而不是取最后一条记录覆盖旧值。这里的“多段累加”是模型提供的能力,实际是否会产生多段记录仍取决于进度上报和业务实现。

2. 观看进度为什么不让前端直接上报时长

原文描述的观看入口由 LiveWatchReq 承载,包含 channelId、用户信息、观看端来源和直播场景。服务端通过 LiveUtil.getLiveWatchUrl(...) 换取观看地址。

进入直播后,客户端调用:

POST /resource/api/live/progress
请求:ApiLiveUserRecordReq(guid、channelId、userId)
响应:ApiLiveUserRecordResp(guid、liveStatus)

请求体没有让客户端直接提交“我看了 180 秒”。按照原文描述,服务端依据观看记录的开始、结束时间,在下播结算阶段计算时长。

在这里插入图片描述

图 2:进度接口负责触发和记录,时长结算集中在场次结束后的服务端任务。

状态回调有两个关键分支:

回调状态处理
LIVING创建 LiveBroadcastRecord,保存 sessionId、channelId 和开始时间
COMPLETION按 sessionId 找回场次,更新结束时间,并异步统计观看时长

异步任务按 liveId 找到全部 LiveUserRecord,对每条记录执行 Duration.between(startTime, endTime).getSeconds(),再按 userId 合并。最终的总时长同时写入课程学习记录和任务学习记录。

需要特别注意:ThreadUtil.execute(...) 只是把工作移出回调线程,并不会自动提供重试、幂等、失败补偿或任务可观测性。生产系统仍应考虑回调重复、异步任务失败和结算结果重算。

3. 完成观看时长如何影响学习进度

Live.liveCompletionDuration 表示直播完成观看时长,单位是秒。原文描述的判定规则是:本次统计得到的观看时长达到标准,进度为 100;未达标为 0;完成标准为 0 时使用 -1 表示不参与统计。

这里有两个容易误读的点:

  1. 判定依据是本次汇总得到的新时长,不应继续使用旧的数据库值作比较。
  2. 0、100、-1 是项目内的进度语义,接口文档需要明确它们的含义,避免前端把 -1 当成异常。

如果进度结算会被重复触发,写入操作还需要具备幂等性。否则同一场回调被重复消费,可能重复累加或重复派发后续学习事件。

4. 回放沉淀:不要长期依赖厂商临时地址

直播结束后,厂商回放通常会先提供一个文件地址或回放地址。原文以百家云 DTO 中的 downloadUrl、httpsDownloadUrl 为例,标注下载地址有 2 小时有效期。

真正的资产化过程由 handleLiveRefashion(...) 完成:

在这里插入图片描述

图 3:先找最近场次,再把厂商文件上传到点播平台,最后回写素材关联。

回放回调(channelId + url)
  → 按 channelId 找最近一场 LiveBroadcastRecord
  → 读取对应 Live
  → VodUtil.uploadVideo(videoConfig, url, sessionId)
  → 创建 Material(VIDEO)
  → Live.materialId = Material.id
  → playbackGenerated = true

素材名使用直播名称和开始时间组合,降低多场直播重名的概率;videoVid 保存点播平台返回的视频标识;materialId 则把直播配置和资源库素材连接起来。

这个顺序有一个实际好处:只有素材创建成功并拿到 ID 后,才回写 playbackGenerated。但在转存过程中仍要考虑超时、重复回调、上传中断、点播转码失败和回写失败。一个布尔字段无法单独表达“上传中”“转码失败”“待重试”等状态,后续若出现运营补偿需求,可能需要更细的状态模型。

5. 三家平台的 DTO 是协议适配边界

原文中的 LivePlatformEnum 只有三项:保利威 POLYV(2)、百家云 BAIJY(3)、获得场景 BOKECC(4)。这里的枚举只有 code / desc / tag,没有短信适配那类 mode 字段,不能套用另一套路由模型。

在这里插入图片描述

图 4:DTO 可以描述厂商协议,但不自动意味着业务已完成日志同步。

典型 DTO 包括:

平台DTO关注点
保利威CallbackLivePlayback回放回调、文件地址、签名、sessionId
保利威ChannelViewLogPageRequest/Response分页观看日志、playDuration、stayDuration、param3
获得场景BokeccCloudRoomReplayInfoResp回放状态、replayUrl、视频 ID、临时下载地址

param3 的 vod / live 取值可以区分回放观看和直播观看。统计出勤时,两者是否合并必须由业务口径明确,不能仅凭字段存在就得出结论。

原文特别指出,在检索范围内没有发现业务将 ChannelViewLogResponse 自动写入 LiveUserRecord 的链路。也就是说,“有厂商观看日志 DTO”与“已经完成厂商日志自动入库”是两件事。

6. 管理端能查记录,不等于已有复杂报表

AdminLiveUserRecordController 和 AdminLiveBroadcastRecordController 分别提供 /page、/save、/view、/edit、/delete 等端点,管理端可以按两张表独立维护记录。

但原文核对到的两个 Mapper XML 只有 namespace 声明,没有自定义 SQL。统计和批量更新依赖 MyBatis-Plus 的通用方法,例如 lambdaQuery()、getBySessionId(...)、getByChannelIdForLast(...) 和 updateBatchById(...)。

在这里插入图片描述

图 5:记录、结算和回放资产已经有落点;复杂报表与自动同步需要单独建设。

因此,文章或产品说明中可以准确地说“已有观看记录和回放资产链路”,但不宜直接声称已有复杂观看报表、厂商日志自动入库、实时统一出勤统计或可靠的断点续传。

7. 这套设计适合什么场景

当目标是把一次直播接入现有课程学习体系时,两张记录表加一个素材关联字段足够清晰:

  • 场次生命周期由 LiveBroadcastRecord 管理;
  • 用户观看由 LiveUserRecord 管理;
  • 下播后把时长汇总到课程和任务学习记录;
  • 回放转存为 Material,进入资源库复用。

如果下一步要做跨厂商观看日志汇总、实时在线人数、观看质量分析或大规模报表,建议先补充统一事件模型、数据同步状态、去重键和聚合存储,再继续堆叠查询接口。否则“记录表”会同时承担事实明细、统计结果和报表查询,后续很难演进。

结语

直播数据的价值不只是保存“看过”。场次记录确定一次开播,用户记录提供可累加的观看片段,异步结算把它转成学习时长,回放转存又把一次性文件变成平台素材。

这套设计的关键,是把场次、观看和回放资产分别落到清晰的边界上;它没有自动解决复杂报表、厂商日志同步和可靠任务执行,这些能力需要在真实需求出现时继续建设。 。场次记录确定一次开播,用户记录提供可累加的观看片段,异步结算把它转成学习时长,回放转存又把一次性文件变成平台素材。

这套设计的关键,是把场次、观看和回放资产分别落到清晰的边界上;它没有自动解决复杂报表、厂商日志同步和可靠任务执行,这些能力需要在真实需求出现时继续建设。