// ============================================================================
|
// IResourcePreloader.cs — 资源预加载服务接口
|
// Feature: 001-async-resource-loading
|
// ============================================================================
|
|
using System;
|
using Cysharp.Threading.Tasks;
|
|
namespace ProjSG.Resource
|
{
|
/// <summary>
|
/// 资源预加载服务接口。
|
/// 按场景/流程组织批量资源预加载。
|
/// </summary>
|
public interface IResourcePreloader
|
{
|
/// <summary>
|
/// 注册预加载配置。
|
/// </summary>
|
void RegisterConfig(PreloadConfig config);
|
|
/// <summary>
|
/// 执行指定预加载配置。
|
/// </summary>
|
UniTask PreloadAsync(string configName, IProgress<float> progress = null);
|
|
/// <summary>
|
/// 按资源标签批量预加载。
|
/// </summary>
|
UniTask PreloadByTagAsync(string tag, IProgress<float> progress = null);
|
|
/// <summary>
|
/// 卸载指定配置的资源（常驻配置不卸载）。
|
/// </summary>
|
void UnloadConfig(string configName);
|
|
/// <summary>
|
/// 检查配置是否已预加载完成。
|
/// </summary>
|
bool IsConfigLoaded(string configName);
|
}
|
|
/// <summary>
|
/// 预加载配置数据。
|
/// </summary>
|
public class PreloadConfig
|
{
|
/// <summary>配置名称</summary>
|
public string ConfigName { get; set; }
|
|
/// <summary>需要预加载的资源地址列表</summary>
|
public string[] Locations { get; set; }
|
|
/// <summary>需要预加载的资源标签列表</summary>
|
public string[] Tags { get; set; }
|
|
/// <summary>是否为常驻资源（不允许卸载）</summary>
|
public bool IsPermanent { get; set; }
|
}
|
}
|
