using System;
using Cysharp.Threading.Tasks;
using DG.Tweening;
using Framework;
using PhxhSDK;
using UnityEngine;
using UnityEngine.UI;
///
/// UI窗口基类 - 生命周期管理部分
/// 包含窗口的创建、显示、隐藏、关闭等生命周期管理功能
///
public abstract partial class UIWindow
{
/*
╔══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════╗
║ UIWindow 生命周期 (Lifecycle) ║
╠══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════╣
║ ║
║ 1. 【Load 阶段】- 资源加载 ║
║ UIRoot.CreateWindow() ║
║ ├─ 加载预制体资源 ║
║ ├─ 实例化GameObject ║
║ └─ 创建UIWindow实例 ║
║ ║
║ 2. 【Init 阶段】- 初始化 ║
║ UIWindow.Init(data) // 窗口初始化(独立调用) ║
║ ├─ *OnBeforeInit(data) // 预处理数据 (原 PreLoad) ║
║ ├─ DoInit() // 基础初始化 ║
║ │ ├─ AutoBindField() // 绑定UI组件引用 ║
║ │ ├─ InitScreenAdaption() // 屏幕适配 ║
║ │ └─ _TryBindBgClose() // 绑定通用事件 ║
║ └─ *OnInit() // 初始化UI状态,设置默认值 ║
║ ║
║ 3. 【Show 阶段】- 显示 ║
║ UIWindow.ShowWindow(data) // 显示窗口(公共接口) ║
║ └─ Show(data) // 内部显示逻辑 ║
║ ├─ 设置相机状态 // 处理全屏窗口的相机逻辑 ║
║ ├─ *OnShow(data) // 显示回调,业务逻辑处理 ║
║ ├─ 播放打开动画 // 根据设置播放动画 ║
║ └─ 播放音效 // 播放默认打开音效 ║ ║
║ ├─ SetActive(true) // 激活GameObject ║
║ 4. 【Update 阶段】- 运行时更新 ║
║ Update(dt) -> *OnUpdate(dt) // 每帧更新,处理UI逻辑(合并原 Update) ║
║ ║
║ 5. 【Refresh 阶段】- 数据刷新 ║
║ RefreshWithData(data) // 数据刷新(原 ReloadWindow) ║
║ └─ *OnDataRefresh(data) // 刷新UI内容,更新显示数据(原 OnReloadWindow) ║
║ ║
║ 6. 【Hide 阶段】- 隐藏 ║
║ HideWindow() -> Hide() ║
║ ├─ SetActive(false) // 隐藏GameObject ║
║ └─ *OnHideWindow() // 隐藏回调 ║
║ ║
║ 7. 【Close 阶段】- 关闭销毁 ║
║ CloseWindow() -> DestroyWindow() ║
║ ├─ *OnHideWindow() // 隐藏回调 ║
║ ├─ *OnRelease() // 释放资源,清理引用 ║
║ ├─ Destroy(gameObject) // 销毁GameObject ║
║ └─ 卸载资源 ║
║ ║
║ 【当前架构特点】 ║
║ • 分离式设计: Init和Show独立调用,支持预初始化窗口 ║
║ • 使用方式: 先调用Init(data)初始化,再调用ShowWindow(data)显示 ║
║ • 灵活性: 可以先初始化多个窗口,根据需要选择性显示 ║
║ • 性能优化: 避免显示时的初始化卡顿,提升用户体验 ║
║ ║
║ 【子类需要关注的虚函数 - 标记为 * 的函数】 ║
║ ║
║ 🔸 *OnBeforeInit(data) - 【可选重写】数据预处理 ║
║ • 时机:在 DoInit(AutoBindField、InitScreenAdaption)和 OnInit 之前调用 ║
║ • 用途:解析传入数据,设置初始状态,准备UI显示内容 ║
║ • 示例:解析OpenData,设置默认选中项,预加载必要资源 ║
║ • 注意:通常不需要调用 base.OnBeforeInit() ║
║ ║
║ 🔸 *OnInit() - 【常用重写】UI初始化 ║
║ • 时机:在 DoInit(基础初始化)之后,窗口显示之前调用 ║
║ • 用途:初始化UI组件,绑定事件,设置默认值 ║
║ • 示例:按钮绑定,列表初始化,默认文本设置 ║
║ • 注意:不需要调用 base.OnInit() ║
║ ║
║ 🔸 *OnShow(data) - 【常用重写】显示后业务逻辑 ║
║ • 时机:窗口显示之后调用 ║
║ • 用途:处理显示后的业务逻辑,刷新数据,播放动画 ║
║ • 示例:刷新列表数据,开始倒计时,播放入场动画 ║
║ • 注意:通常不需要调用 base.OnShow(data) ║
║ ║
║ 🔸 *OnUpdate(dt) - 【按需重写】每帧更新 ║
║ • 时机:每帧调用(仅在窗口激活且已创建时) ║
║ • 用途:处理需要持续更新的逻辑 ║
║ • 示例:倒计时更新,进度条刷新,实时数据显示 ║
║ • 注意:避免在此进行重度计算,影响性能 ║
║ ║
║ 🔸 *OnDataRefresh(data) - 【按需重写】数据刷新 ║
║ • 时机:调用 RefreshWithData 时触发 ║
║ • 用途:更新已显示窗口的内容,不重新初始化 ║
║ • 示例:更新商品列表,刷新玩家信息,切换显示内容 ║
║ • 注意:通常不需要调用 base.OnDataRefresh(data) ║
║ ║
║ 🔸 *OnHideWindow() - 【按需重写】隐藏时清理 ║
║ • 时机:窗口隐藏时调用 ║
║ • 用途:暂停逻辑,保存状态,停止动画 ║
║ • 示例:暂停倒计时,保存输入内容,停止音效 ║
║ • 注意:建议调用 base.OnHideWindow() 确保事件发送 ║
║ ║
║ 🔸 *OnRelease() - 【重要重写】资源释放 ║
║ • 时机:窗口销毁时调用 ║
║ • 用途:释放资源,取消订阅,清理引用 ║
║ • 示例:取消事件监听,释放Tween,清理对象池 ║
║ • 注意:必须调用 base.OnRelease() 确保基类资源释放 ║
║ ║
║ 【其他说明】 ║
║ • AutoBindField: 自动绑定字段,通常由代码生成工具处理,手动重写较少 ║
║ • RefreshWithData: 数据刷新函数,窗口已初始化时调用OnDataRefresh,未初始化时报错 ║
║ • Init: 初始化函数,确保窗口只初始化一次,包含OnBeforeInit、DoInit、OnInit的完整流程 ║
║ • ShowWindow: 显示窗口的公共接口,内部调用私有的Show函数执行实际显示逻辑 ║
║ • 架构特点: Init和Show分离,支持窗口预初始化,然后在需要时显示 ║
║ • 重写虚函数时,根据需要决定是否调用 base.OnXxx(),具体见上述说明 ║
║ ║
╚══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════╝
*/
#region Private Helper Methods
///
/// 尝试绑定背景关闭按钮
///
private void _TryBindBgClose()
{
var trans = transform.Find("BgClose");
if (trans)
{
var btn = trans.GetComponent