using System;
|
using System.Collections.Generic;
|
using UnityEngine;
|
using Cysharp.Threading.Tasks;
|
|
/// <summary>
|
/// US3: 异步资源守卫，延迟特效/Spine播放直到资源就绪。
|
/// 在资源未加载完成时排队播放请求，加载完成后按顺序执行。
|
/// </summary>
|
public class AsyncResourceGuard
|
{
|
private bool _isReady;
|
private readonly Queue<Action> _pendingActions = new Queue<Action>();
|
private UniTaskCompletionSource _readySource;
|
|
public bool IsReady => _isReady;
|
|
public AsyncResourceGuard()
|
{
|
_isReady = false;
|
_readySource = new UniTaskCompletionSource();
|
}
|
|
/// <summary>
|
/// 标记资源已就绪，执行所有排队的动作。
|
/// </summary>
|
public void SetReady()
|
{
|
if (_isReady) return;
|
|
_isReady = true;
|
_readySource.TrySetResult();
|
|
// 执行所有排队的动作
|
while (_pendingActions.Count > 0)
|
{
|
var action = _pendingActions.Dequeue();
|
try
|
{
|
action?.Invoke();
|
}
|
catch (Exception e)
|
{
|
Debug.LogException(e);
|
}
|
}
|
}
|
|
/// <summary>
|
/// 排队一个动作：如果资源已就绪则立即执行，否则排队等待。
|
/// </summary>
|
public void EnqueueOrExecute(Action action)
|
{
|
if (action == null) return;
|
|
if (_isReady)
|
{
|
action.Invoke();
|
}
|
else
|
{
|
_pendingActions.Enqueue(action);
|
}
|
}
|
|
/// <summary>
|
/// 等待资源就绪（可用于 await）。
|
/// </summary>
|
public UniTask WaitUntilReady()
|
{
|
if (_isReady) return UniTask.CompletedTask;
|
return _readySource.Task;
|
}
|
|
/// <summary>
|
/// 重置状态，用于资源重新加载。
|
/// </summary>
|
public void Reset()
|
{
|
_isReady = false;
|
_pendingActions.Clear();
|
_readySource = new UniTaskCompletionSource();
|
}
|
|
/// <summary>
|
/// 清空所有排队的动作（如场景切换时）。
|
/// </summary>
|
public void ClearPending()
|
{
|
_pendingActions.Clear();
|
}
|
}
|
|
/// <summary>
|
/// US3: MonoBehaviour 版异步资源守卫，可挂载到需要等待资源的 GameObject 上。
|
/// 典型用法：在 BattleField 上管理特效/Spine 的延迟播放。
|
/// </summary>
|
public class AsyncResourceGuardBehaviour : MonoBehaviour
|
{
|
private readonly AsyncResourceGuard _guard = new AsyncResourceGuard();
|
|
public bool IsReady => _guard.IsReady;
|
|
/// <summary>
|
/// 标记资源就绪，触发所有排队播放。
|
/// </summary>
|
public void SetReady()
|
{
|
_guard.SetReady();
|
}
|
|
/// <summary>
|
/// 提交一个播放请求：资源就绪则立即执行，否则排队。
|
/// </summary>
|
public void Play(Action playAction)
|
{
|
if (this == null) return;
|
_guard.EnqueueOrExecute(playAction);
|
}
|
|
/// <summary>
|
/// 等待资源就绪。
|
/// </summary>
|
public UniTask WaitUntilReady()
|
{
|
return _guard.WaitUntilReady();
|
}
|
|
/// <summary>
|
/// 重置守卫状态。
|
/// </summary>
|
public void ResetGuard()
|
{
|
_guard.Reset();
|
}
|
|
private void OnDestroy()
|
{
|
_guard.ClearPending();
|
}
|
}
|
