流媒体与实时通信 / 系统课时
直播间状态如何映射媒体流状态
直播间状态如何映射媒体流状态
本篇解决“主播没推流、网络短断、主动下播”被错误当成同一种业务状态的问题。你会建立业务状态与媒体状态的单向映射、短断恢复窗口和主动结束条件,让直播间显示与实际媒体生命周期一致。
学习目标
- 区分业务状态与媒体流状态,并定义可执行的映射规则
- 为“未推流、短断、恢复、主动下播”设置明确的状态迁移条件
- 用时间窗口和结束信号避免网络抖动误触发“直播结束”
先拆开两套状态
直播间业务状态描述“用户看到什么”,媒体流状态描述“系统当前能否发布或继续播放媒体”。两者不能直接一对一绑定,否则推流 TCP/QUIC/WebRTC 连接短暂抖动就可能让直播间瞬间变成“已结束”。
建议业务侧至少保留 4 个状态:READY、LIVE、PAUSED、ENDED;媒体侧至少区分 NO_PUBLISH、PUBLISHING、DISCONNECTED、STOPPED。其中 DISCONNECTED 只表示媒体链路暂时断开,不等于主播已经结束直播。
| 业务状态 | 媒体状态 | 典型含义 | 允许自动进入的条件 |
|---|---|---|---|
READY |
NO_PUBLISH |
房间已建立,主播尚未开始推流 | 主播创建房间后默认进入 |
LIVE |
PUBLISHING |
已有有效媒体发布 | 连续收到媒体数据并通过健康检查 |
PAUSED |
DISCONNECTED |
直播暂时中断,等待恢复 | 连续失联未超过恢复窗口 |
ENDED |
STOPPED |
主播主动结束或系统确认结束 | 收到明确结束信号,或超过失联终止窗口 |
这里最重要的一条是:媒体断开只能直接说明“链路断了”,不能直接推出“业务结束了”。
用时间窗口处理短断
假设主播正常推流后,服务端每 1 秒统计一次最近媒体活动时间。生产环境可以把 5 秒作为告警级短断阈值,把 30 秒作为默认自动结束候选窗口,具体值再根据编码器重连时间和用户体验调优。
当最后一帧时间为 10:00:00 时,10:00:01~10:00:04 可以继续保持 LIVE;达到 5 秒无媒体时,将业务状态切到 PAUSED,但播放器不要立即清空直播上下文。若主播在 10:00:12 恢复推流,则恢复为 LIVE,不应新建一个直播间业务实例。
只有同时满足“没有主动结束信号”和“持续断流超过终止窗口”,才进入 ENDED。例如终止窗口设为 30 秒,则最后媒体时间 10:00:00、10:00:30 仍属于边界检查点,超过 10:00:30 且没有恢复,才执行结束动作。

主动下播和异常断流要分开
主动下播应由业务事件驱动,而不是猜测媒体状态。主播点击“结束直播”后,先写入 END_REQUESTED 业务事件,再停止接受新的发布数据;媒体服务确认发布已经停止后,再把直播间设置为 ENDED。这样可以避免“按钮点击成功但媒体连接还没完全释放”造成短暂状态倒退。
网络短断则走另一条路径:媒体服务发出断开事件后,先记录 lastMediaAt 和 disconnectReason,业务层进入 PAUSED,等待恢复。不要在收到第一条 disconnect 事件时直接执行清理房间、删除推流密钥、关闭评论等结束操作。
常见错误做法是把 onDisconnect => room=ENDED 写成固定规则。正确做法应至少判断三个条件:是否收到主动结束事件、是否在恢复窗口内重新收到媒体、是否已经超过自动终止窗口。三个条件缺一不可时,短断和下播才不会串线。
用事件顺序保证状态不倒退
状态机还需要防止旧事件覆盖新状态。例如主播已经主动下播,业务状态为 ENDED,几百毫秒后才到达一条延迟的 PUBLISHING 事件,此时不能把房间重新改成 LIVE。
落地时可以给每个直播间维护一个单调递增的 sessionVersion 或媒体会话 ID。状态更新只接受当前会话产生的事件;旧会话事件直接丢弃。事件处理顺序建议是:主动结束事件优先于媒体恢复事件,明确的新会话优先于旧会话。
验收时可以直接模拟下面 4 组时间线:
READY → PUBLISHING:业务状态必须进入LIVE。LIVE → DISCONNECTED 3秒 → PUBLISHING:业务状态应保持LIVE或短暂内部记为恢复中,但不能进入ENDED。LIVE → DISCONNECTED 8秒 → PUBLISHING:业务状态应为PAUSED → LIVE,播放器继续使用原直播上下文。LIVE → END_REQUESTED → STOPPED:业务状态最终必须是ENDED;之后到达旧PUBLISHING事件也不能重新变成LIVE。
最终可以把判断规则压缩成一句工程约束:媒体状态负责报告事实,业务状态负责解释事实;短断看恢复窗口,结束看明确事件或超时,旧会话事件永远不能覆盖新状态。