Files
UmaViewer/LIVE_DEV_MAP.md
T
ritenseki 7fc1511fd4 Fix StageController light filter: use explicit patterns instead of Contains("light")
Replace broad Contains("light") with IsTimelineControlledLight() that matches
only objects actually controlled by timeline handlers (blinklight, spotlight3d,
_wash_, laser). Neonsigns, glow meshes, UV scroll objects and other static stage
props now keep their prefab default state instead of being silently disabled.

Also fix UVScrollLight handler to use GetComponentsInChildren<Renderer>(true)
so inactive renderers are included in material search.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-07 20:19:45 +08:00

133 lines
5.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Live Timeline 开发地图
## 系统架构
```
Asset Bundles(游戏加密包)
└── LiveTimelineWorkSheet(ScriptableObject,103 条轨道的关键帧数据)
└── LiveTimelineControl(每帧按帧号插值,触发事件)
└── Director(订阅事件,调用 Unity API)
├── GameObject / Transform → SetActive, position/rotation/scale
├── Camera → fieldOfView, transform
├── Light → color, intensity
├── MaterialPropertyBlock → toon shader 属性(已移植到 URP)
├── ParticleSystem → emission rate
├── RenderSettings → fog, ambient
└── URP Volume / Feature → 后处理效果
```
游戏原版 Built-in 管线;UmaViewer 用 **URP 14(Unity 2022.3.62f1)**。
Toon shader 已移植,卡住的主要是全屏后处理和几个逆向未完成的轨道。
---
## 轨道 → Unity API 对照
### GameObject / Transform
| 轨道 | 状态 | 操作 |
|------|------|------|
| Object (33) | ✅ | `SetActive` |
| Transform (31) | ✅ | position / rotation / scale |
| WashLight (43) | ⚠️ | `SetActive`(颜色/投影未做) |
| Laser (44) | ⚠️ | `SetActive` + transform(blink 未做) |
| BlinkLight (45) | ⚠️ | `SetActive` + 子 `Light`(color1Array/BlendMode 未做) |
| Spotlight3d (68) | ✅ | `SetActive` + `Light.color/intensity` |
| Effect (60) | ✅ | `Instantiate` prefab |
### Camera
| 轨道 | 状态 |
|------|------|
| CameraPos (1) / LookAt (2) / Fov (3) / Roll (4) | ✅ |
| CameraSwitcher (11) | ✅ |
| MultiCameraPos (53) / LookAt (54) | ✅ |
### MaterialPropertyBlock → Shader
| 轨道 | 状态 | 属性 |
|------|------|------|
| BgColor1 (8) | ⚠️ | `_CharaColor/_ToonDarkColor/_ToonBrightColor/_OutlineColor/_Saturation`(vertexColorToonPower 等未传) |
| GlobalLight (48) | ✅ | 角色 rim light 属性 |
| UVScrollLight (46) | ⚠️ | `_MainTex` offset 累积(已修 bug,mulColor 等未用) |
### ParticleSystem
| 轨道 | 状态 |
|------|------|
| Particle (41) | ✅ `emission.rateOverTime` |
| ParticleGroup (42) | ✅ `FlickerLightRate` MinMaxCurve |
### RenderSettings
| 轨道 | 状态 |
|------|------|
| GlobalFog (49) | ✅ fogColor / fogMode / fogDensity / fogStart / fogEnd |
| BgColor2 (9) | ✅ 写含 `_AmbientColor` 属性的舞台材质,`Lerp(color1, white, value)` |
### URP Volume / RendererFeature
| 轨道 | 状态 |
|------|------|
| ChromaticAberration (73) | ⚠️ intensity 完成,通道偏移无 URP 对应 |
| ColorCorrection (61) | ⚠️ saturation 完成,depth/blend curve 无 URP 对应 |
| HdrBloom (38) | ❌ 0/58 首无数据,无需实现 |
| PostFilm (39) / RadialBlur (15) / TiltShift (63) / SunShafts (37) | ❌ 见后处理 TODO |
### 内部系统
| 轨道 | 状态 |
|------|------|
| CharaMotionSequence (7) / LipSync (12) / FormationOffset (28) | ✅ |
| FacialFace/Eye/Mouth 等 (18–25) | ✅ |
---
## 卡点分类
### 缺零件(知道要做什么,Unity/URP 没有现成组件)
| 轨道 | 缺什么 |
|------|-------|
| PostFilm (39) / RadialBlur (15) / TiltShift (63) / SunShafts (37) | URP 无对应,需自写 ScriptableRendererFeature + shader → 见 `live-shader-todo.md` |
| LightProjection (74) | `Projector` 组件在 URP 不工作,需 DecalProjector 或自定义(36/58 首)|
| Environment (58) | Planar Reflection 系统完全没有(第二摄像机→RenderTexture→地板 shader)(48/58 首)|
| LensFlare (57) | 舞台用 `CustomLensFlare` 脚本,UmaBuild 无源码;可先做 SetActive(45/58 首)|
### 没 dump 找明白(不知道打哪里)
| 轨道 | 不明白什么 |
|------|-----------|
| MonitorControl (10) | `dispID` 0–15 不对应 monitor 材质索引,内容资源路径未知;颜色/UV 控制可先做(★★/58 首)|
| AdditionalLight (82) | 字段未 dump,结构未知(22/58 首)|
### 可以直接做
| 轨道 | 工作 | 难度 |
|------|------|------|
| BgColor1 (8) 缺字段 | 补 `vertexColorToonPower`/`outlineWidthPower`/`IsSilhouette`/`LightBlendMode` | ★☆☆ |
| BlinkLight (45) 缺字段 | `color1Array` 多色循环、`LightBlendMode` | ★★☆ |
| Billboard (75) | 始终朝摄像机面片,Unity 有内置 LookAt 逻辑(12/58 首)| ★☆☆ |
| AdditionalLight (82) | 先 dump 字段再实现(22/58 首)| 待评估 |
---
## 未实现轨道优先级(综合覆盖率 + 难度)
1. **AdditionalLight (82)** — 22/58 首,先 dump 评估
2. **Billboard (75)** — 12/58 首,简单
3. **BgColor1 缺字段** — 58/58 首都有,补全影响所有歌
4. **LensFlare SetActive (57)** — 45/58 首,先做 enableFlare 这一层
5. **后处理系列** — 见 `live-shader-todo.md`
6. **MonitorControl 框架 (10)** — 颜色/UV 先做,dispID 留 TODO
7. **LightProjection (74)** — 工程量大
8. **Environment (58)** — 最复杂,Planar Reflection 从零搭
---
## 关键文件
| 文件 | 说明 |
|------|------|
| `Assets/Scripts/umamusume/Gallop/Live/Director.cs` | 事件订阅 + 所有 handler |
| `Assets/Scripts/umamusume/Gallop/Live/Cutt/LiveTimelineControl.cs` | 每帧插值 + 事件触发 |
| `Assets/Scripts/umamusume/Gallop/Live/Cutt/LiveTimelineWorkSheet.cs` | 所有轨道字段声明 |
| `Assets/Scripts/umamusume/Gallop/Live/Cutt/LiveTimelineDataList/` | 各轨道数据类 |
| `Assets/Scripts/umamusume/Gallop/Live/StageController.cs` | StageObjectMap(按名字查舞台对象);`IsTimelineControlledLight()` 决定哪些对象默认 inactive(`blinklight`/`spotlight3d`/`_wash_`/`laser`)|
| `Assets/Resources/RenderPipeline/UMAUniversalRenderPipelineAsset_Renderer.asset` | RendererFeature 注册位置 |
| `LIVE_TRACKS.md` | 103 条轨道全览(ID/覆盖率/状态/Bug)|
| `live-shader-todo.md` | 后处理轨道实现细节 |