API 参考 / 只读视图、场景、音频与文本
游玩只读视图（context 包）
这组类型都是宿主在某个投递点构造的只读快照：模组只读不写，也不需要注册。你通常在需要它们的时候，已经通过事件参数、滤镜帧或 GameplayHud 回调拿到了实例。
| 类型 | 用来做什么 |
|---|---|
| GameplayContext | 游玩状态的入口总快照：时间、连击、分数、进度、轨道、待判音符 |
| NoteView | 单个音符：时间、轨道、类型、扩展数据 |
| LaneView | 单条轨道的几何与状态（真轨 / 假轨同一口径） |
| ChartView | 谱面元数据与 extensions 扩展段解析结果 |
| HudValues | 一帧 HUD 数值：连击 / 分数 / 准度 / 进度 / 判定计数 |
| HudContext | 覆盖渲染上下文：当前层与 z 序 |
| ActiveHitEffect | 存活打击特效的运行时句柄：改时长 / 轨道 / 提前取消 |
| BeatGrid | 节拍纯函数：给定音乐时间 τ 求拍序号与相位 |
| ResultSnapshot | 本局结算成绩快照 |
| ResultLayout | 结算页各行的布局坐标，覆盖渲染用 |
第一次用建议从 GameplayContext 读起，其余大多是它的字段展开。想动手做界面，直接看 自定义 HUD。