当前位置： 首页 > article >正文

Unity扩展编辑器使用整理（一）

article 2025/2/6 8:20:47

准备工作

在Unity工程中新建Editor文件夹存放编辑器脚本，

Unity中其他的特殊文件夹可以参考官方文档链接，如下：

Unity - 手册：保留文件夹名称参考 (unity3d.com)

一、菜单栏扩展

1.增加顶部菜单栏选项

使用MenuItem，包含三个参数，官方文档描述如下：

代码：

   [MenuItem("Tool/test")]
   public static void test()
   {
       Debug.Log("test.....");
   }

结果：

2.增加右键Create菜单栏选项

使用MenuItem,ItemName需要从"Assets"开始，比如需要在Create菜单栏加一个testFolder的函数

代码：

   [MenuItem("Assets/Create/testFolder")]
   public static void test2()
   {
       Debug.Log("test2....");
   }

结果：

更多Unity支持的编辑器特性，可查看官方API，地址：

CustomGridBrushAttribute - Unity 脚本 API

3.使用快捷键 

官方文档的MenuItem中使用快捷键描述如下：

官方文档链接：

Unity - 脚本 API：MenuItem (unity3d.com)

热键文本之前必须有一个空格字符：

代码：

    [MenuItem("Tool/testHotKey0 _g")]
    public static void testHotKey0()
    {
        Debug.Log("testHotKeytestHotKey0..........");
    }

结果：

 

如果不需要特殊的修饰键组合，则可以在下划线后给出键：

代码：

   [MenuItem("Tool/testHotKey #g")]
   public static void testHotKey()
   {
       Debug.Log("testHotKeytestHotKey..........");
   }

   [MenuItem("Tool/testHotKey1 #&g")]
   public static void testHotKey1()
   {
       Debug.Log("testHotKeytestHotKey1..........");
   }

结果：

支持将一些特殊的键盘键（LEFT， RIGHT， UP， DOWN， F1 ..F12、HOME、END、PGUP、PGDN、INS、DEL、BACKSPACE、TAB 和 SPACE）作为热键：

代码：

 [MenuItem("Tool/testHotKey2 #LEFT")]
 public static void testHotKey2()
 {
      Debug.Log("testHotKeytestHotKey2..........");
 }

结果：

4.弹出一个提示窗口

使用EditorUtility.DisplayDialog显示窗口，第一个参数是弹窗名，第二个参数是提示内容，第三个参数是按钮名字

代码：

    [MenuItem("Tool/testDialog")]
    public static void DisplayDialog()
    {
        EditorUtility.DisplayDialog("Tips", "Hello World", "Completely");
    }

结果：

 

二、自定义窗口扩展

1.创建自定义窗口

自定义窗口需要创建的窗口脚本继承子EditorWindow，然后在OnGUI中渲染窗口的实际内容，
新建一个TestWindow脚本，代码如下：

public class TestWindow : EditorWindow
{
    private void OnGUI()
    {
        //渲染窗口的实际内容
    }
}

编写打开窗口的函数，代码如下：

[MenuItem("CustomWindow/ShowTestWin")]
public static void ShowWindow()
{
   //显示窗口实例
   //EditorWindow.GetWindow(typeof(TestWindow));
   //显示窗口按照自定位置和大小，比如(0,0)点，宽600，长800
   EditorWindow.GetWindowWithRect<TestWindow>(new Rect(new Vector2(0,0),new Vector2(600,800)));
}

结果：

EditorWindow类中的方法：

官方文档描述如下：

更多方法可参考：Unity - 脚本 API：EditorWindow (unity3d.com)

代码：

public class TestWindow : EditorWindow
{
    [MenuItem("CustomWindow/ShowTestWin")]
    public static void ShowWindow()
    {
        //显示窗口实例
        EditorWindow.GetWindow(typeof(TestWindow));
        //显示窗口按照自定位置和大小，比如(0,0)点，宽600，长800
        EditorWindow.GetWindowWithRect<TestWindow>(new Rect(new Vector2(0,0),new Vector2(600,800)));
    }

    private void OnEnable()
    {
        //在加载脚本或者启用对象时调用
        Debug.Log("OnEnable");
    }

    private void CreateGUI()
    {
        //如果Editor未更新，则生成图形用户界面
        Debug.Log("CreateGUI");
    }

    private void Update()
    {
        //每帧调用一次以更新脚本的逻辑
        Debug.Log("Updaete");
    }

    private void OnDisable()
    {
        //当脚本被禁用或者对象被销毁以完成和清理资源时调用
        Debug.Log("OnDisable");
    }

    private void OnGUI()
    {
        //每帧多次调用，用于渲染和处理GUI事件
        //渲染窗口的实际内容
        Debug.Log("OnGUI");
    }
}

结果：

2.增加窗口内容

1.使用EditorGUI类

1.actionKey


使用代码：

  private void OnGUI()
  {
      //渲染窗口的实际内容
      if (EditorGUI.actionKey)
      {
          //是否按住了平台相关的“action”修改键?(只读),该键在 macOS 上为 Command，在 Windows 上为 Control
          Debug.Log("按下了actionKey");
      }
  }

结果：

2.indentLevel

 使用代码：

    private void OnGUI()
    {
        //渲染窗口的实际内容
        //使用indentLevel缩进文本
        EditorGUI.indentLevel++;
        EditorGUILayout.LabelField("P1:");
        EditorGUI.indentLevel++;
        EditorGUILayout.LabelField("P2:");
        EditorGUI.indentLevel++;
        EditorGUILayout.LabelField("P3:");
        EditorGUI.indentLevel--;
        EditorGUI.indentLevel--;
        EditorGUILayout.LabelField("P1:");
        EditorGUI.indentLevel++;
        EditorGUILayout.LabelField("P2:");
    }

结果：

3.showMixedValue

具体作用可以看下面两篇文章

EditorGUI.showMixedValue 什么都不做？- Unity 引擎 - Unity 讨论

Unity - 脚本 API：EditorGUI.showMixedValue (unity3d.com)

就是可以让在 GUI 中以非标准方式表示值，同时支持多对象编辑，也就是通过设置此值为true，让枚举值没有在面板选择值时显示为

代码：

    private void OnGUI()
    {
        //渲染窗口的实际内容
        EditorGUI.showMixedValue = true;
        // 将isFast布尔值转换为enum值
        SpeedOption speedOptionEnumValue = SpeedOption.Fast;
        // 在下拉菜单中显示枚举值：
        speedOptionEnumValue = (SpeedOption)EditorGUILayout.EnumPopup("Speed", speedOptionEnumValue);
        // 将showMixedValue设置为false，这样它就不会影响以下控件（如果有的话）：
        EditorGUI.showMixedValue = false;
    }

结果：

4.BeginChangeCheck，EndChangeCheck

EndChangeCheck返回值如下

代码：

float value = 0; 
private void OnGUI()
{
     //渲染窗口的实际内容
     EditorGUI.BeginChangeCheck();
     value = EditorGUILayout.Slider(value, 0, 1);
     if (EditorGUI.EndChangeCheck())
     {
         this.ShowTips("变量检查成功！");
     }
}

结果：

 

5.BeginDisabledGroup，EndDisabledGroup

 BeginChangeCheck参数如下：

 使用这两个API可以禁用执行在其中间的多个组件。

代码：

    private void OnGUI()
    {
        //渲染窗口的实际内容
        EditorGUI.BeginDisabledGroup(false);
        EditorGUI.TextField(new Rect(new Vector2(0,150),new Vector2(300,50)), "TestDisabledGroup");
        EditorGUI.DropdownButton(new Rect(new Vector2(300, 150), new Vector2(100, 50)),this.titleContent,FocusType.Keyboard);
        EditorGUI.EndDisabledGroup();

    }

结果：

当BeginDisabledGroup传入值为false时,

当BeginDisabledGroup传入值为true时,

6.BeginFoldoutHeaderGroup，EndFoldoutHeaderGroup

BeginFoldoutHeaderGroup参数如下：

代码：

结果：

7.BeginProperty，EndProperty
8.文本字段（Field）

以下API都是在面板中创建一个字段显示，故放在一起整理：

BoundsField

BoundsIntField

ColorField

CurveField

EnumFlagsField

DoubleField

FloatField

IntField

LabelField

LayerField

GradientField

LongField

MaskField

MultiFloatField

MultiIntField

MultiPropertyField

ObjectField

PasswordField

PropertyField

RectField

RectIntField

TagField

TextField

Vector2Field

Vector2IntField

Vector3Field

Vector3IntField

Vector4Field

使用代码：

9.DelayedDoubleField，DelayedFloatField，DelayedIntField，DelayedTextField
10.CanCacheInspectorGUI
11.DrawPreviewTexture
12.DrawRect
13.DrawTextureAlpha
14.DropdownButton
15.DropShadowLabel
16.EnumPopup,IntPopup,Popup
17.FocusTextInControl
18.Foldout
19.GetPropertyHeight
20.HandlePrefixLabel
21.HelpBox
22.InspectorTitlebar
23.IntSlider
24.LinkButton
25.MinMaxSlider
26.PrefixLabel
27.ProgressBar
28.SelectableLabel
29.Slider
30.TextArea
31.Toggle,ToggleLeft

2.使用EditorGUILayout类

与EditorGUI不相同的API部分：

相同的部分：

三、自定义Inspectors面板扩展

1.建立一个脚本面板扩展的编辑器脚本

2.EditorGUILayout与EditorGUI部分与上面的使用相同

未完待续。。。

参考：

《Extending Unity with Editor Scripting》

扩展编辑器 - Unity 手册 (unity3d.com)

EditorWindow - Unity 脚本 API

Unity - 手动：使用 C# 脚本创建自定义 Editor 窗口 (unity3d.com)


http://www.kler.cn/a/533434.html

相关文章：

  • (dpdk f-stack)-堆栈溢出-野指针-内存泄露（问题定位）
  • 【ArcGIS_Python】使用arcpy脚本将shape数据转换为三维白膜数据
  • Java/Kotlin HashMap 等集合引发 ConcurrentModificationException
  • pycharm（2）
  • AI大模型（二）基于Deepseek搭建本地可视化交互UI
  • 84-《金银花》
  • Vue Router如何配置404页面
  • Ansible在多台服务器上运行python脚本
  • PostgreSQL rownum实现方法
  • Spark--算子执行原理
  • 莱佛士设计之旅：四城巡讲，启发未来设计之路
  • spring security与gateway结合进行网关鉴权和授权
  • GAN（生成对抗网络，Generative Adversarial Network）
  • 【Java】MyBatis动态SQL
  • PostgreSQL / PostGIS：创建地理要素
  • 网络安全--边界安全
  • AI赋能生态学暨“ChatGPT+”多技术融合在生态系统服务中的实践技术应用与论文撰写
  • ArrayList和Araay数组区别
  • AI安全最佳实践：AI云原生开发安全评估矩阵（上）
  • Vue模板语法与常用指令深度解析
  • 【算法】【二分】acwing 算法基础 789. 数的范围
  • 力扣1022. 从根到叶的二进制数之和（二叉树的遍历思想解决）
  • 485网关数据收发测试
  • 防火墙安全策略作业
  • if let 与 let else 的使用指南
  • lmk内存压力测试工具mem-pressure源码剖析