51 lines
2.1 KiB
C#
51 lines
2.1 KiB
C#
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;
|
|
}
|
|
}
|