好多新内容

2026-07-22 05:35:53 +08:00
parent b5d1cdcbc5
commit 15649d02f8
128 changed files with 5956 additions and 673 deletions
@@ -0,0 +1,50 @@
+using UnityEngine;
+using UnityEngine.UI;
+
+/// <summary>
+/// 让 CanvasScaler 的 matchWidthOrHeight 随屏幕宽高比动态切换，实现“设计区域永不裁切”(contain)：
+///   - 屏幕比设计更宽(>16:9)：锁高度(match=1)，左右由背景 cover 填满，UI 不被竖向裁。
+///   - 屏幕比设计更窄(<16:9，如 16:10 / 4:3)：锁宽度(match=0)，上下由背景 cover 填满，UI 不被横向裁。
+/// 这样 1920x1080 设计范围内的所有 UI 在任意宽高比下都完整可见，仅“更宽松”的一侧留出由背景填充的余量。
+///
+/// 满足三要求：
+///  1) 不改业务逻辑、不改对象引用；只调 CanvasScaler 的一个表现参数。
+///  2) 16:9 屏下 match=1 与原状态一致，逐像素不变；只改缩放基准，不动任何锚点/位置/动画。
+///  3) 窄屏不再裁切、宽屏铺满，配合背景 cover 始终填满屏幕。
+/// </summary>
+[RequireComponent(typeof(CanvasScaler))]
+[DisallowMultipleComponent]
+public sealed class UICanvasMatchFitter : MonoBehaviour
+{
+    private const float DesignAspect = 1920f / 1080f;
+
+    private CanvasScaler scaler;
+    private float lastAspect = -1f;
+
+    private void OnEnable()
+    {
+        scaler = GetComponent<CanvasScaler>();
+        Apply();
+    }
+
+    private void Update()
+    {
+        // 分辨率/窗口变化时才重算。
+        float aspect = (float)Screen.width / Mathf.Max(1, Screen.height);
+        if (Mathf.Abs(aspect - lastAspect) > 0.0001f) Apply();
+    }
+
+    private void Apply()
+    {
+        if (scaler == null) scaler = GetComponent<CanvasScaler>();
+        if (scaler == null) return;
+        if (scaler.uiScaleMode != CanvasScaler.ScaleMode.ScaleWithScreenSize) return;
+
+        float aspect = (float)Screen.width / Mathf.Max(1, Screen.height);
+        lastAspect = aspect;
+
+        scaler.screenMatchMode = CanvasScaler.ScreenMatchMode.MatchWidthOrHeight;
+        // 更宽→锁高度(1)；更窄→锁宽度(0)。等于始终匹配“更受限的一侧”，设计区域完整可见。
+        scaler.matchWidthOrHeight = aspect >= DesignAspect ? 1f : 0f;
+    }
+}