2025-04-22 17:16:40 +08:00

209 lines
6.3 KiB
C#

using System;
namespace TEngine
{
/// <summary>
/// 流程管理器。
/// </summary>
internal sealed class ProcedureModule : Module, IProcedureModule
{
private IFsmModule _fsmModule;
private IFsm<IProcedureModule> _procedureFsm;
/// <summary>
/// 初始化流程管理器的新实例。
/// </summary>
public ProcedureModule()
{
_fsmModule = null;
_procedureFsm = null;
}
/// <summary>
/// 获取游戏框架模块优先级。
/// </summary>
/// <remarks>优先级较高的模块会优先轮询,并且关闭操作会后进行。</remarks>
public override int Priority => -2;
/// <summary>
/// 获取当前流程。
/// </summary>
public ProcedureBase CurrentProcedure
{
get
{
if (_procedureFsm == null)
{
throw new GameFrameworkException("You must initialize procedure first.");
}
return (ProcedureBase)_procedureFsm.CurrentState;
}
}
/// <summary>
/// 获取当前流程持续时间。
/// </summary>
public float CurrentProcedureTime
{
get
{
if (_procedureFsm == null)
{
throw new GameFrameworkException("You must initialize procedure first.");
}
return _procedureFsm.CurrentStateTime;
}
}
public override void OnInit()
{
}
/// <summary>
/// 关闭并清理流程管理器。
/// </summary>
public override void Shutdown()
{
if (_fsmModule != null)
{
if (_procedureFsm != null)
{
_fsmModule.DestroyFsm(_procedureFsm);
_procedureFsm = null;
}
_fsmModule = null;
}
}
/// <summary>
/// 初始化流程管理器。
/// </summary>
/// <param name="fsmModule">有限状态机管理器。</param>
/// <param name="procedures">流程管理器包含的流程。</param>
public void Initialize(IFsmModule fsmModule, params ProcedureBase[] procedures)
{
if (fsmModule == null)
{
throw new GameFrameworkException("FSM manager is invalid.");
}
_fsmModule = fsmModule;
_procedureFsm = _fsmModule.CreateFsm(this, procedures);
}
/// <summary>
/// 开始流程。
/// </summary>
/// <typeparam name="T">要开始的流程类型。</typeparam>
public void StartProcedure<T>() where T : ProcedureBase
{
if (_procedureFsm == null)
{
throw new GameFrameworkException("You must initialize procedure first.");
}
_procedureFsm.Start<T>();
}
/// <summary>
/// 开始流程。
/// </summary>
/// <param name="procedureType">要开始的流程类型。</param>
public void StartProcedure(Type procedureType)
{
if (_procedureFsm == null)
{
throw new GameFrameworkException("You must initialize procedure first.");
}
_procedureFsm.Start(procedureType);
}
/// <summary>
/// 是否存在流程。
/// </summary>
/// <typeparam name="T">要检查的流程类型。</typeparam>
/// <returns>是否存在流程。</returns>
public bool HasProcedure<T>() where T : ProcedureBase
{
if (_procedureFsm == null)
{
throw new GameFrameworkException("You must initialize procedure first.");
}
return _procedureFsm.HasState<T>();
}
/// <summary>
/// 是否存在流程。
/// </summary>
/// <param name="procedureType">要检查的流程类型。</param>
/// <returns>是否存在流程。</returns>
public bool HasProcedure(Type procedureType)
{
if (_procedureFsm == null)
{
throw new GameFrameworkException("You must initialize procedure first.");
}
return _procedureFsm.HasState(procedureType);
}
/// <summary>
/// 获取流程。
/// </summary>
/// <typeparam name="T">要获取的流程类型。</typeparam>
/// <returns>要获取的流程。</returns>
public ProcedureBase GetProcedure<T>() where T : ProcedureBase
{
if (_procedureFsm == null)
{
throw new GameFrameworkException("You must initialize procedure first.");
}
return _procedureFsm.GetState<T>();
}
/// <summary>
/// 获取流程。
/// </summary>
/// <param name="procedureType">要获取的流程类型。</param>
/// <returns>要获取的流程。</returns>
public ProcedureBase GetProcedure(Type procedureType)
{
if (_procedureFsm == null)
{
throw new GameFrameworkException("You must initialize procedure first.");
}
return (ProcedureBase)_procedureFsm.GetState(procedureType);
}
/// <summary>
/// 重启流程。
/// <remarks>默认使用第一个流程作为启动流程。</remarks>
/// </summary>
/// <param name="procedures">新的的流程。</param>
/// <returns>是否重启成功。</returns>
/// <exception cref="GameFrameworkException">重启异常。</exception>
public bool RestartProcedure(params ProcedureBase[] procedures)
{
if (procedures == null || procedures.Length <= 0)
{
throw new GameFrameworkException("RestartProcedure Failed procedures is invalid.");
}
if (!_fsmModule.DestroyFsm<IProcedureModule>())
{
return false;
}
Initialize(_fsmModule, procedures);
StartProcedure(procedures[0].GetType());
return true;
}
}
}