UnityRuntimeNodeEditor 使用教程

1、项目介绍

UnityRuntimeNodeEditor 是一个在 Unity 运行时环境中使用的节点编辑器，基于 Unity UI 构建。与大多数使用 Unity 编辑器来创建节点编辑器的项目不同，UnityRuntimeNodeEditor 的目标是在运行时环境中实现节点编辑功能。它支持通过 API 创建图表、加载和保存图表、事件通知、平移和缩放等功能。此外，它还兼容旧版和新版输入系统，适用于 Unity 2021.3.3f1 及以上版本。

2、项目快速启动

安装

1. 克隆项目仓库到本地：

   git clone https://github.com/cemuka/UnityRuntimeNodeEditor.git
   

2. 打开 Unity 项目，将 UnityRuntimeNodeEditor 文件夹导入到你的项目中。

基本使用

以下是一个简单的示例，展示如何在运行时创建一个节点编辑器并启动它。

using UnityEngine;

public class ApplicationStartup : MonoBehaviour
{
    public RectTransform editorHolder;
    public ExampleNodeEditor editor;

    private void Start()
    {
        var graph = editor.CreateGraph<NodeGraph>(editorHolder);
        editor.StartEditor(graph);
    }
}

创建自定义节点

你可以通过继承 Node 类来创建自定义节点，并在编辑器中使用它们。

using TMPro;

public class MyAwesomeNode : Node
{
    public TMP_InputField valueField;
    public SocketOutput outputSocket;
    public SocketInput inputSocket;

    public override void Setup()
    {
        Register(outputSocket);
        Register(inputSocket);
        SetHeader("float");
    }

    public override void OnSerialize(Serializer serializer)
    {
        serializer.Add("floatValue", valueField.text);
    }

    public override void OnDeserialize(Serializer serializer)
    {
        var value = serializer.Get("floatValue");
        valueField.SetTextWithoutNotify(value);
    }
}

3、应用案例和最佳实践

应用案例

UnityRuntimeNodeEditor 可以用于创建各种类型的节点图，例如：

• 游戏逻辑编辑器：用于创建和管理游戏中的逻辑流程。
• 数据流图：用于可视化数据处理流程。
• AI 行为树编辑器：用于设计和编辑 AI 行为树。

最佳实践

1. 模块化设计：尽量将节点设计为独立的模块，便于复用和扩展。
2. 事件驱动：利用事件系统来处理节点之间的交互，提高代码的可维护性。
3. 性能优化：在处理大量节点时，注意优化图表的渲染和更新逻辑，避免性能瓶颈。

4、典型生态项目

UnityRuntimeNodeEditor 可以与其他 Unity 插件和工具结合使用，例如：

• Odin Inspector：用于增强 Unity 编辑器的功能，提供更强大的属性编辑和序列化功能。
• NodeCanvas：一个强大的行为树和状态机编辑器，可以与 UnityRuntimeNodeEditor 结合使用，创建更复杂的 AI 系统。
• Graphy：一个性能监控工具，可以帮助你监控和优化节点编辑器的性能。

通过结合这些工具，你可以构建出功能更强大、更灵活的节点编辑器应用。