【Unity小知识】Editor编写常用方法汇总
汇总一些Unity Editor开发的常用方法和实现方式，会持续更新。
添加自定义菜单栏方法
using UnityEngine;
using UnityEditor;
public class EditorTools : EditorWindow
{
[MenuItem("EditorTools/自定义的编辑器方法")]
public static void CustomEditroFunction()
{
Debug.Log("Here is your code...");
}
}
如图一，添加自定义的菜单栏需要使用UnityEditor的命名空间，我们自定义的EditorTools类需要继承EditorWindow类。然后就是定义菜单栏点击后所执行的具体函数CustomEditroFunction，这里需要注意的是函数需要是静态函数，需要增加static关键字。MenuItem方法则是定义菜单栏的路径，菜单栏路径可以采用中文。图二则是自定义菜单栏的效果。
EditorWindow类文档连接：https://docs.unity3d.com/cn/2022.2/ScriptReference/EditorWindow.html
添加Hierarchy自定义菜单栏方法
using UnityEngine;
using UnityEditor;
public class HierarchyEditorTools : EditorWindow
{
[MenuItem("GameObject/自定义的编辑器方法", priority = 0)]
public static void CustomEditroFunction()
{
Debug.Log("Here is your code...");
}
}
在Hierarchy窗口右键菜单添加自定义菜单栏需要MenuItem方法的路径以GameObject起始，如上面示例代码。添加方法后除了Hierarchy会显示自定义的菜单栏，在顶部GameObject下也会显示自定义的菜单栏。
MenuItem文档连接：https://docs.unity3d.com/cn/2022.2/ScriptReference/MenuItem.html
添加Inspector中脚本自定义方法
using UnityEngine;
using UnityEngine.UI;
using UnityEditor;
[CustomEditor(typeof(Text), true)]
public class TextEditor : Editor
{
public override void OnInspectorGUI()
{
DrawDefaultInspector();
CustomTextFunction();
}
private void CustomTextFunction()
{
if (GUILayout.Button("清空内容"))
{
Text text = (Text)target;
text.text = string.Empty;
}
}
}
这里我们为Unity原有的Text脚本增加功能按钮，添加自定义功能。
如图一，首先还是需要使用UnityEditor命名空间，自定义类TextEditor继承自Editor。通过覆写OnInspectorGUI方法实现Inspector中脚本的绘制，DrawDefaultInspector为绘制默认视图。接下来CustomTextFunction则是我们自定义的部分，通过GUILayout.Button("清空内容")方法绘制自定义按钮，if语句中则是点击按钮后的自定义功能，这里示例的则是清除了Text内容。实际效果如图二。
在示例代码中需要注意的是，[CustomEditor(typeof(Text), true)]指定了Inspector自定义脚本的类型，会为指定的自定义脚本添加功能。基类Editor包含成员target，通过target可以获取指定的脚本对象。
Editor类文档连接： https://docs.unity3d.com/cn/2022.2/ScriptReference/Editor.html
添加自定义窗口方法
using UnityEngine;
using UnityEditor;
public class CustomEditorWindow :EditorWindow
{
[MenuItem("EditorTools/CustomEditorWindow")]
public static void ShowCustomEditorWindow()
{
EditorWindow.GetWindowWithRect<CustomEditorWindow>(new Rect(0, 0, 300, 150), false, "CustomEditorWindow");
}
private void OnGUI()
{
}
}
如图一，这里我们创建了一个最简单的自定义窗口，自定义窗口类需要继承EditorWindow类，通过 EditorWindow.GetWindowWithRect 或者 EditorWindow.GetWindow 方法创建窗口。
EditorWindow.GetWindowWithRect 为创建固定尺寸的窗口。
EditorWindow.GetWindow 为创建动态尺寸的窗口，可以通过拖动右下角拉伸窗口尺寸。
OnGUI 方法用于绘制窗口内的各种组件，下一节将单独讲解。
EditorWindow类文档连接：https://docs.unity3d.com/cn/2022.2/ScriptReference/EditorWindow.html
GUILayout的常用方法
using UnityEngine;
using UnityEditor;
public class CustomEditorWindow : EditorWindow
{
private string textField = "";
private string textArea = "";
[MenuItem("EditorTools/CustomEditorWindow")]
public static void ShowCustomEditorWindow()
{
EditorWindow.GetWindowWithRect<CustomEditorWindow>(new Rect(0, 0, 300, 150), false, "CustomEditorWindow");
}
private void OnGUI()
{
GUILayout.Label("Hello World");
textField = GUILayout.TextField(textField);
textArea = GUILayout.TextArea(textArea);
if (GUILayout.Button("点击按钮"))
{
Debug.LogError("按钮点击响应成功");
}
}
}
这里我们来介绍一下GUILayout常用的方法。
GUILayout.Label：用于创建文本内容，支持多行显示，使用n或者@“”等方式可以多行显示。
GUILayout.TextField：创建一个可编辑的单行文本框，到达最大长度后输入内容会超框。如图一需要创建一个成员变量存储输入内容。
GUILayout.TextArea：创建一个可编辑的多行文本框，到达最大长度后文本框会换行。同样输入内容需要成员变量存储。
GUILayout.Button：创建一个单击按钮，需要用if语句判断点击。按钮支持图片形式，可传入一个Texture类对象创建图片按钮。
未完待续。
关于GUILayout更多细节可以查阅官方文档。
GUILayout类文档连接：https://docs.unity3d.com/cn/2022.2/ScriptReference/GUILayout.html