root/plugin-library
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

状态机工具1.0.1

Browse Source
This commit is contained in:
Han
2025-03-31 11:23:20 +08:00
parent 815435ac6f
commit 0b0892545a
21 changed files with 460 additions and 476 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
Assets/03.FiniteStateMachine/README.md
View File

@@ -1 +1 @@
# 代码检查工具
# 状态机工具

8
Assets/03.FiniteStateMachine/RunTime/Abstract.meta Normal file
View File

@@ -0,0 +1,8 @@
fileFormatVersion: 2
guid: a4c1b2e6dc7695646be9fd2a98863529
folderAsset: yes
DefaultImporter:
externalObjects: {}
userData:
assetBundleName:
assetBundleVariant:

87
Assets/03.FiniteStateMachine/RunTime/Abstract/IState.cs Normal file
View File

@@ -0,0 +1,87 @@
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
namespace Stary.Evo.FiniteStateMachine
{
public interface IState
{
public FSMController Machine { get; set; }
public void OnEnter();
public void OnExit();
public void Update();
public void FixedUpdate();
public void OnInit();
public void OnDestory();
}
public abstract class AbstractState : IState
{
public FSMController Machine { get; set; }
public abstract void OnEnter();
public abstract void OnExit();
public abstract void Update();
public abstract void FixedUpdate();
public abstract void OnInit();
public abstract void OnDestory();
}
/// <summary>
/// 状态中具体行为：
/// （OnInitAction：初始化）
/// （OnEnterAction：进入）
/// （UpdateAction：循环）
/// （FixedUpdateAction：后循环）
/// （OnExitAction：离开）
/// （OnDestoryAction：销毁）
/// </summary>
public struct StateDateAction
{
public System.Action OnEnterAction;
public System.Action OnExitAction;
public System.Action UpdateAction;
public System.Action FixedUpdateAction;
public System.Action OnInitAction;
public System.Action OnDestoryAction;
}
/// <summary>
/// 单个状态
/// </summary>
public class SingleState : AbstractState
{
public StateDateAction stateDate;
public bool IsRunning;
public override void FixedUpdate()
{
stateDate.FixedUpdateAction?.Invoke();
}
public override void OnDestory()
{
stateDate.OnDestoryAction?.Invoke();
}
public override void OnEnter()
{
stateDate.OnEnterAction?.Invoke();
}
public override void OnExit()
{
stateDate.OnExitAction?.Invoke();
}
public override void OnInit()
{
stateDate.OnInitAction?.Invoke();
}
public override void Update()
{
stateDate.UpdateAction?.Invoke();
}
}
}

0
Assets/03.FiniteStateMachine/RunTime/IState.cs.meta → Assets/03.FiniteStateMachine/RunTime/Abstract/IState.cs.meta
View File

8
Assets/03.FiniteStateMachine/RunTime/Base.meta Normal file
View File

@@ -0,0 +1,8 @@
fileFormatVersion: 2
guid: 482775b04d27d6644bc8d880e135e6ac
folderAsset: yes
DefaultImporter:
externalObjects: {}
userData:
assetBundleName:
assetBundleVariant:

135
Assets/03.FiniteStateMachine/RunTime/Base/FSMController.cs Normal file
View File

@@ -0,0 +1,135 @@
using System;
using System.Collections;
using System.Collections.Generic;
using System.Linq;
using UnityEngine;
namespace Stary.Evo.FiniteStateMachine
{
public class FSMController : MonoBehaviour
{
private Dictionary<Type, SingleState> states = new Dictionary<Type, SingleState>();
public void AddState(SingleState state)
{
var type = state.GetType();
if (!states.ContainsKey(type))
{
// 添加时初始化
state.Machine = this;
state.OnInit();
states.Add(type, state);
}
else
{
Debug.LogError("该FSMController中已经添加过该状态！！！");
}
}
/* //public bool IsRunning<T>() where T : SingleState => IsRunning(typeof(T));
//public void Enter<T>() where T : SingleState => Enter(typeof(T));
//public void Exit<T>() where T : SingleState => Exit(typeof(T));
//public void ForceEnter<T>() where T : SingleState => ForceEnter(typeof(T));*/
public bool IsRunning(Type type)
{
if (states.ContainsKey(type))
{
if (states[type].IsRunning) return true;
}
else
{
Debug.LogError("状态已不存在！！！");
}
return false;
}
public void Enter(Type type)
{
if (states.ContainsKey(type))
{
if (IsRunning(type))
{
Debug.LogError("该状态正在进行，无法再次进入！！！");
return;
}
ForceEnter(type);
}
else
{
Debug.LogError("状态已不存在！！！");
}
}
public void ForceEnter(Type type)
{
if (states.ContainsKey(type))
{
SingleState state = states[type];
state.OnEnter();
state.IsRunning = true;
}
else
{
Debug.LogError("状态已不存在！！！");
}
}
public void Exit(Type type)
{
if (states.TryGetValue(type, out SingleState state))
{
if (!IsRunning(type)) return;
state.IsRunning = false;
state.OnExit();
}
else
{
Debug.LogError("状态已不存在！！！");
}
}
public void ExitAll()
{
foreach (var state in states)
{
if (state.Value.IsRunning) Exit(state.Key);
}
}
private void Update()
{
foreach (var state in states)
{
if (state.Value.IsRunning) state.Value.Update();
}
}
private void FixedUpdate()
{
foreach (var state in states)
{
if (state.Value.IsRunning) state.Value.FixedUpdate();
}
}
private void OnDestroy()
{
ExitAll();
// 遍历字典中的每个状态
foreach (var key in states.Keys.ToList())
{
states[key].OnDestory();
// 将每个值设置为 null，释放引用
states[key] = null;
}
// 清空字典
states.Clear();
}
}
}

0
Assets/03.FiniteStateMachine/RunTime/FSMController.cs.meta → Assets/03.FiniteStateMachine/RunTime/Base/FSMController.cs.meta
View File

132
Assets/03.FiniteStateMachine/RunTime/FSMController.cs
View File

@@ -1,132 +0,0 @@
using System;
using System.Collections;
using System.Collections.Generic;
using System.Linq;
using UnityEngine;
public class FSMController : MonoBehaviour
{
private Dictionary<Type, SingleState> states = new Dictionary<Type, SingleState>();
public void AddState(SingleState state)
{
var type = state.GetType();
if (!states.ContainsKey(type))
{
// 添加时初始化
state.Machine = this;
state.OnInit();
states.Add(type, state);
}
else
{
Debug.LogError("该FSMController中已经添加过该状态！！！");
}
}
/* //public bool IsRunning<T>() where T : SingleState => IsRunning(typeof(T));
//public void Enter<T>() where T : SingleState => Enter(typeof(T));
//public void Exit<T>() where T : SingleState => Exit(typeof(T));
//public void ForceEnter<T>() where T : SingleState => ForceEnter(typeof(T));*/
public bool IsRunning(Type type)
{
if (states.ContainsKey(type))
{
if (states[type].IsRunning) return true;
}
else
{
Debug.LogError("状态已不存在！！！");
}
return false;
}
public void Enter(Type type)
{
if (states.ContainsKey(type))
{
if (IsRunning(type))
{
Debug.LogError("该状态正在进行，无法再次进入！！！");
return;
}
ForceEnter(type);
}
else
{
Debug.LogError("状态已不存在！！！");
}
}
public void ForceEnter(Type type)
{
if (states.ContainsKey(type))
{
SingleState state = states[type];
state.OnEnter();
state.IsRunning = true;
}
else
{
Debug.LogError("状态已不存在！！！");
}
}
public void Exit(Type type)
{
if (states.TryGetValue(type, out SingleState state))
{
if (!IsRunning(type)) return;
state.IsRunning = false;
state.OnExit();
}
else
{
Debug.LogError("状态已不存在！！！");
}
}
public void ExitAll()
{
foreach (var state in states)
{
if (state.Value.IsRunning) Exit(state.Key);
}
}
private void Update()
{
foreach (var state in states)
{
if (state.Value.IsRunning) state.Value.Update();
}
}
private void FixedUpdate()
{
foreach (var state in states)
{
if (state.Value.IsRunning) state.Value.FixedUpdate();
}
}
private void OnDestroy()
{
ExitAll();
// 遍历字典中的每个状态
foreach (var key in states.Keys.ToList())
{
states[key].OnDestory();
// 将每个值设置为 null，释放引用
states[key] = null;
}
// 清空字典
states.Clear();
}
}

46
Assets/03.FiniteStateMachine/RunTime/FSMInitialize.cs
View File

@@ -1,46 +0,0 @@
using System.Collections;
using System.Collections.Generic;
using System.Linq;
using UnityEngine;
using UnityEngine.SceneManagement;
public static class FSMInitialize
{
/// <summary>
/// 状态机初始化
/// </summary>
/// <param name="targetScene">指定场景</param>
/// <returns></returns>
public static FSMManager Init(Scene targetScene)
{
GameObject targetObject = targetScene.GetRootGameObjects().FirstOrDefault(go => go.name == "FSMManger");
FSMManager fSMManager;
if (targetObject == null)
{
targetObject = new GameObject("FSMManger");
SceneManager.MoveGameObjectToScene(targetObject, targetScene);
fSMManager = new FSMManager();
fSMManager.FSMMangerObject = targetObject;
void OnSceneUnloaded(Scene scene)
{
// 当场景卸载时释放缓存
if (scene.name == targetScene.name)
{
GameObject.Destroy(targetObject);
fSMManager = null;
}
}
SceneManager.sceneUnloaded += OnSceneUnloaded;
return fSMManager;
}
else
{
Debug.LogError("场景: "+targetScene.name + "已经初始化过FSM状态机！！！");
return null;
}
}
}

146
Assets/03.FiniteStateMachine/RunTime/FSMManager.cs
View File

@@ -1,146 +0,0 @@
using System;
using System.Collections.Generic;
using UnityEngine;
public class FSMManager
{
public GameObject FSMMangerObject;
private Dictionary<int, FSMController> controllers = new Dictionary<int, FSMController>();
private Dictionary<int, SingleState> states = new Dictionary<int, SingleState>();
private int nextControllerId = 0;
private int nextStateId = 0;
/// <summary>
/// 创建FSMController
/// </summary>
/// <returns>返回创建的FSMController的识别Int值</returns>
public int CreateFSMController()
{
if(FSMMangerObject == null)
{
Debug.LogError("FSM状态机还未初始化！！！");
return -1;
}
else
{
int id = nextControllerId++;
GameObject newController = new GameObject("FSMController" + id);
newController.transform.SetParent(FSMMangerObject.transform);
var controller = newController.AddComponent<FSMController>();
controllers[id] = controller;
return id;
}
}
/// <summary>
/// 销毁指定FSMController
/// </summary>
/// <param name="controllerId"></param>
public void DestroyFSMController(int controllerId)
{
if (controllers.TryGetValue(controllerId, out var controller))
{
GameObject.Destroy(controller.gameObject);
controllers.Remove(controllerId);
}
else
{
Debug.LogError("该Id的FSMController不存在或已被销毁！！！");
}
}
/// <summary>
/// 退出指定Controller中的所有状态
/// </summary>
/// <param name="controllerId"></param>
public void ExitAllStateInController(int controllerId)
{
if (controllers.TryGetValue(controllerId, out var controller))
{
controller.ExitAll();
}
else
{
Debug.LogError("该Id的FSMController不存在或已被销毁！！！");
}
}
/// <summary>
/// 创建状态
/// </summary>
/// <param name="controllerId">状态挂载的ControllerId</param>
/// <param name="stateDateAction">状态行为数据</param>
/// <returns></returns>
public int CreateState(int controllerId, StateDateAction stateDateAction)
{
if (controllers.TryGetValue(controllerId, out var controller))
{
// 创建state并将其添加到指定controller生命周期中
SingleState state = new SingleState();
state.stateDate = stateDateAction;
controller.AddState(state);
int id = nextStateId++;
states[id] = state;
return id;
}
else
{
Debug.LogError("该Id的FSMController不存在或已被销毁，状态初始化失败！！！");
return -1;
}
}
/// <summary>
/// 进入指定状态
/// </summary>
/// <param name="stateId"></param>
public void EnterState(int stateId)
{
if(states.TryGetValue(stateId, out var state))
{
state.Machine.Enter(state.GetType());
}
else
{
Debug.LogError("该Id的状态不存在！！！");
}
}
/// <summary>
/// 离开指定状态
/// </summary>
/// <param name="stateId"></param>
public void ExitState(int stateId)
{
if (states.TryGetValue(stateId, out var state))
{
state.Machine.Exit(state.GetType());
}
else
{
Debug.LogError("该Id的状态不存在！！！");
}
}
/// <summary>
/// 销毁指定状态
/// </summary>
/// <param name="stateId"></param>
public void DestroyState(int stateId)
{
if (states.TryGetValue(stateId, out var state))
{
states.Remove(stateId);
}
}
// 将状态添加到FSMController
public void AddStateToController(int controllerId, int stateId)
{
if (controllers.TryGetValue(controllerId, out var controller) && states.TryGetValue(stateId, out var state))
{
controller.AddState(state);
}
}
}

3
Assets/03.FiniteStateMachine/RunTime/FiniteStateMachine.RunTime.asmdef Normal file
View File

@@ -0,0 +1,3 @@
{
"name": "FiniteStateMachine.RunTime"
}

7
Assets/03.FiniteStateMachine/RunTime/FiniteStateMachine.RunTime.asmdef.meta Normal file
View File

@@ -0,0 +1,7 @@
fileFormatVersion: 2
guid: fd2529d4be47388488cf47fbdd0ee1bf
AssemblyDefinitionImporter:
externalObjects: {}
userData:
assetBundleName:
assetBundleVariant:

84
Assets/03.FiniteStateMachine/RunTime/IState.cs
View File

@@ -1,84 +0,0 @@
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
public interface IState
{
public FSMController Machine { get; set; }
public void OnEnter();
public void OnExit();
public void Update();
public void FixedUpdate();
public void OnInit();
public void OnDestory();
}
public abstract class AbstractState : IState
{
public FSMController Machine { get; set; }
public abstract void OnEnter();
public abstract void OnExit();
public abstract void Update();
public abstract void FixedUpdate();
public abstract void OnInit();
public abstract void OnDestory();
}
/// <summary>
/// 状态中具体行为：
/// （OnInitAction：初始化）
/// （OnEnterAction：进入）
/// （UpdateAction：循环）
/// （FixedUpdateAction：后循环）
/// （OnExitAction：离开）
/// （OnDestoryAction：销毁）
/// </summary>
public struct StateDateAction
{
public System.Action OnEnterAction;
public System.Action OnExitAction;
public System.Action UpdateAction;
public System.Action FixedUpdateAction;
public System.Action OnInitAction;
public System.Action OnDestoryAction;
}
/// <summary>
/// 单个状态
/// </summary>
public class SingleState : AbstractState
{
public StateDateAction stateDate;
public bool IsRunning;
public override void FixedUpdate()
{
stateDate.FixedUpdateAction?.Invoke();
}
public override void OnDestory()
{
stateDate.OnDestoryAction?.Invoke();
}
public override void OnEnter()
{
stateDate.OnEnterAction?.Invoke();
}
public override void OnExit()
{
stateDate.OnExitAction?.Invoke();
}
public override void OnInit()
{
stateDate.OnInitAction?.Invoke();
}
public override void Update()
{
stateDate.UpdateAction?.Invoke();
}
}

53
Assets/03.FiniteStateMachine/RunTime/PlayerFSMExample.cs
View File

@@ -1,53 +0,0 @@
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.SceneManagement;
public class PlayerFSMExample : MonoBehaviour
{
private int controllerId;
private int idleStateId;
private float timer = 0.0f;
private FSMManager fSMManager;
void Start()
{
fSMManager = FSMInitialize.Init(gameObject.scene);
controllerId = fSMManager.CreateFSMController();
StateDateAction stateDateAction = new StateDateAction()
{
OnEnterAction = () =>
{
Debug.Log("进入状态");
},
UpdateAction = () =>
{
timer += Time.deltaTime;
Debug.Log("当前时间：" + timer);
},
OnExitAction = () =>
{
Debug.Log("离开状态");
}
};
idleStateId = fSMManager.CreateState(controllerId, stateDateAction);
}
void Update()
{
// 按下空格键切换到Running状态
if (Input.GetKeyDown(KeyCode.A))
{
fSMManager.EnterState(idleStateId);
}
if (Input.GetKeyDown(KeyCode.D))
{
fSMManager.ExitState(idleStateId);
}
}
void OnDestroy()
{
}
}

11
Assets/03.FiniteStateMachine/RunTime/PlayerFSMExample.cs.meta
View File

@@ -1,11 +0,0 @@
fileFormatVersion: 2
guid: 0deab708fd53bb4428ef48220df57be7
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:

8
Assets/03.FiniteStateMachine/RunTime/Use.meta Normal file
View File

@@ -0,0 +1,8 @@
fileFormatVersion: 2
guid: bacf497398db3124994cae839e813842
folderAsset: yes
DefaultImporter:
externalObjects: {}
userData:
assetBundleName:
assetBundleVariant:

50
Assets/03.FiniteStateMachine/RunTime/Use/FSMInitialize.cs Normal file
View File

@@ -0,0 +1,50 @@
using System.Collections;
using System.Collections.Generic;
using System.Linq;
using UnityEngine;
using UnityEngine.SceneManagement;
namespace Stary.Evo.FiniteStateMachine
{
public static class FSMInitialize
{
/// <summary>
/// 状态机初始化
/// </summary>
/// <param name="targetScene">指定场景</param>
/// <returns></returns>
public static FSMManager Init(Scene targetScene)
{
GameObject targetObject = targetScene.GetRootGameObjects().FirstOrDefault(go => go.name == "FSMManger");
FSMManager fSMManager;
if (targetObject == null)
{
targetObject = new GameObject("FSMManger");
SceneManager.MoveGameObjectToScene(targetObject, targetScene);
fSMManager = new FSMManager();
fSMManager.FSMMangerObject = targetObject;
void OnSceneUnloaded(Scene scene)
{
// 当场景卸载时释放缓存
if (scene.name == targetScene.name)
{
GameObject.Destroy(targetObject);
fSMManager = null;
}
}
SceneManager.sceneUnloaded += OnSceneUnloaded;
return fSMManager;
}
else
{
Debug.LogError("场景: " + targetScene.name + "已经初始化过FSM状态机！！！");
return null;
}
}
}
}

0
Assets/03.FiniteStateMachine/RunTime/FSMInitialize.cs.meta → Assets/03.FiniteStateMachine/RunTime/Use/FSMInitialize.cs.meta
View File

150
Assets/03.FiniteStateMachine/RunTime/Use/FSMManager.cs Normal file
View File

@@ -0,0 +1,150 @@
using System;
using System.Collections.Generic;
using UnityEngine;
namespace Stary.Evo.FiniteStateMachine
{
public class FSMManager
{
public GameObject FSMMangerObject;
private Dictionary<int, FSMController> controllers = new Dictionary<int, FSMController>();
private Dictionary<int, SingleState> states = new Dictionary<int, SingleState>();
private int nextControllerId = 0;
private int nextStateId = 0;
/// <summary>
/// 创建FSMController
/// </summary>
/// <returns>返回创建的FSMController的识别Int值</returns>
public int CreateFSMController()
{
if (FSMMangerObject == null)
{
Debug.LogError("FSM状态机还未初始化！！！");
return -1;
}
else
{
int id = nextControllerId++;
GameObject newController = new GameObject("FSMController" + id);
newController.transform.SetParent(FSMMangerObject.transform);
var controller = newController.AddComponent<FSMController>();
controllers[id] = controller;
return id;
}
}
/// <summary>
/// 销毁指定FSMController
/// </summary>
/// <param name="controllerId"></param>
public void DestroyFSMController(int controllerId)
{
if (controllers.TryGetValue(controllerId, out var controller))
{
GameObject.Destroy(controller.gameObject);
controllers.Remove(controllerId);
}
else
{
Debug.LogError("该Id的FSMController不存在或已被销毁！！！");
}
}
/// <summary>
/// 退出指定Controller中的所有状态
/// </summary>
/// <param name="controllerId"></param>
public void ExitAllStateInController(int controllerId)
{
if (controllers.TryGetValue(controllerId, out var controller))
{
controller.ExitAll();
}
else
{
Debug.LogError("该Id的FSMController不存在或已被销毁！！！");
}
}
/// <summary>
/// 创建状态
/// </summary>
/// <param name="controllerId">状态挂载的ControllerId</param>
/// <param name="stateDateAction">状态行为数据</param>
/// <returns></returns>
public int CreateState(int controllerId, StateDateAction stateDateAction)
{
if (controllers.TryGetValue(controllerId, out var controller))
{
// 创建state并将其添加到指定controller生命周期中
SingleState state = new SingleState();
state.stateDate = stateDateAction;
controller.AddState(state);
int id = nextStateId++;
states[id] = state;
return id;
}
else
{
Debug.LogError("该Id的FSMController不存在或已被销毁，状态初始化失败！！！");
return -1;
}
}
/// <summary>
/// 进入指定状态
/// </summary>
/// <param name="stateId"></param>
public void EnterState(int stateId)
{
if (states.TryGetValue(stateId, out var state))
{
state.Machine.Enter(state.GetType());
}
else
{
Debug.LogError("该Id的状态不存在！！！");
}
}
/// <summary>
/// 离开指定状态
/// </summary>
/// <param name="stateId"></param>
public void ExitState(int stateId)
{
if (states.TryGetValue(stateId, out var state))
{
state.Machine.Exit(state.GetType());
}
else
{
Debug.LogError("该Id的状态不存在！！！");
}
}
/// <summary>
/// 销毁指定状态
/// </summary>
/// <param name="stateId"></param>
public void DestroyState(int stateId)
{
if (states.TryGetValue(stateId, out var state))
{
states.Remove(stateId);
}
}
// 将状态添加到FSMController
public void AddStateToController(int controllerId, int stateId)
{
if (controllers.TryGetValue(controllerId, out var controller) && states.TryGetValue(stateId, out var state))
{
controller.AddState(state);
}
}
}
}

0
Assets/03.FiniteStateMachine/RunTime/FSMManager.cs.meta → Assets/03.FiniteStateMachine/RunTime/Use/FSMManager.cs.meta
View File

6
Assets/03.FiniteStateMachine/package.json
View File

@@ -1,10 +1,10 @@
{
"name": "com.staryevo.finitestatemachine",
"version": "1.0.0",
"version": "1.0.1",
"displayName": "03.FiniteStateMachine",
"description": "状态机",
"description": "状态机工具",
"unity": "2021.3",
"unityRelease": "30f1",
"unityRelease": "23f1",
"keywords": [
"unity",
"scirpt"