mirror of
https://github.com/GeWuYou/GFramework.git
synced 2026-03-22 10:34:30 +08:00
7299126a18
- 将 AssetCatalog.cs、IAssetCatalogSystem.cs、IResourceFactorySystem.cs 和 ResourceFactory.cs 从 GFramework.Game 移至 GFramework.Game.Abstractions - 在 GFramework.Game 项目中添加对 GFramework.Game.Abstractions 的引用 - 更新 AbstractAssetCatalogSystem.cs 以使用新的命名空间引用 - 在 GFramework.Godot 项目中添加对 GFramework.Game.Abstractions 的引用 - 更新 ResourceLoadSystem.cs 以使用新的命名空间并修正命名空间声明 - 在解决方案文件中注册新的 GFramework.Game.Abstractions 项目 - 为 GFramework.Game.Abstractions 项目添加 Directory.Build.props 配置文件 - 在主项目文件中排除新抽象模块的编译和资源文件以避免重复包含
84 lines
3.0 KiB
C#
84 lines
3.0 KiB
C#
using System;
|
||
using System.Collections.Generic;
|
||
using GFramework.Core.Abstractions.system;
|
||
using GFramework.Game.Abstractions.assets;
|
||
|
||
namespace GFramework.Godot.Abstractions.assets;
|
||
|
||
/// <summary>
|
||
/// 资源加载系统接口，提供资源和场景的加载、实例化、预加载等功能
|
||
/// </summary>
|
||
public interface IResourceLoadSystem : ISystem
|
||
{
|
||
/// <summary>
|
||
/// 加载指定路径的资源
|
||
/// </summary>
|
||
/// <typeparam name="T">资源类型，必须继承自Resource</typeparam>
|
||
/// <param name="path">资源路径</param>
|
||
/// <returns>加载的资源实例</returns>
|
||
public T? LoadResource<T>(string path) where T : Resource;
|
||
|
||
/// <summary>
|
||
/// 获取场景加载器，用于延迟加载场景
|
||
/// </summary>
|
||
/// <param name="path">场景路径</param>
|
||
/// <returns>场景的延迟加载包装器</returns>
|
||
public Lazy<PackedScene> GetSceneLoader(string path);
|
||
|
||
/// <summary>
|
||
/// 创建指定路径场景的实例
|
||
/// </summary>
|
||
/// <typeparam name="T">节点类型，必须继承自Node</typeparam>
|
||
/// <param name="path">场景路径</param>
|
||
/// <returns>场景实例化的节点对象</returns>
|
||
public T? CreateInstance<T>(string path) where T : Node;
|
||
|
||
/// <summary>
|
||
/// 获取或注册游戏单位工厂函数
|
||
/// </summary>
|
||
/// <typeparam name="T">节点类型，必须继承自Node</typeparam>
|
||
/// <param name="id">场景资源标识符</param>
|
||
/// <returns>创建场景实例的工厂函数</returns>
|
||
Func<T> GetOrRegisterGameUnitFactory<T>(
|
||
AssetCatalog.SceneUnitId id
|
||
) where T : Node;
|
||
|
||
/// <summary>
|
||
/// 获取或注册模板资源工厂函数
|
||
/// </summary>
|
||
/// <typeparam name="T">节点类型，必须继承自Node</typeparam>
|
||
/// <param name="id">模板资源标识符</param>
|
||
/// <returns>创建模板实例的工厂函数</returns>
|
||
Func<T> GetOrRegisterTemplateFactory<T>(
|
||
AssetCatalog.ScenePageId id
|
||
) where T : Node;
|
||
|
||
/// <summary>
|
||
/// 获取或注册通用资产工厂函数
|
||
/// </summary>
|
||
/// <typeparam name="T">资源类型，必须继承自Resource</typeparam>
|
||
/// <param name="id">资产资源标识符</param>
|
||
/// <param name="duplicate">是否对原始资源进行复制操作，默认为false</param>
|
||
/// <returns>创建资产实例的工厂函数</returns>
|
||
Func<T> GetOrRegisterAssetFactory<T>(
|
||
AssetCatalog.AssetId id,
|
||
bool duplicate = false
|
||
) where T : Resource;
|
||
|
||
/// <summary>
|
||
/// 预加载指定路径的多个资源
|
||
/// </summary>
|
||
/// <param name="paths">需要预加载的资源路径集合</param>
|
||
public void Preload(IEnumerable<string> paths);
|
||
|
||
/// <summary>
|
||
/// 卸载指定路径的资源
|
||
/// </summary>
|
||
/// <param name="path">需要卸载的资源路径</param>
|
||
public void Unload(string path);
|
||
|
||
/// <summary>
|
||
/// 清除所有已加载的资源
|
||
/// </summary>
|
||
public void ClearAll();
|
||
} |