好多新内容

2026-07-22 05:35:53 +08:00
parent b5d1cdcbc5
commit 15649d02f8
128 changed files with 5956 additions and 673 deletions
@@ -0,0 +1,91 @@
+using UnityEngine;
+
+/// <summary>
+/// 根据屏幕宽高比，对 gameplay 相机做"适当微调"：叠加一点 X 旋转(俯角)与 Z 距离增量。
+/// 目的：不同分辨率下让轨道透视观感更协调(如超宽屏略微拉远/调俯角)，与 contain 式 FOV 适配互补。
+///
+/// 安全性(核心)：**绝不直接写相机 transform**。所有微调通过 effectEventController.SetResolutionCameraAdjust
+/// 施加到"漂移 pivot"(顶层基准节点)，并由该方法同步漂移基准 z——因此与相机漂移、SmoothShake 抖动、
+/// 技能偏移、冲刺特效等所有"写相机位姿"的业务逻辑完全不冲突(它们叠加在 pivot 之下或相机自身)。
+///
+/// 用一个 bool(enableTuning)开关。关闭时把增量清零(恢复设计基准)，行为与未加此脚本一致。
+/// 增量相对"设计基准"计算，不累积；16:9 时增量为 0(与原设计逐像素一致)。
+/// </summary>
+[DisallowMultipleComponent]
+public sealed class CameraResolutionTuner : MonoBehaviour
+{
+    [Tooltip("是否启用按分辨率微调相机(X旋转/Z)。关闭则恢复设计基准。")]
+    public bool enableTuning = true;
+
+    [Tooltip("设计基准宽高比。16:9 = 1.7778。此比例下增量为 0。")]
+    public float designAspect = 16f / 9f;
+
+    [Header("宽屏(aspect > 设计)微调")]
+    [Tooltip("每偏离设计宽高比 1.0，额外叠加的 X 旋转角度(正=更俯视)。建议很小。")]
+    public float widePerAspectRotX = 3f;
+    [Tooltip("每偏离设计宽高比 1.0，额外叠加的 Z 距离(负=相机后退拉远)。")]
+    public float widePerAspectZ = -1.0f;
+    [Tooltip("宽屏微调的绝对上限，避免极端超宽屏过度。")]
+    public float wideMaxRotX = 6f;
+    public float wideMaxZ = -2.0f;
+
+    [Header("窄屏(aspect < 设计)微调")]
+    [Tooltip("每偏离设计宽高比 1.0，额外叠加的 X 旋转角度。")]
+    public float narrowPerAspectRotX = 0f;
+    [Tooltip("每偏离设计宽高比 1.0，额外叠加的 Z 距离。")]
+    public float narrowPerAspectZ = 0f;
+    public float narrowMaxRotX = 4f;
+    public float narrowMaxZ = 2.0f;
+
+    private float _lastAspect = -1f;
+    private bool _lastEnabled;
+
+    private void OnEnable()
+    {
+        _lastAspect = -1f;
+        Apply();
+    }
+
+    private void Update()
+    {
+        float aspect = (float)Screen.width / Mathf.Max(1, Screen.height);
+        if (Mathf.Abs(aspect - _lastAspect) > 0.0001f || enableTuning != _lastEnabled)
+        {
+            Apply();
+        }
+    }
+
+    private void Apply()
+    {
+        var eff = effectEventController.Instance;
+        if (eff == null) return;
+
+        float aspect = (float)Screen.width / Mathf.Max(1, Screen.height);
+        _lastAspect = aspect;
+        _lastEnabled = enableTuning;
+
+        if (!enableTuning)
+        {
+            eff.SetResolutionCameraAdjust(0f, 0f); // 恢复设计基准
+            return;
+        }
+
+        float rotX = 0f;
+        float z = 0f;
+        if (aspect > designAspect)
+        {
+            float dev = aspect - designAspect; // 宽屏偏离量
+            rotX = Mathf.Clamp(widePerAspectRotX * dev, Mathf.Min(0f, wideMaxRotX), Mathf.Max(0f, wideMaxRotX));
+            z = Mathf.Clamp(widePerAspectZ * dev, Mathf.Min(0f, wideMaxZ), Mathf.Max(0f, wideMaxZ));
+        }
+        else if (aspect < designAspect)
+        {
+            float dev = designAspect - aspect; // 窄屏偏离量
+            rotX = Mathf.Clamp(narrowPerAspectRotX * dev, Mathf.Min(0f, narrowMaxRotX), Mathf.Max(0f, narrowMaxRotX));
+            z = Mathf.Clamp(narrowPerAspectZ * dev, Mathf.Min(0f, narrowMaxZ), Mathf.Max(0f, narrowMaxZ));
+        }
+        // 16:9：rotX=z=0，无微调。
+
+        eff.SetResolutionCameraAdjust(rotX, z);
+    }
+}