游戏UI框架设计(三)
---窗体的层级管理
UI框架中UI窗体的“层级管理”,最核心的问题是如何进行窗体的显示管理。窗体(预设)的显示我们前面定义了三种类型: 普通、隐藏其他、反向切换。代码如下:
“普通显示”模式允许多个窗体同时显示,这种类型应用最多。例如RPG中的主城界面(见下图)。
“隐藏其他界面” 模式一般应用于全局性的窗体。我们在开发此类窗体时,为了减少UI渲染压力、提高Unity渲染效率,则设置被覆盖的窗体为“不可见”状态。(即: this.gameObject.SetActive(false))。例如一般的登录窗体、选择英雄窗体等。
“反向切换”模式类型,一般都大量引用于“弹出窗体”中。此类窗体的特点是:显示弹出窗体时不完全覆盖底层窗体,一般在屏幕的四周会露出底层窗体。之所以命名“反向切换”是因为: 程序员要维护一种“后进先出”的“栈”的数据结构特点,即我们一般要求玩家必须先关闭弹出的顶层窗体,再依次关闭下一级窗体。如下图所示。
上图即一种典型的弹出窗体。一般我们都要求玩家先处理弹出窗体中的信息,然后关闭此窗体。一般不允许在没有关闭子窗体的情况下,直接点击父窗体。(关于弹出窗体时,不允许玩家点击父窗体的功能实现,笔者在下节[“模态窗体管理”]一章着重讲解)。
以上说了这么多了,我们对于“层级管理”的核心代码实现,基本都体现在“UI管理器脚本” (UIManager.cs )中。以下给出具体实现代码:
/***
* Title: "SUIFW" 框架技术
* 主题: UI管理器
* Description:
* 功能:整个UI框架的核心,用户程序通过调用本类,来调用本框架的大多数功能。
* 功能1:关于入“栈”与出“栈”的UI窗体4个状态的定义逻辑
* 入栈状态:
* Freeze(); (上一个UI窗体)冻结
* Display(); (本UI窗体)显示
* 出栈状态:
* Hiding(); (本UI窗体) 隐藏
* Redisplay(); (上一个UI窗体) 重新显示
* 功能2:增加“非栈”缓存集合。
*/
using UnityEngine;
usingUnityEngine.UI;
using System;
usingSystem.Collections.Generic;
namespace SUIFW
{
publicclassUIManager : MonoBehaviour
{
/* 字段 */
//本类实例
privatestaticUIManager_Instance = null;
//存储所有“UI窗体预设(Prefab)”路径
//参数含义: 第1个string 表示“窗体预设”名称,后一个string 表示对应的路径
privateDictionary<string,string> _DicUIFormsPaths;
//缓存所有已经打开的“UI窗体预设(Prefab)”
//参数含义: 第1个string 表示“窗体预设”名称,后一个BaseUI 表示对应的“窗体预设”
privateDictionary<string,BaseUIForms> _DicALLUIForms;
//“栈”结构表示的“当前UI窗体”集合。
privateStack<BaseUIForms>_StaCurrentUIForms;
//当前显示状态的UI窗体集合
privateDictionary<string,BaseUIForms> _DicCurrentShowUIForms;
//UI根节点
privateTransform _CanvasTransform = null;
//普通全屏界面节点
privateTransform _CanTransformNormal = null;
//固定界面节点
privateTransform _CanTransformFixed = null;
//弹出模式节点
privateTransform _CanTransformPopUp = null;
//UI脚本节点(加载各种管理脚本的节点)
privateTransform _CanTransformUIScripts = null;
///<summary>
///得到本类实例
///</summary>
///<returns></returns>
publicstaticUIManagerGetInstance()
{
if(_Instance == null)
{
_Instance = newGameObject("_UIManager").AddComponent<UIManager>();
}
return_Instance;
}
voidAwake()
{
//字段初始化
_DicUIFormsPaths = newDictionary<string,string>();
_DicALLUIForms = newDictionary<string,BaseUIForms>();
_StaCurrentUIForms = newStack<BaseUIForms>();
_DicCurrentShowUIForms = newDictionary<string,BaseUIForms>();
//初始化项目开始必须的资源加载
InitRootCanvasLoading();
//得到UI根节点、及其重要子节点
_CanvasTransform = GameObject.FindGameObjectWithTag(SysDefine.SYS_TAG_CANVAS).transform;
//得到普通全屏界面节点、固定界面节点、弹出模式节点、UI脚本节点
_CanTransformNormal = UnityHelper.FindTheChild(_CanvasTransform.gameObject,SysDefine.SYS_CANVAS_NORMAL_NODE_NAME);
_CanTransformFixed = UnityHelper.FindTheChild(_CanvasTransform.gameObject,SysDefine.SYS_CANVAS_FIXED_NODE_NAME);
_CanTransformPopUp = UnityHelper.FindTheChild(_CanvasTransform.gameObject,SysDefine.SYS_CANVAS_POPUP_NODE_NAME);
_CanTransformUIScripts = UnityHelper.FindTheChild(_CanvasTransform.gameObject,SysDefine.SYS_CANVAS_UISCRIPTS_NODE_NAME);
//把本脚本实例,作为Canvas的子节点
UnityHelper.AddChildToParent(_CanTransformUIScripts,this.gameObject.transform);
//本UI节点信息,场景转换时,不允许销毁
DontDestroyOnLoad(_CanvasTransform);
//初始化“UI窗体预设”路径数据
InitUIFormsPathsData();
}
///<summary>
///显示UI窗体
///</summary>
///<param name="strUIFormName">UI窗体的名称</param>
publicvoid ShowUIForms(stringstrUIFormName)
{
BaseUIFormsbaseUIForms; //UI窗体基类
//参数检查
if(string.IsNullOrEmpty(strUIFormName)) return;
//加载“UI窗体名称”,到“所有UI窗体缓存”中
baseUIForms =LoadUIFormsToAllUIFormsCatch(strUIFormName);
if(baseUIForms == null) return;
//判断是否清空“栈”结构体集合
if(baseUIForms.CurrentUIType.IsClearReverseChange)
{
ClearStackArray();
}
//判断不同的窗体显示模式,分别进行处理
switch(baseUIForms.CurrentUIType.UIForms_ShowMode)
{
caseUIFormsShowMode.Normal:
EnterUIFormsCache(strUIFormName);
break;
caseUIFormsShowMode.ReverseChange:
PushUIForms(strUIFormName);
break;
caseUIFormsShowMode.HideOther:
EnterUIFormstToCacheHideOther(strUIFormName);
break;
default:
break;
}
}
///<summary>
///关闭或返回上一个UI窗体(关闭当前UI窗体)
///</summary>
publicvoid CloseOrReturnUIForms(stringstrUIFormName)
{
BaseUIFormsbaseUIForms = null; //UI窗体基类
/* 参数检查 */
if(string.IsNullOrEmpty(strUIFormName)) return;
//“所有UI窗体缓存”如果没有记录,则直接返回。
_DicALLUIForms.TryGetValue(strUIFormName, outbaseUIForms);
if(baseUIForms == null) return;
/* 判断不同的窗体显示模式,分别进行处理 */
switch(baseUIForms.CurrentUIType.UIForms_ShowMode)
{
caseUIFormsShowMode.Normal:
ExitUIFormsCache(strUIFormName);
break;
caseUIFormsShowMode.ReverseChange:
PopUIForms();
break;
caseUIFormsShowMode.HideOther:
ExitUIFormsFromCacheAndShowOther(strUIFormName);
break;
default:
break;
}
}
#region私有方法
///<summary>
///根据指定UI窗体名称,加载到“所有UI窗体”缓存中。
///</summary>
///<param name="strUIFormName">UI窗体名称</param>
///<returns></returns>
privateBaseUIForms LoadUIFormsToAllUIFormsCatch(stringstrUIFormName)
{
BaseUIFormsbaseUI; //UI窗体
//判断“UI预设缓存集合”是否有指定的UI窗体,否则新加载窗体
_DicALLUIForms.TryGetValue(strUIFormName, outbaseUI);
if(baseUI == null)
{
//加载指定路径的“UI窗体”
baseUI =LoadUIForms(strUIFormName);
}
returnbaseUI;
}
///<summary>
///加载UI窗体到“当前显示窗体集合”缓存中。
///</summary>
///<param name="strUIFormsName"></param>
privatevoid EnterUIFormsCache(stringstrUIFormsName)
{
BaseUIFormsbaseUIForms; //UI窗体基类
BaseUIFormsbaseUIFormsFromAllCache; //"所有窗体集合"中的窗体基类
//“正在显示UI窗体缓存”集合里有记录,则直接返回。
_DicCurrentShowUIForms.TryGetValue(strUIFormsName, outbaseUIForms);
if(baseUIForms != null) return;
//把当前窗体,加载到“正在显示UI窗体缓存”集合里
_DicALLUIForms.TryGetValue(strUIFormsName, outbaseUIFormsFromAllCache);
if(baseUIFormsFromAllCache != null)
{
_DicCurrentShowUIForms.Add(strUIFormsName, baseUIFormsFromAllCache);
baseUIFormsFromAllCache.Display();
}
}
///<summary>
///卸载UI窗体从“当前显示窗体集合”缓存中。
///</summary>
///<paramname="strUIFormsName"></param>
privatevoid ExitUIFormsCache(stringstrUIFormsName)
{
BaseUIFormsbaseUIForms; //UI窗体基类
//“正在显示UI窗体缓存”集合没有记录,则直接返回。
_DicCurrentShowUIForms.TryGetValue(strUIFormsName, outbaseUIForms);
if(baseUIForms == null) return;
//指定UI窗体,运行隐藏状态,且从“正在显示UI窗体缓存”集合中移除。
baseUIForms.Hiding();
_DicCurrentShowUIForms.Remove(strUIFormsName);
}
///<summary>
///加载UI窗体到“当前显示窗体集合”缓存中,且隐藏其他正在显示的页面
///</summary>
///<paramname="strUIFormsName"></param>
privatevoid EnterUIFormstToCacheHideOther(stringstrUIFormsName)
{
BaseUIFormsbaseUIForms; //UI窗体基类
BaseUIFormsbaseUIFormsFromAllCache; //"所有窗体集合"中的窗体基类
//“正在显示UI窗体缓存”集合里有记录,则直接返回。
_DicCurrentShowUIForms.TryGetValue(strUIFormsName, outbaseUIForms);
if(baseUIForms != null) return;
//“正在显示UI窗体缓存”与“栈缓存”集合里所有窗体进行隐藏处理。
foreach(BaseUIForms baseUIFormsItem in_DicCurrentShowUIForms.Values)
{
baseUIFormsItem.Hiding();
}
foreach(BaseUIForms basUIFormsItem in_StaCurrentUIForms)
{
basUIFormsItem.Hiding();
}
//把当前窗体,加载到“正在显示UI窗体缓存”集合里
_DicALLUIForms.TryGetValue(strUIFormsName,out baseUIFormsFromAllCache);
if(baseUIFormsFromAllCache != null)
{
_DicCurrentShowUIForms.Add(strUIFormsName, baseUIFormsFromAllCache);
baseUIFormsFromAllCache.Display();
}
}
///<summary>
///卸载UI窗体从“当前显示窗体集合”缓存中,且显示其他原本需要显示的页面
///</summary>
///<paramname="strUIFormsName"></param>
privatevoidExitUIFormsFromCacheAndShowOther(stringstrUIFormsName)
{
BaseUIFormsbaseUIForms; //UI窗体基类
//“正在显示UI窗体缓存”集合没有记录,则直接返回。
_DicCurrentShowUIForms.TryGetValue(strUIFormsName, outbaseUIForms);
if(baseUIForms == null) return;
//指定UI窗体,运行隐藏状态,且从“正在显示UI窗体缓存”集合中移除。
baseUIForms.Hiding();
_DicCurrentShowUIForms.Remove(strUIFormsName);
//“正在显示UI窗体缓存”与“栈缓存”集合里所有窗体进行再次显示处理。
foreach(BaseUIForms baseUIFormsItem in_DicCurrentShowUIForms.Values)
{
baseUIFormsItem.Redisplay();
}
foreach(BaseUIForms basUIFormsItem in_StaCurrentUIForms)
{
basUIFormsItem.Redisplay();
}
}
///<summary>
///UI窗体入栈
///功能1: 判断栈里是否已经有窗体,有则“冻结”
/// 2: 先判断“UI预设缓存集合”是否有指定的UI窗体,有则处理。
/// 3: 指定UI窗体入"栈"
///</summary>
///<paramname="strUIFormsName"></param>
privatevoid PushUIForms(stringstrUIFormsName)
{
BaseUIFormsbaseUI; //UI预设窗体
//判断栈里是否已经有窗体,有则“冻结”
if(_StaCurrentUIForms.Count > 0)
{
BaseUIFormstopUIForms = _StaCurrentUIForms.Peek();
topUIForms.Freeze();
}
//先判断“UI预设缓存集合”是否有指定的UI窗体,有则处理。
_DicALLUIForms.TryGetValue(strUIFormsName, outbaseUI);
if(baseUI != null)
{
baseUI.Display();
}
else
{
Log.Write(GetType()+ string.Format("/PushUIForms()/ baseUI==null! 核心错误,请检查strUIFormsName={0}", strUIFormsName), Log.Level.High);
}
//指定UI窗体入"栈"
_StaCurrentUIForms.Push(baseUI);
}
///<summary>
///UI窗体出栈逻辑
///</summary>
privatevoid PopUIForms()
{
if(_StaCurrentUIForms.Count >= 2)
{
/* 出栈逻辑 */
BaseUIFormstopUIForms = _StaCurrentUIForms.Pop();
//出栈的窗体,进行隐藏处理
topUIForms.Hiding();
//出栈窗体的下一个窗体逻辑
BaseUIFormsnextUIForms = _StaCurrentUIForms.Peek();
//下一个窗体"重新显示"处理
nextUIForms.Redisplay();
}
elseif (_StaCurrentUIForms.Count == 1)
{
/* 出栈逻辑 */
BaseUIFormstopUIForms = _StaCurrentUIForms.Pop();
//出栈的窗体,进行"隐藏"处理
topUIForms.Hiding();
}
}
///<summary>
///加载与显示UI窗体
///功能:
/// 1:根据“UI窗体预设”名称,加载预设克隆体。
/// 2:预设克隆体添加UI“根节点”为父节点。
/// 3:隐藏刚创建的UI克隆体。
/// 4:新创建的“UI窗体”,加入“UI窗体缓存”中
///</summary>
privateBaseUIForms LoadUIForms(stringstrUIFormsName)
{
stringstrUIFormsPaths = null; //UI窗体的路径
GameObjectgoCloneUIPrefab = null; //克隆的"窗体预设"
BaseUIFormsbaseUIForm; //UI窗体
//得到UI窗体的路径
_DicUIFormsPaths.TryGetValue(strUIFormsName, outstrUIFormsPaths);
//加载指定路径的“UI窗体”
if(!string.IsNullOrEmpty(strUIFormsPaths))
{
goCloneUIPrefab = ResourcesMgr.GetInstance().LoadAsset(strUIFormsPaths,false);
}
//设置“UI窗体”克隆体的父节点,以及隐藏处理与加入“UI窗体缓存”中
if(_CanvasTransform != null&& goCloneUIPrefab != null)
{
baseUIForm = goCloneUIPrefab.GetComponent<BaseUIForms>();
if(baseUIForm == null)
{
Log.Write(GetType()+ string.Format("/LoadUIForms()/ baseUIForm==null!,请先确认克隆对象上是否加载了BaseUIForms的子类。参数 strUIFormsName='{0}' ", strUIFormsName), Log.Level.High);
returnnull;
}
switch(baseUIForm.CurrentUIType.UIForms_Type)
{
caseUIFormsType.Normal:
goCloneUIPrefab.transform.SetParent(_CanTransformNormal,false);
break;
caseUIFormsType.Fixed:
goCloneUIPrefab.transform.SetParent(_CanTransformFixed, false);
break;
caseUIFormsType.PopUp:
goCloneUIPrefab.transform.SetParent(_CanTransformPopUp, false);
break;
default:
break;
}
goCloneUIPrefab.SetActive(false);
//新创建的“UI窗体”,加入“UI窗体缓存”中
_DicALLUIForms.Add(strUIFormsName, baseUIForm);
returnbaseUIForm;
}
else
{
Log.Write(GetType()+ string.Format("/LoadUIForms()/‘_CanvasTransform’ Or ‘goCloneUIPrefab’==NULL! , 方法参数strUIFormsName={0},请检查!", strUIFormsName), Log.Level.High);
}
Log.Write(GetType()+ string.Format("/LoadUIForms()/ 出现不可预知错误,请检查! 方法参数strUIFormsName={0}", strUIFormsName), Log.Level.High);
returnnull;
}
///<summary>
///初始化项目开始必须的资源加载
///</summary>
privatevoid InitRootCanvasLoading()
{
if(UnityHelper.isFirstLoad)
{
ResourcesMgr.GetInstance().LoadAsset(SysDefine.SYS_PATH_CANVAS, false);
}
}
///<summary>
///初始化“UI窗体预设”路径数据
///</summary>
privatevoid InitUIFormsPathsData()
{
//测试也成功
IConfigManagerconfigMgr = newConfigManagerByJson(SysDefine.SYS_PATH_UIFormConfigJson);
if(_DicUIFormsPaths != null)
{
_DicUIFormsPaths =configMgr.AppSetting;
}
}
///<summary>
///清空“栈”结构体集合
///</summary>
///<returns></returns>
privatebool ClearStackArray()
{
if(_StaCurrentUIForms != null&& _StaCurrentUIForms.Count >= 1)
{
_StaCurrentUIForms.Clear();
returntrue;
}
returnfalse;
}
#endregion
}//Class_end
}
以上代码解释:
1: UIManager.cs 中定义的新的字段 ,“_StaCurrentUIForms” 就是一个“栈”数据类型,用于维护一种后进先出的数据结构。常见的方法如下:
C#语言中提供 Stack<T> 泛型集合,来直接实现这种结构。
常用属性与方法:
Count 属性 查询栈内元素数量
Push() 压栈
Pop() 出栈
Peek() 查询栈顶元素
GetEnumerator() 遍历栈中所有元素
2: UIManager.cs 中的“ShowUIForms()”方法中的PushUIForms()与EnterUIFormstToCacheHideOther() 方法,就是专门处理“反向切换”与“隐藏其他”窗体特性的实现方法。
好了时间不早了就先写到这吧,大家有什么疑问可以讨论,这里笔者也主要是想起到“抛砖引玉”的作用。
本篇就先写到这,下篇 "游戏UI框架设计(4)_模态窗体管理" 继续。
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。