这是什么

Sentinel Video Player 是一套 Web 视频播放器 SDK。

内核是 xgplayer 3.0.26(精确锁版本,播放能力一行没改)。 我们做的是内核之外的事:归档了 35 个真实生产环境的坑,其中 27 个已处理 (19 个做成插件、1 个在 create-player、7 个靠决策规避), 剩下 8 个只登记未实现——如实列在这里, 再套一层四端一致的契约。

三条设计原则

• 只做技术,不做业务 UI —— 播放能力、事件、命令、契约、容错。 品牌 UI 由业务方用自己的 UI 库封装(ADR-021)。
• 契约优先 —— 所有命令 / 事件 / 错误码在 protocol 里 Zod 注册,严格 semver。
• 五种接入行为一致 —— cross-mode-parity 是硬红线,同一份参数在五种模式里表现相同。

接下来读什么

你想知道	去这里
为什么不直接用 xgplayer?什么时候不该用你?	为什么用 Sentinel
五种接入方式我该选哪个?各自有什么缺点?	五种接入怎么选
后端该给我几种视频源?	怎么选视频源
视频要鉴权,token 过期了怎么办?	鉴权与签名过期
取消静音、进场倒计时、推荐列表这些 UI 怎么做?	在播放器上做 UI
先跑起来看看	30 秒跑起来

为什么 SDK 不给"逃生舱"直接透传 xgplayer 配置?见 为何没有逃生舱。