UnityEditor-Windows编辑器与Inspector编辑器

一、简介

以前一直以为Unity编辑器开发很复杂,很难。但是自学了一天之后,慢慢的将一些脚本用Editor来进行封装,发现在整体开发上会方便很多,很多数据、参数可以进行灵活查看以及屏蔽,所以特意做一个Editor的详细教程,分享给别人。

我将详细介绍Editor Windows(窗口)开发、Editor Inspector(属性窗口)开发、Editor Hierarchy(右键菜单)开发。

二、Windows窗口开发

先看效果图(关于读写Json的信息排版)
一个关于读写Json的窗口

  1. 创建一个Editor脚本
    在Editor文件夹下新建一个类(TestEditorWindows),该类集成EditorWindow,还需要引用UnityEditor命名空间。
    创建一个类
  2. 了解一些Windwos窗口开发的方法
    创建类完毕之后,在编写如下代码:
	//1.必须跟类型一样,这是窗口的名称
	TestEditorWindows()
    {
        this.titleContent = new GUIContent("测试编辑器窗口");
    }
    
    //2.这是在哪里创建窗口
	[MenuItem("Test/Test窗口")]
    static void CreateTestWindows()
    {
        EditorWindow.GetWindow(typeof(TestEditorWindows));
    }

在这里插入图片描述
在这里插入图片描述
目前窗口中什么都没有,因为我们还没开始写控件。
如果需要在窗口中绘制控件,则需要在OnGUI()中去编写相关代码,在此之前我们需要了解OnEnable()方法。

	//窗口启动时,会调用此方法
    private void OnEnable()
    {
        //OnEnable()方法是一个比较重要的方法,在一般的窗口绘制中,可在这里进行相关数据的初始化。
    }

    //实时绘制相关控件
    private void OnGUI()
    {
        //OnGUI()方法则是实时的进行控件绘制,窗口控件绘制也就在这里进行代码编写。
    }
  • 了解一些常用的控件了解一些常用的控件
    在编写想要的窗口时,需要了解常用的控件,这些控件都是我们非常常用的。值得注意的是不管是在Windows窗口开发还是Inspector窗口开发,常用的控件基本都在GUILayout和EditorGUILayout这两个类中,有些控件两者都可以,不过一般都会用EditorGUILayout,因情况而定……所以别在开发中,网上的资料中有时用GUILayout,有时又用EditorGUILayout。

下面将介绍常用的控件

  • GUILayout.BeginScrollView/GUILayout.EndScrollView

    GUILayout.BeginScrollView/GUILayout.EndScrollView这个控件是添加窗口滚动条的,也就是给你这个窗口添加水平和垂直滚动条。
    具体使用如下:

	Vector2 scrollPos = Vector2.zero; //当前滚动坐标
 	//实时绘制相关控件
    private void OnGUI()
    {
    	//参数一:滚动坐标
    	//参数二:窗口宽度(position.width)
    	//参数三:窗口高度(position.height)
    	//其中position是内置的参数。
        scrollPos = GUILayout.BeginScrollView(scrollPos, GUILayout.Width(position.width), GUILayout.Height(position.height));

        GUILayout.EndScrollView();
    }

备注:编写完毕之后,此时看窗口是没有滚动条的样式的,因为里面目前还没有任何的控件。

在介绍后面两个控件时,我们需要说明下,在Unity编辑器中,如果我们要对控件进行控件的布局,比如有些控件水平显示,有些垂直显示。那么就需要应用后面的这两个控件,不过在一些真正的项目开发或者一些公司中,他们都会基于这两个布局控件,进行在封装一层,以方便灵活使用。在程序UI界中,比如UGUI、GUI、以及一些非Unity的UI控件插件等,都基本上有这种类似的布局。

需要注意:这种布局控件,一般都是配对出现的,比如你用了GUILayout.BeginVertical()后,在后面你必须要有GUILayout.EndVertical()。否则窗口将绘制不出来并且提示错误提示。这点在编写复杂的窗口时,很重要,因为一不留神就出现错误。最好在编写代码的时候,将BeginVertical和EndVertical一起码出来,以便到时候去匹配。

  • GUILayout.BeginVertical/GUILayout.EndVertical
    该控件是垂直布局控件,也就是说在这个区域内的控件,都将垂直排列。
  • GUILayout.BeginHorizontal/GUILayout.EndHorizontal
    该控件是水平布局控件,在这个区域内的控件,都将水平排列。
		//水平布局控件
		GUILayout.BeginHorizontal();
		
        GUILayout.Label("水平信息");
        if (GUILayout.Button("水平按钮"))
        {

        }
        GUILayout.EndHorizontal();
		
		//空行(如果是在垂直布局内,就是垂直空50单位,反之如果在水平布局内,就水平空50单位)
		GUILayout.Space(50);
		
		//垂直布局控件
        GUILayout.BeginVertical();

        GUILayout.Label("垂直信息");
        if (GUILayout.Button("垂直按钮"))
        {

        }
        GUILayout.EndVertical();

在这里插入图片描述
在这里在来一个小技巧,给布局添加背景样式,以及定义宽高,这时候就可以显示窗口滚动条了。
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
备注:当窗口缩放到代码指定的控件宽高时,窗口会自动显示滚动条,当然前提是你在最开始前布局了GUILayout.BeginScrollView/GUILayout.EndScrollView

  • GUILayout.Button:按钮
    Button按钮这个控件应该不需要进行介绍了,当按下时,返回true。可在这里写自己的实现,同时可设置Button的宽高,利用GUILayout.Width和GUILayout.Height,也可以利用GUIContent给按钮添加提示,同时可利用GUIStyle给按钮添加样式。
		if (GUILayout.Button(new GUIContent("水平按钮","鼠标移入时,提示信息"),GUI.skin.button,GUILayout.Width(50),GUILayout.Height(21)))
        {
            //按下时的处理
        }
        
  • GUILayout.Box:Box区域
    Box控件就是文字框/图片框了,指定一块框,其实跟Button差不多,只不过不能进行点击而已。

  • EditorGUILayout.LabelField:文本信息
    LabelField控件,就是文本标签了,在这里可以书写自己的信息,没什么好介绍的。

  • GUILayout.HelpBox:帮助信息
    HelpBox类似LabelField标签,也是文字提示类的,但是它多了几个状态以及背景框,选择不同的状态显示不同的UI。

		//MessageType.Node:无
        //MessageType.Info:提示
        //MessageType.Warning:警告
        //MessageType.Error:错误
        //提示信息,用于提示警告、错误等
        EditorGUILayout.HelpBox("这是提示信息", MessageType.Error, true);

上述HeloBox在窗口的显示情况

  • TextArea:文本输入框
	info = GUILayout.TextArea(info, GUILayout.Width(500), GUILayout.Height(50));
	//在窗口中绘制一个文本输入框。
  • Toggle:单选框
    Toggle控件一般用于接收Bool参数,比如你有一个Bool值参数,需要在窗口中显示出来,那么用Toggle可帮你接收到这个Bool值信息,这个也不需要什么介绍。

  • Slider:进度条
    Slider控件,提供一个滑轮,指定最大值、最小值。那么可滑动来设置这些值,同时也可以手动设置,类似MonoBehaviour中的Range特性。

  • EditorGUILayout.EnumPopup:枚举框
    枚举控件也是在编写编辑器中,使用的比较多的,比如选择不同的枚举,绘制出来的控件都是不一样的,这种情况在我们写脚本的时候,可能要定义很多属性,然后在Inspector属性窗口中,一下子全部都列出来了,但是我们只想根据不同的状态,显示一部分需要的。枚举框、Toggle等控件就有用武之力了,我在编写编辑器时,经常会用到枚举或Toggle,让Inspector属性绘制出来的窗口变得简介明了,方便别人使用。

    如下图所示:
    这是我基于UGUI在往上封装一层的KGUI控件,这是其中的一个Toggle控件(提前说明下,后续的博客更新,我将详细的介绍我的KGUI控件,同时会详细讲解UGUI的内部一些知识,并且还会开源的哦,里面集成了类似Excel表格控件、背包、滚动条、Button、下拉框等,都是基于UGUI的RectTransform组件和Image组件,重新编写一套适合自己项目开发的控件集等等
    在这里插入图片描述

	//枚举类
	public enum TestType
    {
        A,
        B,
        C,
        D
    }
	//在方法外定义一个枚举对象
    private TestType testType = TestType.A;
    
	//下面的代码是在OnGUI下绘制的
	testType = (TestType)EditorGUILayout.EnumPopup(new GUIContent("枚举值:", "枚举的详细提示信息"), testType);
  • DropdownButton:下拉框
    DropdownButton可能大家不了解,也许会用不到,它的效果跟EnumPopup,不过EnumPopup是基于枚举类,序列化出来的,而DropdownButton是根据自定义添加子项。
	//外部String变量,用于接收下拉框值
	private string itemStr = "";
	
	//方法类的核心代码
	//其中new GUIContent(itemStr),用于接收当前选中的值
	if (EditorGUILayout.DropdownButton(new GUIContent(itemStr), FocusType.Keyboard))
    {
    	var alls = new string[4]{"A","B","C","D"};
    	GenericMenu menu = new GenericMenu(); //实例化一个菜单
    	//遍历字符串集合
        foreach (var all in alls)
         {
         		 if (string.IsNullOrEmpty(all)) continue;
         		 //添加子项
                 AddMenuItemForValue(menu, all);
         }
         menu.ShowAsContext();//绘制出菜单
   }
   
   //添加子项
   void AddMenuItemForValue(GenericMenu menu, string value)
   {
   		//添加子项的格式,itemStr.Equals(value)如果与目前相等的,就处于选中状态
   		menu.AddItem(new GUIContent(value), itemStr.Equals(value),
                OnValueSelected, value);
  }

	//当选中某个值的时候,itemStr获取到选中值
  void OnValueSelected(object value)
  {
            itemStr = value.ToString();
  }

在这里插入图片描述

  • EditorGUILayout.ObjectField 序列化Object物体
    EditorGUILayout.ObjectField组件是用于显示一些针对继承UnityEngine.Object类的相关组件,比如GameObject、Transform、Component等相关组件,或者继承MonoBehaviour类的脚本。这个控件在编写编辑器时,也是经常会用到的一个东西。
	target = EditorGUILayout.ObjectField(new GUIContent("信息:", "鼠标移入到这个控件时,显示的提示信息"), 
            target, typeof(GameObject), true) as GameObject;

在这里插入图片描述
值得注意的是,在Inspector属性编辑器开发中,有EditorGUILayout.PropertyField组件,它的作用作用跟ObjectField控件是一样的,只不过在窗口中,或者有些情况下EditorGUILayout.PropertyField没那么方便,但是在Inspector属性开发中会方便很多。后续在详细介绍它。

  • GUIContent:控件文字提示
    GUIContent也是一个非常常用的东西。给绘制的控件加别名与提示信息,在Inspector属性绘制中,有一些英文属性也许看名字不了解他是什么作用,但是如果用这个绘制出来,就可以很方便它的作用了。大部分控件都可以用这个,当然也有一些控件是不能用这个的。

  • GUIStyle控件样式
    GUIStyle则是控件的样式,比如Label的字体大小,颜色等等。一般采用系统默认的,这个根据自身情况而定采用自定义的。
    在这里插入图片描述

  • 根据数据进行配置
    明白上述所有的控件之后,就可以在EditorWindows窗口进行绘制自己想要的控件了,再结合GUILayout.BeginHorizontal等相关布局控件,就可以绘制去自己想要的编辑器。

  • 其他控件
    还有一些其他的控件,就不一一列了,基本都是大同小异。
    这是根据这些基本控件,以及一些数据类,具体实现等进行自定义绘制一个配置Json文件的窗口化,可以很方便的对Json进行增删改查。
    在这里插入图片描述
    如果大家看到这里有疑问的,请不要在博客中回复,因为我很少看博客的评论的,可加入我的个人公众号(Hua灬清),我会每周更新一篇博客文档同步公众号文章。

三、Inspector属性开发

  • 简介
    Inspector针对脚本进行编辑器绘制,所用的控件跟Windows窗口开发基本一致,只不过一些绘制方法、初始化等有所区别,下面我将不详细的介绍基本控件了,如果不理解的可以看【Windows窗口开发】这一节。
    我们以下述KGUI_Button类进行Inspector属性绘制。
    在这里插入图片描述

  • KGUI_Button类介绍
    KGUI是本人根据UGUI操作的局限性,基于UGUI的Image组件和RectTransform、Canvas这三个组件,进行了二次封装,后续博客我会详细的介绍KGUI里面的一些组件,同时会介绍UGUI一些比较深的知识。

    KGUI_Button类也就是类似UGUI的Button,提供了一些常用的事件,同时也提供了针对物体的按钮出发,因为在实际项目开发中,可能美术提供的UI是特效,那么我们知道UGUI中使用特效Button是比较麻烦的,所以一般有些时候会用SpriteRenderer,同时又有些情况Button需要声音,以及按钮的激活、选中组等等很多情况,那么UGUI的Button可能满足不了那么多情况,但同时这些功能又有时候是通用的,所以抛离UGUI的Button,基于射线和碰撞体去开发一套全新的,类似我们熟悉的NGUI。

    重点介绍KGUI_Button的相关属性,不介绍具体的方法实现和类设计,因为这篇不讲解具体实现,重点关注编辑器开发,属性讲解只是辅助手段。

  • 属性

		public ButtonType buttonType;
        public SpriteRenderer spriteRenderer;
        public Image image;
        public Sprite normalSprite, enterSprite, pressedSprite, disableSprite;
        public GameObject normalObject, enterObject, pressedObject, disableObject;
  • 事件
		public ButtonEvent onClick;  //鼠标点击
        public ButtonEvent onEnter;  //鼠标移入
        public ButtonEvent onExit;   //鼠标移出
        public ButtonEvent onDown;   //鼠标按下
        public ButtonEvent onUp;     //鼠标抬起
        public ButtonEvent onDownStay; //按下持续
  • KGUI_Button Editor介绍

重点基于上述的属性进行在Editor赋值。

  1. 创建一个Editor类
	[CustomEditor(typeof(KGUI_Button))]
    [CanEditMultipleObjects]
    public class KGUIButtonEditor : Editor
    {}

解析:
[CustomEditor(typeof(KGUI_Button))]告诉编辑器,编辑哪个类?[CanEditMultipleObjects] 用于使自定义编辑器支持多对象编辑的属性。 然后创建的类集成Editor类。

注意:同时才可以在KGUI_Button类中(需要写编辑器的类)添加[ExecuteInEditMode]特性,这个特性的意思是在编辑器下,也会执行Awake()、Start()、Enable()、Update()。

  1. 初始化一些数据
    类创建完毕后,就可以初始化KGUI_Button的属性了,在对Inspector属性窗口中进行控件的绘制。
		//需要绘制的属性对象
		public SerializedProperty onEnter;  //鼠标移入
        public SerializedProperty onExit;   //鼠标移出
        public SerializedProperty onDown;   //鼠标按下
        public SerializedProperty onUp;     //鼠标抬起
        
        //一些对象
        public SerializedProperty spriteRenderer;
        public SerializedProperty image;

        public SerializedProperty normalSprite, enterSprite, pressedSprite, disableSprite;
        public SerializedProperty normalObject, enterObject, pressedObject, disableObject;
        
        //进行编辑器编辑的类对象
		private KGUI_Button button;

当大家看到上述的一些SerializedProperty定义会觉得非常奇怪,为什么要这么写,这是序列化属性,什么意思呢,就是我们需要序列化出KGUI_Button类中的属性对象,从而能在后面进行绘制出来。

在OnEnable()函数中编写,对定义的SerializedProperty字段进行赋值。

		private void OnEnable()
        {
            button = serializedObject.targetObject as KGUI_Button;

            onClick = serializedObject.FindProperty("onClick");
            onEnter = serializedObject.FindProperty("onEnter");
            onExit = serializedObject.FindProperty("onExit");
            onDown = serializedObject.FindProperty("onDown");
            onUp = serializedObject.FindProperty("onUp");
            onDownStay = serializedObject.FindProperty("onDownStay");
            
            buttonType = serializedObject.FindProperty("buttonType");

            spriteRenderer = serializedObject.FindProperty("spriteRenderer");
            image = serializedObject.FindProperty("image");

            normalSprite = serializedObject.FindProperty("normalSprite");
            enterSprite = serializedObject.FindProperty("enterSprite");
            pressedSprite = serializedObject.FindProperty("pressedSprite");
            disableSprite = serializedObject.FindProperty("disableSprite");

            normalObject = serializedObject.FindProperty("normalObject");
            enterObject = serializedObject.FindProperty("enterObject");
            pressedObject = serializedObject.FindProperty("pressedObject");
            disableObject = serializedObject.FindProperty("disableObject");
        }

解析:
serializedObject.FindProperty(“onClick”);以这个为例,它的意思是查找序列化对象下的onClick属性/字段。
上述的工作,初始化常用的属性也就基本完毕了。下面在OnInspectorGUI()进行绘制。
3. 具体实现
1)首先要实现选择不同的枚举,绘制出来的信息是不一样的,那么我们可以如下所示这么写:
在这里插入图片描述
这样子我们就可以根据选择不同的枚举信息进行绘制不同的窗口了。

2)绘制继承UnityEngine.Object属性的两种方式

同时我们在上述的图片中,看到很多EditorGUILayout.PropertyField(),这个就是绘制出你编辑器的属性字段,它不用管你是什么类型,只要你对某个属性进行序列化查找赋值,那么它都可以在Inspector窗口中绘制出来,当然一般像int、bool、枚举、vector等都不用这个,因为Unity提供了这些基本的控件。

同时只要是你集成UnityEngine.Object的属性,比如GameObject、Component、Transform等那么你可以不用这么编写,用我们在【Windows窗口开发】下的EditorGUILayout.ObjectField()方法也是可以的,这样的话,你就不需要定义SerializedProperty字段以及在OnEnable初始化了,不过在编写Inspector窗口时,还是推荐用EditorGUILayout.PropertyField()

3)绘制非UnityEngine.Object属性的方式

当然如果是非UnityEngine.Object属性,比如Unity的事件(UnityEvent)事件,那么你就不能EditorGUILayout.ObjectField(),因为这是绘制不出来的,你只能采用EditorGUILayout.PropertyField()。这点本人在写Windows窗口时,尝试过。

四、Hierarchy右键菜单开发

在有些情况,我们需要在Hierarchy邮右键时,也想出现我们自定义的菜单项,应该怎么做呢?

		[MenuItem("MagiCloud/KGUI/Control/KGUI_Toggle(开关)")] //在菜单栏显示
        [MenuItem("GameObject/MagiCloud/KGUI/KGUI_Toggle(开关)", validate = false, priority = 10)]
        private static void CreateKGUI_Toggle()
        {
        	//获取到选中的物体
            Transform[] selectedObject = Selection.GetTransforms(SelectionMode.TopLevel | SelectionMode.ExcludePrefab);

            Transform parent = GetSeleteTransform();

            var ui = Resources.Load<GameObject>("UI/Toggle");

            CreateController(parent, ui);
        }
        
		/// <summary>
        /// 获取到选中的Trnsform
        /// </summary>
        /// <returns></returns>
        static Transform GetSeleteTransform()
        {
            Transform[] selectedObject = Selection.GetTransforms(SelectionMode.TopLevel | SelectionMode.ExcludePrefab);

            return selectedObject.Length == 0 ? null : selectedObject[0];
        }

[MenuItem(“GameObject/KGUI/KGUI_Toggle(开关)”, validate = false, priority = 10)]重要是这行代码,在静态方法中,添加如上述所示,那么在Hierarchy窗口中,右键就可以出现这个菜单项,则上述代码的实现就是获取到选中的物体,在这个物体下生成控件等功能。

五、结束语

好了,这篇博客就介绍在这里了,后续的博客我将详细介绍我的KGUI一些控件,里面会涉及到很多的UGUI一些知识、一些设计思路、射线、屏幕坐标计算等等。
在这里插入图片描述
大家如果看了,有疑问可以关注微信公众号(Hua灬清),有问题在这里回复即可,博客统一不回复,也不要发邮件、加QQ。

评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值