Files
UmaViewer/LIVE_TRACKS.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

180 lines
10 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.
---
name: Live 轨道全览
description: UmaViewer Live 时间轴全部103条轨道的ID、名称、作用、实现状态及已知Bug(2026-05-07核查)
type: reference
originSessionId: 319ae839-0292-4b1e-80de-2f3c91b1f40e
---
# Live 轨道全览(LiveTimelineKeyDataType 枚举,ID 0–102)
数据来源:LiveTimelineDefine.cs 枚举 + WorkSheet CS字段核查 + scan_full.py全量扫描(58首歌,2026-05-07)+ Director/Control代码审查
**实现状态图例**
- ✅ 完整
- ⚠️ 部分实现(有TODO)
- ⚠️🔇 仅数据(无视觉输出)
- 🔴 Bug(声明但从不触发)
- ❌ 未实现
**★** = song 1001 有真实数据(括号内条数)
---
## 摄像机 / 基础轨道
| ID | 名称 | 作用 | 状态 | Bug |
|----|------|------|------|-----|
| 0 | Timescale | 播放倍速 | ✅ Control内部 | — |
| 1 | CameraPos | 主摄像机位置 | ✅ | — |
| 2 | CameraLookAt | 主摄像机朝向 | ✅ | — |
| 3 | CameraFov | 视野角 | ✅ | — |
| 4 | CameraRoll | 摄像机滚转 | ✅ | — |
| 5 | HandShakeCamera | 手持抖动效果 | ❌ | — |
| 6 | Event | 时间轴触发事件 | ❌ | — |
| 7 | CharaMotionSequence ★(5) | 角色动作序列切换 | ✅ | — |
| 8 | BgColor1 ★(13) | 角色色调/轮廓/阴影颜色 | ✅ | — |
| 9 | BgColor2 ★(1) | 背景渐变/环境色(两色混合)【15/58首】 | ✅ | 写含 `_AmbientColor` 属性的舞台材质,颜色 = `Lerp(color1, color2, value)`;color2 恒为白色 |
| 10 | MonitorControl ★(2) | LED舞台屏幕内容控制 | ❌ | — |
| 11 | CameraSwitcher | 切换活动摄像机 | ✅ | — |
| 12 | LipSync | 口型同步 | ✅ | — |
| 13 | PostEffectDOF | 景深模糊(单机) | ❌ | — |
| 14 | PostEffectBloomDiffusion | 泛光扩散(单机) | ❌ | — |
| 15 | RadialBlur | 径向运动模糊(单机) | ❌ | WorkSheet有radialBlurKeys字段,58/58首存在但全部0 keyframe(空占位) |
| 16 | CameraLayer | 摄像机渲染层遮罩 | ❌ | — |
| 17 | Projector ★(4) | 舞台投影仪(gobo图案) | ❌ | — |
---
## 角色表情 / 动作
| ID | 名称 | 作用 | 状态 | Bug |
|----|------|------|------|-----|
| 18 | FacialFace | 面部整体表情 | ✅ AlterUpdate_FacialData | — |
| 19 | FacialMouth | 嘴部表情 | ✅ | — |
| 20 | FacialCheek | 脸颊表情 | ✅ | — |
| 21 | FacialEye | 眼部表情 | ✅ | — |
| 22 | FacialEyebrow | 眉毛 | ✅ | — |
| 23 | FacialEyeTrack | 眼球追踪目标 | ✅ | — |
| 24 | FacialEar | 耳部动画 | ✅ | — |
| 25 | FacialEffect | 表情叠加特效 | ✅ | — |
| 26 | FacialNoise | 表情随机扰动 | ❌ | WorkSheet无facialNoiseKeys字段 |
| 27 | CharaMotionNoise | 动作随机扰动 | ❌ | WorkSheet无charaMotionNoiseKeys字段 |
| 28 | FormationOffset | 角色队形位置偏移 | ✅ | — |
| 29 | Animation ★(1) | GameObject Animation组件序列 | ❌ | — |
| 30 | TextureAnimation | 材质纹理帧动画 | ❌ | — |
---
## 舞台物件
| ID | 名称 | 作用 | 状态 | Bug |
|----|------|------|------|-----|
| 31 | Transform | 舞台物件位移/旋转/缩放 | ✅ StageController | — |
| 32 | Renderer | 舞台Renderer启用/禁用 | ❌ | — |
| 33 | Object ★(10) | 舞台GameObject激活/隐藏 | ✅ StageController | — |
| 34 | Audience ★(12) | 观众人群动画参数 | ❌ | — |
| 35 | Props | 舞台道具激活控制 | ❌ | — |
| 36 | PropsAttach | 角色附着道具 | ❌ | — |
---
## 灯光 / 特效
| ID | 名称 | 作用 | 状态 | Bug |
|----|------|------|------|-----|
| 37 | VolumeLight ★(1) | 体积光/SunShafts | ⚠️🔇 | 无SunShafts组件,仅数据 |
| 38 | HdrBloom | HDR泛光强度/阈值 | ❌ | 全量扫描确认0/58首有数据,不需要实现 |
| 39 | PostFilm | 全屏后期叠加(晕影/颜色/UV电影) | ❌ | WorkSheet有postFilmKeys字段,58/58首存在但全部0 keyframe(空占位) |
| 40 | Fade | 场景淡入淡出 | ❌ | — |
| 41 | Particle ★(3) | 粒子系统发射速率 | ✅ | — |
| 42 | ParticleGroup ★(3) | 粒子组闪烁速率(双速率曲线) | ✅ | — |
| 43 | WashLight | 洗光灯 SetActive+颜色亮度 | ⚠️ | RaycastDistance/CameraProjectionSide/MulColor0未使用 |
| 44 | Laser | 激光灯变换+SetActive | ⚠️ | blinkRate/blinkOffset/rotateFollowCamera/RaycastDistance未实现 |
| 45 | BlinkLight ★(9) | 频闪灯亮灭周期/颜色/亮度 | ⚠️ | color1Array/LightBlendMode/isReverseHueArray未使用 |
| 46 | UVScrollLight ★(1) | 材质UV滚动灯光效果 | ⚠️ | mulColor1/ColorType/CharacterIndex等未使用 |
| 47 | FacialToon | 角色卡通着色参数 | ❌ | — |
| 48 | GlobalLight ★(2) | 全局光方向/RimLight参数 | ✅ | — |
| 49 | GlobalFog ★(1) | 全局雾效(颜色/密度/范围) | ✅ | — |
| 50 | LightShafts ★(1) | 光轴/丁达尔效果 | ⚠️🔇 | 无LightShaftsController组件,仅数据 |
| 51 | MonitorCameraPos ★(1) | 舞台监控摄像机位置 | ❌ | WorkSheet无monitorCameraPosKeys字段 |
| 52 | MonitorCameraLookAt ★(1) | 舞台监控摄像机朝向 | ❌ | WorkSheet无monitorCameraLookAtKeys字段 |
| 53 | MultiCameraPos ★(2) | 多机位摄像机位置 | ✅ | — |
| 54 | MultiCameraLookAt ★(2) | 多机位摄像机朝向 | ✅ | — |
| 55 | EyeCameraPos | 眼部特写摄像机位置 | ❌ | — |
| 56 | EyeCameraLookAt | 眼部特写摄像机朝向 | ❌ | — |
| 57 | LensFlare | 镜头光晕【45/58首】 | ❌ | — |
| 58 | Environment ★(1) | 地板镜面反射/水面波纹/阴影/FovShift【48/58首】 | ❌ | 核心是Planar Reflection(第二摄像机→RenderTexture→地板shader),无现成系统则工程量大;水面UV参数和阴影开关可部分实现 |
| 59 | SweatLocator ★(3) | 角色汗珠特效挂点 | ❌ | WorkSheet无sweatLocatorList字段 |
| 60 | Effect ★(8) | 特效Prefab加载/播放(3d/effect/live/) | ✅ | — |
| 61 | ColorCorrection | 色彩校正(饱和度/RGB曲线) | ⚠️ | depthRedCurve/Green/Blue/blendCurve/mode/selective/keyColor/targetColor无URP对应 |
| 62 | PreColorCorrection | 前置色彩校正 | ❌ | — |
| 63 | TiltShift | 移轴模糊 | ❌ | WorkSheet有tiltShiftKeys字段,58/58首存在但全部0 keyframe(空占位) |
| 64 | A2U | 内部动作系统参数 | ❌ | 非视觉轨道 |
| 65 | A2UConfig | A2U配置 | ❌ | 非视觉轨道 |
| 66 | FlashPlayer | 全屏闪光播放 | ❌ | WorkSheet有flashPlayerKeys字段,58/58首存在但全部0 keyframe(空占位) |
| 67 | Title | 歌曲名字幕显示 | ❌ | — |
| 68 | Spotlight3d ★(3) | 3D聚光灯 SetActive+颜色/强度 | ✅ | — |
| 69 | CharaNode | 角色骨骼节点位置控制 | ❌ | — |
| 70 | NodeScale ★(2) | 舞台节点缩放 | ❌ | WorkSheet无nodeScaleList字段 |
| 71 | Fluctuation | 画面波动/震颤效果 | ❌ | — |
| 72 | CharaFootLight | 角色脚部补光灯 | ❌ | WorkSheet有charaFootLightKeys字段,58/58首存在但全部0 keyframe(空占位) |
| 73 | ChromaticAberration ★(1) | 色差后处理 | ⚠️ | redOffset/greenOffset/blueOffset(通道偏移)无URP内置对应;effectType未使用 |
| 74 | LightProjection ★(18!) | 投影灯(Gobo图案灯)【36/58首】 | ❌ | WorkSheet有lightProjectionList字段;song 1001有18条,高优先级 |
| 75 | Billboard | 广告牌(始终面向摄像机的面片)【12/58首】 | ❌ | — |
---
## 多机位后处理
| ID | 名称 | 作用 | 状态 | Bug |
|----|------|------|------|-----|
| 76 | MultiCameraPostFilm ★(2) | 多机位全屏后期叠加【50/58首】 | ❌ | WorkSheet有postFilm1MultiCameraKeys字段 |
| 77 | MultiCameraPostEffectBloomDiffusion ★(2) | 多机位泛光 | ❌ | WorkSheet无对应字段 |
| 78 | MultiCameraColorCorrection | 多机位色彩校正 | ❌ | — |
| 79 | MultiCameraTiltShift | 多机位移轴模糊 | ❌ | — |
| 80 | MultiCameraRadialBlur | 多机位径向模糊 | ❌ | — |
| 81 | MultiCameraPostEffectDOF | 多机位景深 | ❌ | — |
---
## 附加灯光 / 系统
| ID | 名称 | 作用 | 状态 | Bug |
|----|------|------|------|-----|
| 82 | AdditionalLight | 附加动态光源【22/58首】 | ❌ | — |
| 83 | MultiLightShadow | 多光源阴影 | ❌ | WorkSheet有MultiLightShadowKeys字段,58/58首存在但全部0 keyframe(空占位) |
| 84 | MobControl ★(4) | 观众人群行为/动画控制 | ❌ | WorkSheet无MobControlKeys字段 |
| 85 | CyalumeControl ★(4) | 荧光棒颜色/同步控制 | ❌ | WorkSheet无CyalumeControlKeys;CyalumeController3D.cs存在但未接入时间轴 |
| 86 | CameraMotion | 摄像机动作曲线轨道 | ❌ | — |
| 87 | WaveObject | 波浪变形物体 | ❌ | — |
| 88 | CharaWind | 角色风效(头发/裙摆) | ❌ | — |
| 89 | CharaParts | 角色部件显隐控制 | ❌ | — |
| 90 | CameraCutNo | 镜头编号标记(元数据) | ❌ | — |
| 91 | ToneCurve | 色调曲线(ACES/自定义) | ❌ | — |
| 92 | Exposure | 曝光值控制 | ❌ | — |
| 93 | Vortex | 旋涡/扭曲屏幕效果 | ❌ | — |
| 94 | CharaCollision | 角色碰撞辅助(非视觉) | ❌ | — |
| 95 | TransmittedLight | 透射光(次表面散射) | ❌ | — |
| 96 | TransmittedLightMask | 透射光遮罩 | ❌ | — |
| 97 | Voice | 语音切换控制 | ❌ | — |
| 98 | LipSyncPatternRange | 口型模式范围定义 | ❌ | WorkSheet无字段 |
| 99 | LipSyncPattern | 口型模式数据 | ❌ | WorkSheet无字段 |
| 100 | LensDistortion | 镜头桶形/枕形畸变 | ❌ | — |
| 101 | CharaNodeOffset | 角色骨骼节点偏移 | ❌ | — |
| 102 | TransparentCamera | 透明度摄像机控制 | ❌ | — |
---
## 统计摘要
| 状态 | 数量 |
|------|------|
| ✅ 完整 | 21 |
| ⚠️ 部分实现 | 7 |
| ⚠️🔇 仅数据 | 2 |
| 🔴 Bug(已修)| 1 |
| ❌ 未实现 | 72 |
## 未实现轨道优先级排序
LensFlare(57, 45/58首) > LightProjection(74, 36/58首) > AdditionalLight(82, 22/58首) > Billboard(75, 12/58首) > Audience(34, ★12条) > MobControl(84, 4条) > CyalumeControl(85, 4条) > Projector(17, 4条) > MultiCameraPostFilm(76, 50/58首) > NodeScale(70, ★2条) > MonitorControl(10, ★2条) > Animation(29, ★1条) > Environment(58, 48/58首, 需Planar Reflection系统)