mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-03-23 03:04:29 +08:00
65d56d0696
- 将场景路由基类从同步改为异步实现，支持场景栈管理 - 添加场景行为接口定义及相关的进入参数接口 - 实现场景的压入、弹出、替换和清空等栈操作功能 - 迁移UI资源注册接口到资产模块下 - 移除缓存淘汰策略枚举并更新UI切换阶段命名空间引用 - 优化日志记录器创建方式和统一命名空间规范
64 lines
2.4 KiB
C#
64 lines
2.4 KiB
C#
// Copyright (c) 2026 GeWuYou
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
namespace GFramework.Game.Abstractions.scene;
|
|
|
|
/// <summary>
|
|
/// 场景接口，定义了场景生命周期管理的核心方法。
|
|
/// 实现此接口的类需要处理场景从加载到卸载的完整生命周期。
|
|
/// </summary>
|
|
public interface IScene
|
|
{
|
|
/// <summary>
|
|
/// 异步加载场景所需资源。
|
|
/// 在场景正式进入前调用，负责预加载场景所需的各类资源。
|
|
/// </summary>
|
|
/// <param name="param">场景进入参数，可能包含初始化数据或上下文信息。</param>
|
|
/// <returns>表示加载操作完成的ValueTask。</returns>
|
|
ValueTask OnLoadAsync(ISceneEnterParam? param);
|
|
|
|
/// <summary>
|
|
/// 异步处理场景正式进入逻辑。
|
|
/// 在资源加载完成后调用，启动场景的主要运行逻辑。
|
|
/// </summary>
|
|
/// <returns>表示进入操作完成的ValueTask。</returns>
|
|
ValueTask OnEnterAsync();
|
|
|
|
/// <summary>
|
|
/// 异步处理场景暂停逻辑。
|
|
/// 当场景被其他场景覆盖或失去焦点时调用。
|
|
/// </summary>
|
|
/// <returns>表示暂停操作完成的ValueTask。</returns>
|
|
ValueTask OnPauseAsync();
|
|
|
|
/// <summary>
|
|
/// 异步处理场景恢复逻辑。
|
|
/// 当场景重新获得焦点或从暂停状态恢复时调用。
|
|
/// </summary>
|
|
/// <returns>表示恢复操作完成的ValueTask。</returns>
|
|
ValueTask OnResumeAsync();
|
|
|
|
/// <summary>
|
|
/// 异步处理场景退出逻辑。
|
|
/// 在场景即将被替换或关闭时调用，执行清理工作。
|
|
/// </summary>
|
|
/// <returns>表示退出操作完成的ValueTask。</returns>
|
|
ValueTask OnExitAsync();
|
|
|
|
/// <summary>
|
|
/// 异步卸载场景资源。
|
|
/// 在场景完全退出后调用，释放占用的内存和资源。
|
|
/// </summary>
|
|
/// <returns>表示卸载操作完成的ValueTask。</returns>
|
|
ValueTask OnUnloadAsync();
|
|
} |