ADR-023: 回放媒体通过 MediaClockAdapter 映射到事实时间轴

[ceilf6]

决策

录制包内 timestampMs 是唯一事实时间轴。媒体元素不直接作为全局状态源，必须通过 MediaClockAdapter 在 timeline time 和 media currentTime 之间映射；有媒体且 ready 时，播放推进优先参考媒体时间。

备选方案

• 完全用 performance.now() 推进事件，不考虑媒体漂移。
• 直接让播放器控制条读写裸 media.currentTime。
• 使用 MediaClockAdapter 映射媒体和事件时间轴。

理由

最新方案要求音视频听感优先，同时防止媒体 currentTime 和事件时间线分裂。MediaClockAdapter 支持单 WebM segment，也能为 P1 分段媒体扩展保留空间。

影响

正常播放时 drift 绝对值应小于 250ms，超过阈值通过 adapter seek 纠偏。媒体 stalled/buffering 超过 500ms 时暂停事件推进，超过 2s 可让用户选择继续纯事件流回放。