GFramework/GFramework.Game.Abstractions/assets/AssetCatalog.cs

namespace GFramework.Game.Abstractions.assets;

/// <summary>
///     资源目录类，用于定义和管理游戏中的场景和资源标识符
/// </summary>
public static class AssetCatalog
{
    /// <summary>
    ///     资源标识符接口，定义了资源路径的访问接口
    /// </summary>
    public interface IAssetId
    {
        /// <summary>
        ///     获取资源的路径
        /// </summary>
        string Path { get; }
    }

    /// <summary>
    ///     资源目录映射结构体，用于存储资源目录的键值对映射关系
    /// </summary>
    /// <param name="Key">资源目录的键</param>
    /// <param name="Id">资源标识符</param>
    public readonly record struct AssetCatalogMapping(string Key, IAssetId Id);


    /// <summary>
    ///     场景页面资源标识符结构体，用于标识场景页面资源
    /// </summary>
    /// <param name="Path">场景页面资源路径</param>
    public readonly record struct ScenePageId(string Path) : IAssetId;


    /// <summary>
    ///     场景单元资源标识符结构体，用于标识场景单元资源
    /// </summary>
    /// <param name="Path">场景单元资源路径</param>
    public readonly record struct SceneUnitId(string Path) : IAssetId;

    /// <summary>
    ///     通用资源标识符结构体，实现IAssetId接口
    /// </summary>
    /// <param name="Path">资源路径</param>
    public readonly record struct AssetId(string Path) : IAssetId;
}