参考 FairyGUI 控制器实现的通用性状态控制器，支持任意子状态扩展。适用于 UI 状态切换、角色状态管理、场景状态控制等场景。
- 支持任意类型的状态数据（泛型设计）
- 支持布尔逻辑组合（And/Or）
- 支持状态间自动链接切换
- 编辑器实时预览
- 支持 CodeBind 代码生成
主控制器组件，挂载在 GameObject 上，管理所有状态数据。
可选择状态基类，用于根据状态名切换不同的数据。
// 示例：根据状态切换图片
public class StateImageForSprite : BaseSelectableState<Sprite>
{
[SerializeField] private Image m_Image;
protected override void OnStateInit() { }
protected override void OnStateChanged(Sprite stateData)
{
m_Image.sprite = stateData;
}
}布尔逻辑状态基类，支持 None、And、Or 三种逻辑类型。
// 示例：根据布尔结果控制 GameObject 激活状态
public class StateGameObjectForActive : BaseBooleanLogicState
{
[SerializeField] private GameObject m_Target;
protected override void OnStateInit() { }
protected override void OnStateChanged(bool logicResult)
{
m_Target.SetActive(logicResult);
}
}// 获取控制器
StateControllerMono controller = GetComponent<StateControllerMono>();
// 通过名称设置状态
controller.SetSelectedName("DataName", "StateName");
// 通过索引设置状态
controller.SetSelectedIndex("DataName", 0);
// 获取当前状态
string currentName = controller.GetSelectedName("DataName");
int currentIndex = controller.GetSelectedIndex("DataName");
// 获取所有状态名
string[] stateNames = controller.GetStateNames("DataName");// 获取数据对象
StateControllerData data = controller.GetData("DataName");
// 设置状态
data.SelectedName = "StateName";
data.SelectedIndex = 0;
// 监听状态变化
data.OnSelectedNameChanged += (name) => Debug.Log($"State changed to: {name}");
data.OnSelectedIndexChanged += (index) => Debug.Log($"Index changed to: {index}");点击 Inspector 中的 Apply 按钮可实时预览状态效果。
| 类名 | 功能 |
|---|---|
| StateGameObjectForActive | 控制 GameObject 激活状态 |
| StateImageForSprite | 切换 Image 的 Sprite |
| StateImageForSpriteColor | 切换 Image 的 Sprite 和颜色 |
| StateRectTransformForAnchoredPosition | 控制 RectTransform 位置 |
| StateTextForText | 切换文本内容 |
如果安装了 CodeBind，添加宏定义 STATE_CONTROLLER_CODE_BIND 即可在绑定代码时生成状态数据相关代码。
通过 Unity Package Manager 安装：
- 打开 Window > Package Manager
- 点击 "+" 按钮，选择 "Add package from git URL..."
- 输入：
https://github.com/XuToWei/StateController.git
- Unity 2019.4+
- Odin Inspector（收费插件，请自行购买安装）
MIT License