Appearance
设计决策(ADR)
Sentinel 的关键边界都以 ADR(Architecture Decision Record) 形式固化。下面 5 条是 v1.0 消费方最该理解的决策——它们解释了 SDK 为什么这样设计、哪些能力刻意不做。
这里展示的是原始决策记录(权威源
docs/adr/,构建时@include,零漂移)。想看叙事版"为什么",从概念页进。
| ADR | 决策 | 对消费方的影响 |
|---|---|---|
| ADR-021 | SDK 不做团队 UI | 业务 UI(品牌、菜单、覆盖层)在业务项目内部封装,不在 SDK |
| ADR-022 | 认证仅用签名 URL | 移除 headers / getHeaders,鉴权靠签名 URL |
| ADR-023 | iframe URL 默认 + 可覆盖 | origin prop 支持私有化部署,不 hardcode CDN 域名 |
| ADR-024 | LL-HLS 显式开启 | 低延迟直播需显式 source.hls.lowLatencyMode,非默认 |
| ADR-025 | 不开 xgplayer 逃生舱 | 无通用透传;清晰度菜单/覆盖层归团队层(为什么) |
其余 ADR(026 健康监测 / 027 字幕 / 028 弹幕 / 029 移动手势 / 030–031 工具链)见仓库 docs/adr/。