diff --git a/Assets/Scripts/umamusume/Gallop/Live/BillboardController.cs b/Assets/Scripts/umamusume/Gallop/Live/BillboardController.cs
index c01eb87..1e08bf7 100644
--- a/Assets/Scripts/umamusume/Gallop/Live/BillboardController.cs
+++ b/Assets/Scripts/umamusume/Gallop/Live/BillboardController.cs
@@ -19,24 +19,51 @@ namespace Gallop.Live
/// 和 2(58 个,全是 glow_ramp)两种。
///
/// ⚠ `_rotationType` 的枚举语义仍未知。0 是枚举零值、类名又是 BillboardController,
- /// 按「整体朝向摄像机」处理是合理的;**2 代表什么没有依据,故不处理**,
- /// 只打一次日志。等拿到证据再补,不猜。
+ /// 按「整体朝向摄像机」处理**看起来**合理;**2 代表什么没有依据,故不处理**,只打一次日志。
+ ///
+ /// ── 2026-08-07:朝向行为默认关闭( = false)──
+ ///
+ /// 实机观察到「灯一直转来转去,而那东西看起来不该转」。查下来有两层问题:
+ ///
+ /// 1. **确定的 bug(已修)**:`_cachedTarget` 只解析一次就再不更新,而
+ /// `Director.MainCameraTransform` 是**每帧重新赋值**的(`UpdateMainCamera()` 里
+ /// `_cameraTransforms[_activeCameraIndex]`),并且会随 CameraSwitcher 轨道在 3 个
+ /// 摄像机之间切换。于是切换之后,面片朝的是一个**观众看不到的摄像机**——而那个
+ /// 摄像机仍在按自己的时间轴运动,看上去就是「无缘无故一直转」。改为每帧解析。
+ ///
+ /// 2. **没有依据的部分(因此关掉)**:`_rotationType == 0` 到底是不是「整轴朝向摄像机」,
+ /// 以及朝向该用摄像机的 up(跟着镜头 roll,屏幕对齐)还是世界 up(只绕 Y),
+ /// 两者画面完全不同,而**没有任何 ground truth 能判**。按项目规矩「缺依据即不实现」,
+ /// 默认关闭;关掉时面片保持 prefab 作者摆好的朝向,那至少是真实数据而不是我的猜测。
+ ///
+ /// 目标物件本身是查过的,不是猜的:106 个 type-0 实例名字全部是
+ /// `*_billbord` / `*_billboard` / `glow_plane` / `spotlight`,且 106/106 都带 MeshRenderer,
+ /// 灯体在父链上(`swing_ < arm_ < stand_`)。所以「这些该 billboard 化」大概率成立,
+ /// 不成立的是「怎么转」。
///
public class BillboardController : MonoBehaviour
{
+ ///
+ /// 朝向行为总开关。缺 ground truth,默认 false —— 见类注释。
+ /// 要对着参考视频标定时把它打开(和 PostFilmRendererFeature._enableRendering 同一个道理)。
+ ///
+ public static bool EnableRotation = false;
+
// ↓ 这三个名字来自 bundle TypeTree,改名就收不到数据
[SerializeField] private Transform _targetCameraTransform;
[SerializeField] private int _rotationType;
[SerializeField] private bool _isInversedForward;
- private Transform _cachedTarget;
private static bool _loggedUnknownType;
+ ///
+ /// **每帧都要重新解析,不能缓存** —— 生效的直播摄像机会随 CameraSwitcher 换人。
+ ///
private Transform ResolveTarget()
{
if (_targetCameraTransform != null) return _targetCameraTransform;
- // 舞台数据里这个字段全是空的,回落到当前生效的直播摄像机。
+ // 舞台数据里这个字段 164/164 全是空的,回落到当前生效的直播摄像机。
if (Director.instance != null && Director.instance.MainCameraTransform != null)
return Director.instance.MainCameraTransform;
@@ -46,6 +73,8 @@ namespace Gallop.Live
private void LateUpdate()
{
+ if (!EnableRotation) return;
+
// 放 LateUpdate:必须在 Director 当帧摆好摄像机之后再朝向它,否则永远差一帧。
if (_rotationType != 0)
{
@@ -58,14 +87,15 @@ namespace Gallop.Live
return;
}
- if (_cachedTarget == null) _cachedTarget = ResolveTarget();
- if (_cachedTarget == null) return;
+ Transform target = ResolveTarget();
+ if (target == null) return;
- Vector3 forward = transform.position - _cachedTarget.position;
+ Vector3 forward = transform.position - target.position;
if (_isInversedForward) forward = -forward;
if (forward.sqrMagnitude < 1e-8f) return;
- transform.rotation = Quaternion.LookRotation(forward.normalized, _cachedTarget.up);
+ // TODO: up 用 target.up(屏幕对齐、跟着镜头 roll)还是 Vector3.up(只绕 Y)无依据。
+ transform.rotation = Quaternion.LookRotation(forward.normalized, target.up);
}
}
}
diff --git a/CLAUDE.md b/CLAUDE.md
index 1952224..9d90e69 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -191,8 +191,13 @@ MonoBehaviour 实例脚本为空。**但这些脚本是可以「接管」的**
必须挂 `beginCameraRendering` 拿 `ScriptableRenderContext` 后 `RenderSingleCamera`)。
这同时解决了长期的「地板发白」——`_ReflectionTex` 未绑定时 Unity 代入白贴图,
而 `_ReflectionRate` 默认 1.0,等于满强度白反射。
-- `BillboardController` —— 字段读到了,但 `_rotationType` 是枚举,语义随 IL2CPP 元数据一起
- 拿不到,所以只有数据、没有行为。这是「重建签名」的能力边界。
+- `BillboardController` —— 字段读到了,**但行为写了一版又关掉了**,这是「重建签名」的能力边界。
+ `_rotationType == 0` 是不是「整轴朝向摄像机」、朝向该用摄像机 up(跟镜头 roll)还是世界 up
+ (只绕 Y),都没有 ground truth;实机看是「一直转来转去,而那东西不该转」,
+ 于是 `BillboardController.EnableRotation` 默认 false,面片保持 prefab 作者摆好的朝向。
+ 同一次排查里揪出一个**确定的** bug(已修):目标摄像机只解析了一次就缓存,
+ 而生效摄像机随 CameraSwitcher 每帧变 —— 切换后面片朝的是观众看不见的那台,
+ 那台还在自己动,看上去就是无缘无故乱转。**凡是引用「当前摄像机」的舞台脚本都要注意这条。**
**舞台自带 Animation 的播放**(`StageAnimationPlayer`,顶替缺失的 `AnimationObjectController`):
283 个 `Animation` 组件全部 `playAutomatically = true` 但默认 clip 为空,Unity 因此什么都不播。
@@ -223,9 +228,14 @@ MonoBehaviour 实例脚本为空。**但这些脚本是可以「接管」的**
(注意这条不要滥用:镜面球转速一度被记成此类,实测其实完全确定,见下。)
- 未随包发布的 shader(PostFilm 的定义性 shader 就在 app 二进制里)。
-**已被实测消解的「未知」(2026-08-07)**
+**「灯球转速」到底确定到什么程度(2026-08-07,当天两次修正)**
-「灯球转速」曾被列为拿不到的常量。实测结论是它根本不存在这个未知:
+⚠️ **先说结论的边界**:clip 里的转速是硬数据,**但「原版按 1.0 倍速播这条 clip」不是**。
+实机跑下来观察是「所有迪斯科灯球还是太快」,也就是说原版多半有个播放倍率或者压根不用
+这条 clip 驱动球体 —— 那正是本节上面「速度/系数一类的常量」说的那类不可知量。
+下面的数字只证明「**我们忠实地播了这条 clip**」,不证明「和原版一致」。
+
+已确定的部分:
- live10149 的 4 个 `MirrorBallProjector` 实例**全部** `MirrorBallIsLoopRotation = 0`、
`MirrorBallLoopRotationSpeed = 0`、`MirrorBallLoopRotationValue = 0` ——
@@ -234,10 +244,17 @@ MonoBehaviour 实例脚本为空。**但这些脚本是可以「接管」的**
6 条 quaternion 曲线(`mirrorball_a_000` + `b_000..004`),7 个关键帧,
**恒定 −179.50°/s 绕 Y**(每个关键帧算出来都是这个数),2.0 s 一圈,wrapMode = Loop。
末帧 −359° 而不是 −360°,是为了循环接缝不重复一帧。
-- 这条 clip 正好是 `StageAnimationPlayer` 已接管的单-clip 唯一解之一,
- 所以**我们的构建里灯球转速本来就是对的**,不需要任何猜测常数。
+- 这条 clip 正好是 `StageAnimationPlayer` 已接管的单-clip 唯一解之一,采样用的
+ `currentLiveTime` 单位是秒(帧号 = ×60),所以**没有单位换算错误**,
+ 我们放出来就是 clip 写的 2.0 s 一圈。
-教训:把「值是 0」当成「值未知」是两回事。dump 之前先看一眼开关字段。
+两条教训,方向相反,都要记:
+
+1. 把「值是 0」当成「值未知」是两回事 —— dump 之前先看一眼开关字段
+ (`MirrorBallIsLoopRotation` 就是那个开关)。
+2. **但「clip 的转速是确定的」推不出「转速问题解决了」**。我上一版文档写成了
+ 「我们的构建里转速本来就是对的」,实机观察当天就否掉了它。
+ 数据确定的是**素材**,不是**原版怎么用这个素材**;中间那个倍率仍然是不可知量。
### ⚠ 现象描述不是 ground truth
diff --git a/LIVE_DEV_MAP.md b/LIVE_DEV_MAP.md
index f07be62..243bfa2 100644
--- a/LIVE_DEV_MAP.md
+++ b/LIVE_DEV_MAP.md
@@ -99,17 +99,20 @@ Toon shader 已移植,卡住的主要是全屏后处理和几个逆向未完
| 脚本 | 状态 |
|------|------|
| `Gallop.MirrorReflection` | ✅ 已建并实现。第二摄像机 + 反射矩阵 + 斜投影 → RT → `_ReflectionTex`。**顺带解决了长期的「舞台地板发白」** —— `mirror_a` 的 `_ReflectionTex` 从没被赋值,Unity 代入白贴图 × 默认 `_ReflectionRate = 1.0` |
-| `Gallop.Live.BillboardController` | ⚠️ 已建,字段可读(`[StageScripts]` 丢失数 892→728),但 `_rotationType` 枚举语义随 IL2CPP 元数据一起拿不到,行为未实现 |
+| `Gallop.Live.BillboardController` | ⚠️ 已建,字段可读(`[StageScripts]` 丢失数 892→728)。朝向行为写过一版,实机是「一直转来转去而那东西不该转」,已默认关闭(`EnableRotation = false`)——`_rotationType` 语义和 up 轴取法都无依据。同批修掉一个确定 bug:目标摄像机被缓存,而生效摄像机随 CameraSwitcher 每帧变 |
| `Gallop.Live.AnimationObjectController` | ⚠️ 未建;其最直接的后果(283 个 `Animation` 一个都不播)已由 `StageAnimationPlayer` 顶上:只接管单 clip 的唯一解情形,按 `currentLiveTime` 采样而不是 `Animation.Play()`,暂停/拖动进度条都跟随 |
| `Gallop.RenderPipeline.CustomLensFlare` (+`LensFlareData`) | ❌ 未建,但**数据齐全、语义不受 IL2CPP 阻塞**——`LensFlareData` 是 Unity legacy Flare 的逐字翻版,URP 侧有 `LensFlareComponentSRP` 对应。199+5 个物件,星芒在原版截图里很显眼。**下一个该做的就是它** |
| `Gallop.RenderPipeline.MirrorBallProjector` | ❌ 字段已 dump,但 4 个 projector 全在原点、共用一个材质、没有任何指向灯球的引用字段——绑定关系只在方法体里。**卡住,不是没做** |
| `Gallop.Live.ShaderParam.ShaderParamController` | ⚠️ 实测是空操作(两个向量都是 (1,1,1,1)),从待办里划掉 |
| 其余 5 个 | ❌ 未建,见 `CLAUDE.md` 清单 |
-> **镜面球转速不再是悬案。** live10149 的 4 个 `MirrorBallProjector` 全部
-> `MirrorBallIsLoopRotation = 0` / `LoopRotationSpeed = 0`,shader 的 loop-rotation 通路是
-> 关的;真正在转的是 clip(恒定 **−179.50°/s 绕 Y**,2.0 s 一圈,7 帧算出来都是这个数),
-> 而这条 clip `StageAnimationPlayer` 已经在按 `currentLiveTime` 播了 —— 转速本来就是对的。
+> **镜面球转速:素材确定,倍率仍未知。** live10149 的 4 个 `MirrorBallProjector` 全部
+> `MirrorBallIsLoopRotation = 0` / `LoopRotationSpeed = 0`,shader 的 loop-rotation 通路是
+> 关的;真正在转的是 clip(恒定 **−179.50°/s 绕 Y**,2.0 s 一圈,7 帧算出来都是这个数),
+> `StageAnimationPlayer` 按 `currentLiveTime`(秒)忠实地播它。
+> **但实机观察是「所有迪斯科灯球还是太快」** —— 所以原版要么有播放倍率,要么根本不用这条
+> clip 驱动球体。数据确定的是素材,不是原版怎么用素材。倍率属于不可知常量,
+> 要定它只能对着参考视频标定。
### 内部系统
| 轨道 | 状态 |