375 lines
10 KiB
C#
375 lines
10 KiB
C#
using Cysharp.Threading.Tasks;
|
||
using DG.Tweening;
|
||
using PhxhSDK;
|
||
using UnityEngine;
|
||
using UniTask = Cysharp.Threading.Tasks.UniTask;
|
||
|
||
public abstract partial class UIWindow
|
||
{
|
||
public GameObject gameObject;
|
||
public Transform transform;
|
||
public string name;
|
||
|
||
|
||
private string mWindowName;
|
||
|
||
/// <summary>
|
||
/// 资源引用管理器
|
||
/// </summary>
|
||
private PhxhSDK.AssetReferenceManager _assetReferenceManager;
|
||
|
||
private bool _isCloseCbCalled;
|
||
|
||
protected bool _isShow = false;
|
||
protected bool _isPaused = false; // 窗口暂停状态（用于音乐、动画等逻辑控制）
|
||
|
||
// 刘海屏适配器Ω
|
||
private UINotchScreenAdapter _notchScreenAdapter;
|
||
|
||
// GraphicRaycaster管理器
|
||
private GraphicRaycasterManager _graphicRaycasterManager;
|
||
/// <summary>
|
||
/// Public accessor for the `GraphicRaycasterManager`. Lazily initializes on first access and cannot be assigned.
|
||
/// </summary>
|
||
public GraphicRaycasterManager GraphicRaycasterManager
|
||
{
|
||
get
|
||
{
|
||
if (_graphicRaycasterManager == null)
|
||
InitGraphicRaycasterManager();
|
||
return _graphicRaycasterManager;
|
||
}
|
||
}
|
||
|
||
public bool IsClosing; //正在关闭
|
||
|
||
/// <summary>
|
||
/// 返回键策略（在窗口加载到Layer时设置）
|
||
/// </summary>
|
||
public IUIBackStrategy BackStrategy { get; set; }
|
||
|
||
private bool _isPlayingOpenAnim;
|
||
|
||
protected Sequence _openAnimSeq;
|
||
public bool IsShowOpenAnim;
|
||
|
||
public string WindowName
|
||
{
|
||
set { mWindowName = value; }
|
||
get { return mWindowName; }
|
||
}
|
||
|
||
[HideInInspector]
|
||
public UICanvasLayer uiWindowLayer;
|
||
|
||
[HideInInspector]
|
||
protected bool isInited = false;
|
||
|
||
/// <summary>
|
||
/// 初始化GraphicRaycaster管理器
|
||
/// </summary>
|
||
private void InitGraphicRaycasterManager()
|
||
{
|
||
if (_graphicRaycasterManager == null && gameObject is not null)
|
||
{
|
||
_graphicRaycasterManager = new GraphicRaycasterManager(gameObject);
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// 初始化刘海屏适配
|
||
/// </summary>
|
||
private void InitScreenAdaption()
|
||
{
|
||
if (_notchScreenAdapter == null)
|
||
{
|
||
_notchScreenAdapter = new UINotchScreenAdapter(transform);
|
||
}
|
||
}
|
||
|
||
public async UniTask<T> LoadAssetAsync<T>(string path) where T : UnityEngine.Object
|
||
{
|
||
if (gameObject)
|
||
{
|
||
// 确保资源管理器已初始化
|
||
if (_assetReferenceManager == null)
|
||
{
|
||
_assetReferenceManager = new PhxhSDK.AssetReferenceManager();
|
||
}
|
||
|
||
return await _assetReferenceManager.LoadAssetAsync<T>(path);
|
||
}
|
||
|
||
// 如果gameObject为空，直接通过AssetManager加载
|
||
return await AssetManager.Instance.LoadAssetAsync<T>(path);
|
||
}
|
||
|
||
|
||
/// <summary>
|
||
/// 异步预加载资源
|
||
/// </summary>
|
||
/// <param name="path">资源路径</param>
|
||
public async UniTask PostPreload<T>(string path) where T : UnityEngine.Object
|
||
{
|
||
// 确保资源管理器已初始化
|
||
if (_assetReferenceManager == null)
|
||
{
|
||
_assetReferenceManager = new PhxhSDK.AssetReferenceManager();
|
||
}
|
||
|
||
await _assetReferenceManager.PostPreload<T>(path);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 获取预加载的资源结果
|
||
/// </summary>
|
||
/// <param name="path">资源路径</param>
|
||
public T GetPreLoadResult<T>(string path) where T : UnityEngine.Object
|
||
{
|
||
// 优先使用资源管理器获取结果
|
||
if (_assetReferenceManager != null)
|
||
{
|
||
return _assetReferenceManager.GetPreLoadResult<T>(path);
|
||
}
|
||
|
||
// 回退到直接使用AssetManager
|
||
return AssetManager.Instance.GetPreLoadResult<T>(path);
|
||
}
|
||
|
||
protected void UnLoad()
|
||
{
|
||
// 使用资源管理器卸载所有资源
|
||
if (_assetReferenceManager != null)
|
||
{
|
||
_assetReferenceManager.UnloadAll();
|
||
}
|
||
}
|
||
|
||
|
||
#region Component Utilities
|
||
|
||
public GameObject FindObj(string path)
|
||
{
|
||
GameObject obj = transform.Find(path)?.gameObject;
|
||
if (obj is null)
|
||
{
|
||
DebugUtil.LogError("{0}未找到 {1}/{2}", mWindowName, gameObject.name, path);
|
||
}
|
||
return obj;
|
||
}
|
||
|
||
public T GetComponent<T>(string path = "") where T : Behaviour
|
||
{
|
||
var component = transform.Find(path)?.GetComponent<T>();
|
||
if (component is null)
|
||
{
|
||
DebugUtil.LogError("{0}未找到组件{1}： {2}", mWindowName, typeof(T).Name, path);
|
||
}
|
||
return component;
|
||
}
|
||
|
||
public T AddComponent<T>(string path = "") where T : Behaviour
|
||
{
|
||
var trans = transform.Find(path);
|
||
if (trans)
|
||
{
|
||
var component = trans.GetComponent<T>();
|
||
if (component is null)
|
||
{
|
||
component = trans.gameObject.AddComponent<T>();
|
||
//DebugUtil.LogError("{0}未找到组件{1}： {2}", mWindowName, typeof(T).Name, path);
|
||
}
|
||
return component;
|
||
}
|
||
|
||
DebugUtil.LogError("{0}未找到路径: {1}", mWindowName, path);
|
||
return null;
|
||
}
|
||
#endregion
|
||
|
||
#region State Query Methods
|
||
|
||
public bool IsCreated()
|
||
{
|
||
return isInited;
|
||
}
|
||
|
||
public bool IsShow()
|
||
{
|
||
return _isShow;
|
||
}
|
||
|
||
public bool IsHide()
|
||
{
|
||
return !_isShow;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 是否处于活跃状态（显示且未暂停）
|
||
/// </summary>
|
||
public bool IsActive()
|
||
{
|
||
return _isShow && !_isPaused;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 是否处于暂停状态
|
||
/// </summary>
|
||
public bool IsPaused()
|
||
{
|
||
return _isPaused;
|
||
}
|
||
|
||
#endregion
|
||
|
||
#region Pause/Resume Management
|
||
|
||
/// <summary>
|
||
/// 暂停窗口（手动调用）
|
||
///
|
||
/// 功能：
|
||
/// - 标记窗口为暂停状态
|
||
/// - 调用 OnPause 回调
|
||
/// - 可选：隐藏渲染（通过 hideRendering 参数控制）
|
||
///
|
||
/// 使用场景：
|
||
/// - 游戏暂停时，手动暂停战斗 UI
|
||
/// - 弹出全屏广告时，暂停游戏主界面
|
||
/// - 特殊业务逻辑需要暂停某个窗口
|
||
///
|
||
/// 示例：
|
||
/// battleUI.PauseWindow(hideRendering: false); // 暂停逻辑但保持显示
|
||
/// </summary>
|
||
/// <param name="hideRendering">是否同时隐藏渲染（SetActive(false)）</param>
|
||
public void PauseWindow(bool hideRendering = true)
|
||
{
|
||
// 状态检查
|
||
if (!_isShow)
|
||
{
|
||
DebugUtil.LogWarning($"[UIWindow] PauseWindow failed: window is not showing ({WindowName})");
|
||
return;
|
||
}
|
||
|
||
if (_isPaused)
|
||
{
|
||
DebugUtil.LogWarning($"[UIWindow] PauseWindow ignored: already paused ({WindowName})");
|
||
return;
|
||
}
|
||
|
||
_isPaused = true;
|
||
|
||
// 调用子类的暂停逻辑
|
||
OnPause();
|
||
|
||
// 可选：隐藏渲染
|
||
if (hideRendering && gameObject != null && gameObject.activeSelf)
|
||
{
|
||
gameObject.SetActive(false);
|
||
DebugUtil.Log($"[UIWindow] Paused (hidden): {WindowName}");
|
||
}
|
||
else
|
||
{
|
||
DebugUtil.Log($"[UIWindow] Paused (logic only): {WindowName}");
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// 恢复窗口（手动调用）
|
||
///
|
||
/// 功能：
|
||
/// - 标记窗口为活跃状态
|
||
/// - 调用 OnResume 回调
|
||
/// - 可选：显示渲染（通过 showRendering 参数控制）
|
||
///
|
||
/// 使用场景：
|
||
/// - 游戏恢复时，手动恢复战斗 UI
|
||
/// - 广告关闭后，恢复游戏主界面
|
||
/// - 特殊业务逻辑需要恢复某个窗口
|
||
///
|
||
/// 示例：
|
||
/// battleUI.ResumeWindow(showRendering: true); // 恢复逻辑并显示
|
||
/// </summary>
|
||
/// <param name="showRendering">是否同时显示渲染（SetActive(true)）</param>
|
||
public void ResumeWindow(bool showRendering = true)
|
||
{
|
||
// 状态检查
|
||
if (!_isShow)
|
||
{
|
||
DebugUtil.LogWarning($"[UIWindow] ResumeWindow failed: window is not showing ({WindowName})");
|
||
return;
|
||
}
|
||
|
||
if (!_isPaused)
|
||
{
|
||
DebugUtil.LogWarning($"[UIWindow] ResumeWindow ignored: not paused ({WindowName})");
|
||
return;
|
||
}
|
||
|
||
_isPaused = false;
|
||
|
||
// 可选：显示渲染
|
||
if (showRendering && gameObject != null && !gameObject.activeSelf)
|
||
{
|
||
gameObject.SetActive(true);
|
||
DebugUtil.Log($"[UIWindow] Resumed (shown): {WindowName}");
|
||
}
|
||
else
|
||
{
|
||
DebugUtil.Log($"[UIWindow] Resumed (logic only): {WindowName}");
|
||
}
|
||
|
||
// 调用子类的恢复逻辑
|
||
OnResume();
|
||
}
|
||
|
||
#endregion
|
||
|
||
#region Virtual Methods - Pause/Resume
|
||
|
||
/// <summary>
|
||
/// 窗口暂停回调（子类重写）
|
||
///
|
||
/// 调用时机：手动调用 PauseWindow() 时
|
||
///
|
||
/// 建议处理：
|
||
/// - 停止播放背景音乐/音效
|
||
/// - 暂停动画/粒子特效
|
||
/// - 暂停定时器/倒计时
|
||
/// - 暂停网络轮询（可选）
|
||
///
|
||
/// 示例：
|
||
/// <code>
|
||
/// protected override void OnPause()
|
||
/// {
|
||
/// if (_bgmHandle != -1)
|
||
/// AudioManager.Instance.PauseBGM(_bgmHandle);
|
||
/// }
|
||
/// </code>
|
||
/// </summary>
|
||
protected virtual void OnPause() { }
|
||
|
||
/// <summary>
|
||
/// 窗口恢复回调（子类重写）
|
||
///
|
||
/// 调用时机：手动调用 ResumeWindow() 时
|
||
///
|
||
/// 建议处理：
|
||
/// - 恢复播放背景音乐/音效
|
||
/// - 恢复动画/粒子特效
|
||
/// - 恢复定时器/倒计时
|
||
/// - 刷新数据（可选）
|
||
///
|
||
/// 示例：
|
||
/// <code>
|
||
/// protected override void OnResume()
|
||
/// {
|
||
/// if (_bgmHandle != -1)
|
||
/// AudioManager.Instance.ResumeBGM(_bgmHandle);
|
||
/// }
|
||
/// </code>
|
||
/// </summary>
|
||
protected virtual void OnResume() { }
|
||
|
||
#endregion
|
||
}
|