UI 框架设计:以休闲游戏为例
一、UI 框架要解决什么问题
不用框架时,每个界面各自 Instantiate、各自 SetActive,很快会遇到这些问题:
- 弹窗盖在了引导上面,或者被别的界面挡住,层级混乱。
- 同一个界面被重复打开两次。
- 按手机的返回键,不知道该关哪个界面。
- 界面关了,资源没释放,内存越来越大。
- 登录后签到、活动、礼包几个弹窗同时弹出来,叠在一起。
UI 框架就是把这些通用问题统一管理,让写业务界面的人只关心”界面显示什么、点了按钮做什么”。
休闲游戏的特点
和重度游戏相比,休闲游戏的 UI 有几个明显特点,框架设计要针对它们:
| 特点 | 对框架的要求 |
|---|---|
| 弹窗非常多:签到、礼包、活动、评分、广告奖励 | 弹窗要能排队按优先级依次弹出 |
| 红点多:任务、邮件、活动都要提示 | 需要统一的红点系统 |
| 迭代快,频繁上新活动界面 | 新增一个界面的成本要低,最好只写业务代码 |
| 包体和性能敏感,覆盖低端机 | 框架要轻量,注意资源释放和 UGUI 性能 |
| 以竖屏为主,机型多样 | 处理好刘海屏、平板等适配 |
二、主流方案参考
| 方案 | 说明 | 特点 |
|---|---|---|
| 自研 UGUI 框架 | 绝大多数项目的选择:UIManager + 窗口基类 + 层级 | 灵活、轻量,可以完全按项目需要定制 |
| GameFramework(UGF)的 UI 模块 | UIManager 管理 UIGroup(界面组,即层级)和 UIForm(界面) | 生命周期完善:除了打开、关闭,还有被遮挡(OnCover)、重新显示(OnReveal)、暂停、恢复等回调;支持对象池复用界面 |
| QFramework 的 UIKit | 轻量的 UI 管理 + 代码生成 | 编辑器中一键生成组件绑定代码,上手快,适合中小团队 |
| FairyGUI | 独立的 UI 编辑器 + 运行时,不基于 UGUI | 编辑器对美术友好,内置动效、虚拟列表、图文混排;自己做渲染和合批,性能好。休闲游戏中使用很多 |
| UI Toolkit | Unity 官方的新 UI 系统,类似网页的 UXML + USS | 编辑器扩展已经很成熟;游戏运行时 UI 的生态和工具链仍在完善中 |
本文以自研 UGUI 框架为主线,吸收上面几个方案的设计思路。即使项目使用 FairyGUI,层级、窗口栈、弹窗队列、红点这些设计依然适用。
三、整体结构
UIManager 对外提供 Open / Close 等接口├── UILayer × N 层级:每层一个 Canvas,决定显示的前后顺序│ └── UIWindow 具体界面,继承窗口基类├── 窗口栈 全屏界面的打开顺序,处理返回键├── PopupQueue 自动弹窗队列├── UIMask 共享的半透明遮罩└── 缓存池 关闭后暂不销毁的界面
RedDotSystem 红点系统,独立于 UIManager四、层级管理
层级划分
| 层级 | 内容 | 举例 |
|---|---|---|
| Scene | 跟随场景物体的 UI | 头顶血条、名字 |
| Main | 常驻界面 | 主界面、战斗 HUD |
| Window | 全屏界面 | 背包、商店、关卡选择 |
| Popup | 弹窗 | 签到、礼包、设置 |
| Guide | 新手引导 | 手指、高亮框 |
| Tips | 飘字提示 | ”金币不足” |
| Loading | 加载界面 | 场景切换 |
| System | 系统级 | 断线重连、强制更新确认框 |
层级从上到下依次叠加,System 永远在最上面:断线提示不能被任何界面挡住。
实现方式
每个层级是一个独立的 Canvas,用 sortingOrder 区分前后:
public enum UILayer{ Scene = 0, Main = 1000, Window = 2000, Popup = 3000, Guide = 4000, Tips = 5000, Loading = 6000, System = 7000,}- 同一层中的多个窗口,通过
sortingOrder在本层基础值上递增(比如 Popup 层的第 1 个窗口是 3010,第 2 个是 3020),后打开的在上面。 - 每个窗口自身也挂一个 Canvas(勾选 Override Sorting),这样窗口内部变化时只重建它自己,不影响其他界面(原理见 UGUI 性能优化)。
- 窗口内如果有粒子特效,特效的 Renderer 的
sortingOrder也要跟着窗口设置,否则会被 UI 挡住或穿透到上层。
五、窗口基类与生命周期
生命周期
首次打开 │ OnCreate 只执行一次:获取组件、绑定按钮事件 │ ┌──────▶ OnOpen(args) 每次打开:根据参数刷新内容 │ │ │ OnShow / OnHide 被上层全屏界面遮挡 / 重新露出(可选) │ │ │ OnClose 每次关闭:取消订阅、停止计时器 │ │ └── 缓存中再次打开 │ OnDestroy 真正销毁:释放资源区分 OnCreate 和 OnOpen 很重要:界面会被缓存复用,只需要做一次的工作放在 OnCreate,每次打开都要刷新的放在 OnOpen。
窗口基类
public abstract class UIWindow : MonoBehaviour{ public UIWindowConfig Config { get; internal set; } public bool IsOpen { get; private set; }
internal void Create() { OnCreate(); } internal void Open(object args) { IsOpen = true; gameObject.SetActive(true); OnOpen(args); } internal void Close() { IsOpen = false; OnClose(); gameObject.SetActive(false); }
protected virtual void OnCreate() { } protected virtual void OnOpen(object args) { } protected virtual void OnClose() { } protected internal virtual void OnShow() { } protected internal virtual void OnHide() { }
// 业务代码中关闭自己 protected void CloseSelf() => UIManager.Instance.Close(this);}窗口配置
每个窗口的行为差异,用配置描述,而不是写在各自的代码里:
[AttributeUsage(AttributeTargets.Class)]public class UIWindowConfig : Attribute{ public string Path; // Prefab 资源地址 public UILayer Layer = UILayer.Window; public bool FullScreen; // 全屏:打开时隐藏下面的界面 public bool UseMask; // 是否显示半透明遮罩 public bool CloseOnMaskClick; // 点击遮罩关闭 public bool Cache; // 关闭后是否缓存 public bool PushToStack; // 是否加入窗口栈(受返回键控制)}
[UIWindowConfig(Path = "UI/SignInPopup", Layer = UILayer.Popup, UseMask = true, CloseOnMaskClick = true)]public class SignInPopup : UIWindow{ protected override void OnOpen(object args) { Refresh(); }}也可以用配置表或 ScriptableObject 存放这些配置,方便策划调整,或者热更新。
六、UIManager 核心接口
public class UIManager{ public static UIManager Instance { get; } = new UIManager();
readonly Dictionary<Type, UIWindow> _opened = new(); // 已打开 readonly Dictionary<Type, UIWindow> _cached = new(); // 已关闭但缓存 readonly HashSet<Type> _loading = new(); // 正在加载
public async void Open<T>(object args = null) where T : UIWindow { var type = typeof(T); if (_opened.TryGetValue(type, out var opened)) { BringToFront(opened); opened.Open(args); // 已打开:置顶并刷新 return; } if (!_loading.Add(type)) return; // 正在加载中,防止重复打开
try { if (!_cached.Remove(type, out var window)) { window = await LoadWindowAsync(type); // 通过资源系统异步加载并实例化 window.Config = type.GetCustomAttribute<UIWindowConfig>(); window.Create(); } AttachToLayer(window); _opened[type] = window; window.Open(args); OnWindowOpened(window); // 处理遮罩、窗口栈、隐藏下层全屏界面 } finally { _loading.Remove(type); } }
public void Close(UIWindow window) { var type = window.GetType(); if (!_opened.Remove(type)) return; window.Close(); OnWindowClosed(window); // 处理遮罩、窗口栈、恢复下层界面
if (window.Config.Cache) _cached[type] = window; else DestroyWindow(window); // 销毁并释放资源句柄 }
public void Close<T>() where T : UIWindow { if (_opened.TryGetValue(typeof(T), out var w)) Close(w); }
public T Get<T>() where T : UIWindow => _opened.TryGetValue(typeof(T), out var w) ? (T)w : null;
public bool IsOpen<T>() where T : UIWindow => _opened.ContainsKey(typeof(T));}几个容易遗漏的细节:
- 加载中重复打开:玩家快速连点按钮时,第一次还在异步加载,第二次又来了。用
_loading拦截。 - 加载中被关闭:加载完成前已经调用了
Close,加载完要判断一下,不再显示。 - 打开已打开的界面:一般是置顶并用新参数刷新,而不是再创建一个。
- 场景切换:切场景时关闭非常驻界面,清理缓存。
LoadWindowAsync 通过资源系统加载,比如 YooAsset(见 热更新)。如果 UI 代码在热更层,整个 UI 框架通常也放在热更层。
七、窗口栈与返回键
全屏界面按打开顺序压入栈中:
打开 主界面 → 关卡选择 → 商店栈:[主界面, 关卡选择, 商店] ← 只有栈顶的商店可见,下面的都隐藏按返回键:关闭商店,恢复关卡选择- 打开全屏界面时,隐藏下面所有被完全挡住的界面,不仅省去渲染开销,下面界面的
Update也可以暂停(调用OnHide)。隐藏方式推荐禁用 Canvas,而不是SetActive(见 UGUI 性能优化)。 - 全屏界面打开时,还可以关闭 3D 场景相机,进一步节省开销。
- 返回键的处理顺序:优先关闭最上层的弹窗 → 没有弹窗时关闭栈顶的全屏界面 → 已经在主界面时弹出”确认退出游戏”。
- 引导进行中、加载界面显示时,返回键应该被屏蔽。
八、弹窗队列(休闲游戏重点)
需求
玩家进入主界面后,可能同时满足多个弹窗条件:
- 签到奖励
- 限时礼包
- 新活动开启
- 邀请评分
如果同时弹出,会叠在一起,体验很差。需要一个队列:
- 按优先级依次弹出,一次只显示一个。
- 当前弹窗关闭后,自动弹出下一个。
- 只在合适的时机弹:玩家在主界面、没有在引导中、没有其他弹窗。
- 同一个弹窗不要重复入队。
实现
public class PopupQueue{ class Request { public Type Type; public int Priority; public object Args; }
readonly List<Request> _queue = new(); bool _showing; bool _paused;
public void Enqueue<T>(int priority, object args = null) where T : UIWindow { if (_queue.Exists(r => r.Type == typeof(T))) return; // 去重 _queue.Add(new Request { Type = typeof(T), Priority = priority, Args = args }); _queue.Sort((a, b) => b.Priority.CompareTo(a.Priority)); // 优先级高的在前 TryShowNext(); }
// 引导、战斗、加载中暂停;回到主界面恢复 public void Pause() { _paused = true; } public void Resume() { _paused = false; TryShowNext(); }
void TryShowNext() { if (_paused || _showing || _queue.Count == 0) return; var req = _queue[0]; _queue.RemoveAt(0); _showing = true; UIManager.Instance.Open(req.Type, req.Args, onClosed: () => { _showing = false; TryShowNext(); }); }}(示例中 Open 需要一个按类型打开、并带关闭回调的重载,实现方式和泛型版本相同。)
使用:登录完成后,各个系统检查自己的条件,满足就入队:
if (SignInSystem.CanSignToday) popupQueue.Enqueue<SignInPopup>(priority: 100);if (GiftSystem.HasNewGift) popupQueue.Enqueue<GiftPopup>(priority: 80);if (RateSystem.ShouldAsk) popupQueue.Enqueue<RatePopup>(priority: 10);优先级建议集中配置(比如配置表),而不是散落在各个系统里,方便运营调整弹出顺序。
九、遮罩与点击控制
共享遮罩
弹窗下面通常有一层半透明黑色遮罩。不要每个弹窗各带一个,而是整个框架只用一个:
- 每次有带遮罩的窗口打开或关闭时,把遮罩移动到当前最上层的带遮罩窗口的正下方(调整它的
sortingOrder)。 - 没有任何带遮罩的窗口时,隐藏遮罩。
- 点击遮罩时,如果这个窗口配置了
CloseOnMaskClick,就关闭它。
这样既减少了半透明的叠加(Overdraw),也让多个弹窗叠加时只有一层黑色背景。
防止误触
- 动画期间屏蔽输入:打开、关闭动画播放时,用
CanvasGroup.blocksRaycasts = false或者一个全局的输入锁,防止玩家点到正在消失的按钮。 - 按钮防连点:领奖、购买类按钮,点击后一段时间内不能再次触发,避免重复请求。可以在通用按钮组件中统一处理。
十、动画
public interface IUIAnimation{ void PlayOpen(Action onComplete); void PlayClose(Action onComplete);}- 窗口打开时,先显示再播放打开动画;关闭时,等关闭动画播完再真正隐藏和回收。
- 休闲游戏常用的弹窗动画:从 0.8 倍缩放弹到 1 倍,配合透明度渐变,用 Tween 库实现。
- 不要用 Animator 做 UI 动画,它会每帧把元素标记为脏,导致 Canvas 重建(见 UGUI 性能优化)。
十一、界面切换与闪烁
闪烁从哪来
异步加载让”打开界面”变成了一个需要若干帧的过程,如果切换处理不好,玩家就会看到中间状态。以弹窗队列中”关闭 A、打开 B”为例:
第 N 帧 A 关闭 → 没有带遮罩的窗口了 → 遮罩隐藏 ← 背景亮了一下第 N+1 帧 B 还在异步加载…… ← 什么都没有第 N+3 帧 B 加载完成并显示 → 遮罩重新出现 ← 又暗下来常见的闪烁有三种:
| 现象 | 原因 |
|---|---|
| 遮罩闪烁 | 两个弹窗之间的空档,遮罩先消失再出现 |
| 空白帧 | 界面先显示了,但里面的图片还在加载,或者数据还没填好 |
| 动画跳帧 | 打开动画的初始状态(如缩放 0.8)还没设置,界面先以正常大小渲染了一帧,接着才跳到 0.8 开始播放 |
处理方法
1. 先加载,后切换
不要”先关 A、再加载 B”,而是”先加载 B,加载完成后在同一帧内关闭 A、显示 B”:
// 弹窗队列中切换到下一个var next = await UIManager.Instance.PrepareAsync(nextType); // 只加载、创建,不显示UIManager.Instance.Close(current);UIManager.Instance.Show(next, args); // 同一帧内完成切换这要求 UIManager 把”加载”和”显示”拆成两步。
2. 遮罩延续
弹窗队列中还有下一个弹窗时,关闭当前弹窗不隐藏遮罩,直到下一个显示或者队列清空。遮罩是共享的(见第九节),只需要在切换时跳过一次”隐藏”。
3. 队列预取
当前弹窗弹出时,就开始以较低优先级预加载队列中的下一个。等玩家关闭当前弹窗,下一个通常已经在内存中了。
4. 准备好再显示
界面显示前,先完成这些工作,再在同一帧里激活:
- 填好数据(
OnOpen中刷新内容); - 界面依赖的图片、图集已经加载完成;
- 打开动画的初始状态已经应用(比如先把缩放设为 0.8、透明度设为 0)。
5. 加载提示延迟出现
加载超过一个阈值(比如 0.3 秒)才显示转圈或”加载中”。大部分界面很快就能加载完,转圈一闪而过反而像闪烁。
6. 常用界面预加载
主界面、通用弹窗、确认框、奖励弹窗等,在登录或加载界面时就预先创建,并配置为缓存,之后打开不需要任何加载。
预加载的时机、优先级和代价,详见 资源加载与管理。
十二、屏幕适配
Canvas Scaler
- UI Scale Mode 选
Scale With Screen Size。 - 参考分辨率:竖屏休闲游戏常用 1080 × 1920。
- Match:根据屏幕宽高比动态设置。比参考分辨率更”瘦长”的手机(如 9:19.5)以宽度为准(Match = 0),更”宽胖”的设备(如 iPad 3:4)以高度为准(Match = 1),保证内容不被裁掉。
float screenRatio = (float)Screen.width / Screen.height;float designRatio = 1080f / 1920f;canvasScaler.matchWidthOrHeight = screenRatio < designRatio ? 0f : 1f;刘海屏与安全区
刘海、挖孔、底部手势条区域不能放按钮。用 Screen.safeArea 调整一个全屏节点的锚点,所有重要内容都放在它下面:
public class SafeArea : MonoBehaviour{ void Start() { var rt = (RectTransform)transform; Rect safe = Screen.safeArea; Vector2 min = safe.position; Vector2 max = safe.position + safe.size; min.x /= Screen.width; min.y /= Screen.height; max.x /= Screen.width; max.y /= Screen.height; rt.anchorMin = min; rt.anchorMax = max; }}背景图则应该铺满整个屏幕,不受安全区限制。
十三、组件绑定
界面代码需要获取按钮、文本等组件。常见的三种方式:
| 方式 | 做法 | 问题 |
|---|---|---|
transform.Find("Bg/BtnClose") | 按路径查找 | 美术调整层级后就找不到,且是字符串,出错只能运行时发现 |
| 拖拽赋值 | [SerializeField] 字段,在 Inspector 中拖 | 界面多时工作量大,容易漏拖 |
| 代码生成 | 按命名约定(如 btn_Close、txt_Title)自动生成绑定代码 | 推荐,休闲游戏界面多、迭代快,收益最大 |
代码生成配合 partial 类,把生成的部分和手写的部分分到两个文件中,重新生成时不会覆盖手写的逻辑(见 访问修饰符与类型修饰符):
// SignInPopup.Gen.cs —— 工具自动生成,不要手改public partial class SignInPopup{ Button btn_Close; Button btn_Claim; Text txt_Day; protected override void OnCreate() { btn_Close = transform.Find("Root/btn_Close").GetComponent<Button>(); // ... OnBind(); } partial void OnBind();}
// SignInPopup.cs —— 手写业务逻辑public partial class SignInPopup : UIWindow{ partial void OnBind() { btn_Close.onClick.AddListener(CloseSelf); btn_Claim.onClick.AddListener(OnClaim); }}十四、界面与数据分离
UI 只负责显示和收集输入,不应该包含游戏逻辑:
玩家点击"领取" ──▶ UI 调用 SignInSystem.Claim() │ 系统修改数据,发出事件 OnSignInChanged │UI 订阅了这个事件 ◀────────┘ 刷新显示- 逻辑写在系统(数据层)里,UI 关掉了逻辑照样正确。
- 多个界面显示同一份数据(比如金币数)时,数据一变,所有界面都能通过事件自动刷新。
- 在
OnOpen中订阅事件,在OnClose中取消订阅,否则界面关闭后仍被事件引用,造成泄漏,甚至在隐藏状态下报错。
这就是 MVC / MVP 思想的简化版。休闲游戏不必上完整的 MVVM 数据绑定框架,“数据层 + 事件 + 界面刷新”已经足够。
十五、红点系统
需求
红点需要层层汇总:邮件里有一封未读的系统邮件,“系统邮件”页签、“邮件”按钮都要显示红点,任何一个子项的红点消失后,父级要重新计算。
设计:红点树
用路径描述层级,每个节点的状态是”自身状态或任意子节点有红点”:
Main├── Main/Mail│ ├── Main/Mail/System ← 叶子节点:由邮件系统设置数量│ └── Main/Mail/Friend└── Main/Task ├── Main/Task/Daily └── Main/Task/Achievementpublic class RedDotNode{ public string Path; public RedDotNode Parent; public readonly List<RedDotNode> Children = new(); public event Action<int> OnChanged;
int _selfCount; public int Count { get; private set; }
public void SetCount(int count) // 只对叶子节点调用 { _selfCount = count; Recalculate(); }
void Recalculate() { int total = _selfCount; foreach (var child in Children) total += child.Count; if (total == Count) return; // 没变化就不再向上传递 Count = total; OnChanged?.Invoke(Count); Parent?.Recalculate(); // 向上汇总 }}- 业务系统只设置叶子节点:邮件系统收到新邮件时
RedDot.Get("Main/Mail/System").SetCount(n),父节点自动更新。 - UI 只监听:按钮上挂一个红点组件,配置路径,订阅
OnChanged显示或隐藏红点(同样要在界面关闭时取消订阅)。 - 红点系统和 UI 框架解耦:红点状态由数据决定,界面没打开时状态也是正确的。
十六、通用组件
跑马灯、飞金币、飘字、倒计时、新手引导等具体功能的实现,见 项目常用功能实现。
休闲游戏中值得封装成通用组件的:
常见追问
UI 框架主要解决什么问题? 统一管理界面的层级、打开关闭、生命周期、返回键、资源加载与释放,让业务代码只关心显示和交互。
UI 层级是怎么实现的?
每个层级一个 Canvas,用 sortingOrder 区分;同层的窗口在层级基础值上递增;每个窗口有自己的 Canvas,隔离重建。
为什么要区分 OnCreate 和 OnOpen? 界面会被缓存复用。只需做一次的(获取组件、绑定事件)放在 OnCreate,每次打开都要刷新的放在 OnOpen。
返回键怎么处理? 优先关闭最上层弹窗,然后关闭窗口栈栈顶的全屏界面,在主界面时弹出退出确认。引导中和加载中屏蔽返回键。
多个弹窗同时满足条件怎么办? 用弹窗队列按优先级依次弹出,一次只显示一个,关闭后弹下一个;在引导、战斗中暂停,回到主界面再恢复。
UI 界面关闭后要不要销毁? 常用的界面缓存起来,再次打开更快;不常用的销毁并释放资源。可以设置缓存数量上限,按最近使用淘汰。
弹窗连续切换时闪一下是什么原因?怎么解决? 异步加载造成的中间状态:遮罩先消失再出现、界面先显示后加载图片、动画初始状态没设置。解决方法是先加载下一个再在同一帧内切换、遮罩延续、预取队列中的下一个、准备完毕再显示。
刘海屏怎么适配?
用 Screen.safeArea 设置一个全屏节点的锚点,把重要内容放在它下面;背景铺满整个屏幕。
红点系统怎么设计? 用路径组织成一棵树,业务系统只设置叶子节点,父节点自动汇总;UI 只订阅节点的变化。红点状态与界面解耦。
UI 和业务逻辑怎么解耦? 逻辑放在系统(数据层),UI 调用系统的方法、订阅系统的事件来刷新,在界面关闭时取消订阅。
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!