AlphaaeGameStudio/TEngine
1
0
Fork 0
mirror of https://github.com/Alex-Rachel/TEngine.git synced 2025-08-07 16:45:10 +00:00
Code Issues Packages Projects Releases Wiki Activity

更新资源模块接口

Browse Source 
更新资源模块接口
This commit is contained in:
ALEXTANG
2023-10-16 13:03:41 +08:00
parent 8d2b4200d6
commit 5e70e7972e
3 changed files with 113 additions and 43 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
UnityProject/Assets/TEngine/Runtime/Modules/ResourceModule/IResourceManager.cs
View File

@@ -61,7 +61,7 @@ namespace TEngine
/// 获取或设置异步系统参数，每帧执行消耗的最大时间切片（单位：毫秒）。
/// </summary>
long Milliseconds { get; set; }
/// <summary>
/// 资源缓存表容量。
/// </summary>
@@ -164,18 +164,20 @@ namespace TEngine
/// 同步加载资源。
/// </summary>
/// <param name="location">资源的定位地址。</param>
/// <param name="needInstance">是否需要实例化。</param>
/// <typeparam name="T">要加载资源的类型。</typeparam>
/// <returns>资源实例。</returns>
T LoadAsset<T>(string location) where T : Object;
T LoadAsset<T>(string location, bool needInstance) where T : Object;
/// <summary>
/// 同步加载资源。
/// </summary>
/// <param name="location">资源的定位地址。</param>
/// <param name="parent">父节点位置。</param>
/// <param name="needInstance">是否需要实例化。</param>
/// <typeparam name="T">要加载资源的类型。</typeparam>
/// <returns>资源实例。</returns>
T LoadAsset<T>(string location, Transform parent) where T : Object;
T LoadAsset<T>(string location, Transform parent, bool needInstance) where T : Object;
/// <summary>
/// 同步加载资源。
@@ -239,7 +241,7 @@ namespace TEngine
/// <typeparam name="T">资源类型。</typeparam>
/// <returns>资源对象集合。</returns>
UniTask<List<T>> LoadAssetsByTagAsync<T>(string assetTag) where T : UnityEngine.Object;
/// <summary>
/// 异步加载场景。
/// </summary>
@@ -248,7 +250,7 @@ namespace TEngine
/// <param name="suspendLoad">加载完毕时是否主动挂起。</param>
/// <param name="priority">优先级。</param>
/// <returns>异步加载场景句柄。</returns>
SceneOperationHandle LoadSceneAsync(string location, LoadSceneMode sceneMode = LoadSceneMode.Single, bool suspendLoad = false,int priority = 100);
SceneOperationHandle LoadSceneAsync(string location, LoadSceneMode sceneMode = LoadSceneMode.Single, bool suspendLoad = false, int priority = 100);
/// <summary>
/// 异步加载场景.
@@ -266,9 +268,10 @@ namespace TEngine
/// </summary>
/// <param name="location">资源定位地址。</param>
/// <param name="cancellationToken">取消操作Token。</param>
/// <param name="needInstance">是否需要实例化。</param>
/// <typeparam name="T">要加载资源的类型。</typeparam>
/// <returns>异步资源实例。</returns>
UniTask<T> LoadAssetAsync<T>(string location, CancellationToken cancellationToken = default) where T : Object;
UniTask<T> LoadAssetAsync<T>(string location, CancellationToken cancellationToken = default, bool needInstance = true) where T : Object;
/// <summary>
/// 异步加载游戏物体。

114
UnityProject/Assets/TEngine/Runtime/Modules/ResourceModule/ResourceManager.cs
View File

@@ -90,6 +90,7 @@ namespace TEngine
/// 资源缓存表容量。
/// </summary>
public int ARCTableCapacity { get; set; }
#endregion
#region 生命周期
@@ -101,10 +102,43 @@ namespace TEngine
internal override void Shutdown()
{
ReleaseAllHandle();
YooAssets.Destroy();
ResourcePool.Destroy();
}
private void ReleaseAllHandle()
{
var iter = _releaseMaps.Values.GetEnumerator();
while (iter.MoveNext())
{
AssetOperationHandle handle = iter.Current;
if (handle != null)
{
handle.Dispose();
handle = null;
}
}
iter.Dispose();
_releaseMaps.Clear();
iter = _operationHandlesMaps.Values.GetEnumerator();
while (iter.MoveNext())
{
AssetOperationHandle handle = iter.Current;
if (handle != null)
{
handle.Dispose();
handle = null;
}
}
iter.Dispose();
_operationHandlesMaps.Clear();
_arcCacheTable = new ArcCacheTable<string, AssetOperationHandle>(ARCTableCapacity, OnAddAsset, OnRemoveAsset);
}
#endregion
#region 设置接口
@@ -140,23 +174,32 @@ namespace TEngine
#endregion
private Dictionary<string, AssetOperationHandle> _releaseMaps;
private Dictionary<string, AssetOperationHandle> _operationHandlesMaps;
private ArcCacheTable<string, AssetOperationHandle> _arcCacheTable;
private void OnAddAsset(string location,AssetOperationHandle handle)
private void OnAddAsset(string location, AssetOperationHandle handle)
{
_operationHandlesMaps[location] = handle;
if (_releaseMaps.ContainsKey(location))
{
_releaseMaps.Remove(location);
}
}
private void OnRemoveAsset(string location,AssetOperationHandle handle)
private void OnRemoveAsset(string location, AssetOperationHandle handle)
{
if (_operationHandlesMaps.ContainsKey(location))
{
_operationHandlesMaps.Remove(location);
}
_releaseMaps[location] = handle;
GameModule.Resource.UnloadUnusedAssets(performGCCollect:false);
GameModule.Resource.UnloadUnusedAssets(performGCCollect: false);
}
/// <summary>
/// 从缓存中获取同步资源句柄。
/// </summary>
@@ -168,16 +211,17 @@ namespace TEngine
AssetOperationHandle handle = null;
// 尝试从从ARC缓存表取出对象。
handle = _arcCacheTable.GetCache(location);
if (handle == null)
{
handle = YooAssets.LoadAssetSync<T>(location);
}
// 对象推入ARC缓存表。
_arcCacheTable.PutCache(location, handle);
return handle;
}
/// <summary>
/// 从缓存中获取异步资源句柄。
/// </summary>
@@ -189,16 +233,17 @@ namespace TEngine
AssetOperationHandle handle = null;
// 尝试从从ARC缓存表取出对象。
handle = _arcCacheTable.GetCache(location);
if (handle == null)
{
handle = YooAssets.LoadAssetAsync<T>(location);
}
// 对象推入ARC缓存表。
_arcCacheTable.PutCache(location, handle);
return handle;
}
/// <summary>
/// 初始化资源模块。
/// </summary>
@@ -219,8 +264,9 @@ namespace TEngine
}
ResourcePool.Initialize(GameModule.Get<ResourceModule>().gameObject);
_releaseMaps ??= new Dictionary<string, AssetOperationHandle>(ARCTableCapacity);
_operationHandlesMaps ??= new Dictionary<string, AssetOperationHandle>(ARCTableCapacity);
_arcCacheTable ??= new ArcCacheTable<string, AssetOperationHandle>(ARCTableCapacity, OnAddAsset, OnRemoveAsset);
}
@@ -277,7 +323,7 @@ namespace TEngine
createParameters.RemoteServices = new RemoteServices();
initializationOperation = package.InitializeAsync(createParameters);
}
// WebGL运行模式
if (playMode == EPlayMode.WebPlayMode)
{
@@ -317,9 +363,10 @@ namespace TEngine
handle = null;
}
}
iter.Dispose();
_releaseMaps.Clear();
if (DefaultPackage == null)
{
throw new GameFrameworkException("Package is invalid.");
@@ -451,9 +498,10 @@ namespace TEngine
/// 同步加载资源。
/// </summary>
/// <param name="location">资源的定位地址。</param>
/// <param name="needInstance">是否需要实例化。</param>
/// <typeparam name="T">要加载资源的类型。</typeparam>
/// <returns>资源实例。</returns>
public T LoadAsset<T>(string location) where T : Object
public T LoadAsset<T>(string location, bool needInstance = true) where T : Object
{
if (string.IsNullOrEmpty(location))
{
@@ -465,8 +513,13 @@ namespace TEngine
if (typeof(T) == typeof(GameObject))
{
GameObject ret = handle.InstantiateSync();
return ret as T;
if (needInstance)
{
GameObject ret = handle.InstantiateSync();
return ret as T;
}
return handle.AssetObject as T;
}
else
{
@@ -480,9 +533,10 @@ namespace TEngine
/// </summary>
/// <param name="location">资源的定位地址。</param>
/// <param name="parent">父节点位置。</param>
/// <param name="needInstance">是否需要实例化。</param>
/// <typeparam name="T">要加载资源的类型。</typeparam>
/// <returns>资源实例。</returns>
public T LoadAsset<T>(string location, Transform parent) where T : Object
public T LoadAsset<T>(string location, Transform parent, bool needInstance = true) where T : Object
{
if (string.IsNullOrEmpty(location))
{
@@ -494,8 +548,13 @@ namespace TEngine
if (typeof(T) == typeof(GameObject))
{
GameObject ret = handle.InstantiateSync(parent);
return ret as T;
if (needInstance)
{
GameObject ret = handle.InstantiateSync();
return ret as T;
}
return handle.AssetObject as T;
}
else
{
@@ -542,7 +601,7 @@ namespace TEngine
public T LoadAsset<T>(string location, Transform parent, out AssetOperationHandle handle) where T : Object
{
handle = GetHandleSync<T>(location);
if (string.IsNullOrEmpty(location))
{
Log.Error("Asset name is invalid.");
@@ -610,14 +669,14 @@ namespace TEngine
{
return YooAssets.LoadSubAssetsSync(assetInfo);
}
/// <summary>
/// 通过Tag加载资源对象集合。
/// </summary>
/// <param name="assetTag">资源标识。</param>
/// <typeparam name="T">资源类型。</typeparam>
/// <returns>资源对象集合。</returns>
public async UniTask<List<T>>LoadAssetsByTagAsync<T>(string assetTag) where T: UnityEngine.Object
public async UniTask<List<T>> LoadAssetsByTagAsync<T>(string assetTag) where T : UnityEngine.Object
{
LoadAssetsByTagOperation<T> operation = new LoadAssetsByTagOperation<T>(assetTag);
YooAssets.StartOperation(operation);
@@ -661,8 +720,9 @@ namespace TEngine
/// </summary>
/// <param name="location">要加载的实例名称。</param>
/// <param name="cancellationToken">取消操作Token。</param>
/// <param name="needInstance">是否需要实例化。</param>
/// <returns>资源实实例。</returns>
public async UniTask<T> LoadAssetAsync<T>(string location, CancellationToken cancellationToken = default) where T : Object
public async UniTask<T> LoadAssetAsync<T>(string location, CancellationToken cancellationToken = default, bool needInstance = true) where T : Object
{
AssetOperationHandle handle = LoadAssetAsyncHandle<T>(location);
@@ -675,9 +735,13 @@ namespace TEngine
if (typeof(T) == typeof(GameObject))
{
GameObject ret = handle.InstantiateSync();
if (needInstance)
{
GameObject ret = handle.InstantiateSync();
return ret as T;
}
return ret as T;
return handle.AssetObject as T;
}
else
{

27
UnityProject/Assets/TEngine/Runtime/Modules/ResourceModule/ResourceModule.cs
View File

@@ -102,7 +102,7 @@ namespace TEngine
/// 资源缓存表容量。
/// </summary>
public int adaptiveReplacementCacheCapacity = 32;
private IResourceManager m_ResourceManager;
private AsyncOperation m_AsyncOperation = null;
private bool m_ForceUnloadUnusedAssets = false;
@@ -302,7 +302,7 @@ namespace TEngine
{
// YooAssets.ClearSandbox();
}
/// <summary>
/// 卸载资源。
/// </summary>
@@ -311,7 +311,7 @@ namespace TEngine
{
m_ResourceManager.UnloadAsset(asset);
}
/// <summary>
/// 预订执行释放未被使用的资源。
/// </summary>
@@ -343,7 +343,7 @@ namespace TEngine
m_LastUnloadUnusedAssetsOperationElapseSeconds += GameTime.unscaledDeltaTime;
if (m_AsyncOperation == null &&
(m_ForceUnloadUnusedAssets ||
m_LastUnloadUnusedAssetsOperationElapseSeconds >= maxUnloadUnusedAssetsInterval ||
m_LastUnloadUnusedAssetsOperationElapseSeconds >= maxUnloadUnusedAssetsInterval ||
m_PreorderUnloadUnusedAssets && m_LastUnloadUnusedAssetsOperationElapseSeconds >= minUnloadUnusedAssetsInterval))
{
Log.Info("Unload unused assets...");
@@ -448,11 +448,12 @@ namespace TEngine
/// 同步加载资源。
/// </summary>
/// <param name="location">资源的定位地址。</param>
/// <param name="needInstance">是否需要实例化。</param>
/// <typeparam name="T">要加载资源的类型。</typeparam>
/// <returns>资源实例。</returns>
public T LoadAsset<T>(string location) where T : UnityEngine.Object
public T LoadAsset<T>(string location, bool needInstance = true) where T : UnityEngine.Object
{
return m_ResourceManager.LoadAsset<T>(location);
return m_ResourceManager.LoadAsset<T>(location, needInstance);
}
/// <summary>
@@ -460,11 +461,12 @@ namespace TEngine
/// </summary>
/// <param name="location">资源的定位地址。</param>
/// <param name="parent">父节点位置。</param>
/// <param name="needInstance">是否需要实例化。</param>
/// <typeparam name="T">要加载资源的类型。</typeparam>
/// <returns>资源实例。</returns>
public T LoadAsset<T>(string location, Transform parent) where T : UnityEngine.Object
public T LoadAsset<T>(string location, Transform parent, bool needInstance = true) where T : UnityEngine.Object
{
return m_ResourceManager.LoadAsset<T>(location, parent);
return m_ResourceManager.LoadAsset<T>(location, parent, needInstance);
}
/// <summary>
@@ -563,14 +565,14 @@ namespace TEngine
return m_ResourceManager.LoadSubAssetsSync(assetInfo);
}
/// <summary>
/// 通过Tag加载资源对象集合。
/// </summary>
/// <param name="assetTag">资源标识。</param>
/// <typeparam name="T">资源类型。</typeparam>
/// <returns>资源对象集合。</returns>
public async UniTask<List<T>>LoadAssetsByTagAsync<T>(string assetTag) where T: UnityEngine.Object
public async UniTask<List<T>> LoadAssetsByTagAsync<T>(string assetTag) where T : UnityEngine.Object
{
return await m_ResourceManager.LoadAssetsByTagAsync<T>(assetTag);
}
@@ -608,11 +610,12 @@ namespace TEngine
/// </summary>
/// <param name="location">资源的定位地址。</param>
/// <param name="cancellationToken">取消操作Token。</param>
/// <param name="needInstance">是否需要实例化。</param>
/// <typeparam name="T">要加载资源的类型。</typeparam>
/// <returns>异步资源实例。</returns>
public async UniTask<T> LoadAssetAsync<T>(string location, CancellationToken cancellationToken = default) where T : UnityEngine.Object
public async UniTask<T> LoadAssetAsync<T>(string location, CancellationToken cancellationToken = default, bool needInstance = true) where T : UnityEngine.Object
{
return await m_ResourceManager.LoadAssetAsync<T>(location, cancellationToken);
return await m_ResourceManager.LoadAssetAsync<T>(location, cancellationToken, needInstance);
}
/// <summary>