Unity编辑器扩展之Inspector面板扩展

news2025/2/25 6:43:44

内容将会持续更新，有错误的地方欢迎指正，谢谢!
 

Unity编辑器扩展之Inspector面板扩展
     
TechX 坚持将创新的科技带给世界！

拥有更好的学习体验 —— 不断努力，不断进步，不断探索
TechX —— 心探索、心进取！

助力快速掌握 Inspector 编辑器扩展

为初学者节省宝贵的学习时间，避免困惑！

文章目录

  • 一、Inspector面板头部扩展
  • 二、原生Component扩展
    • 2.1、直接继承原生组件的编辑器脚本
    • 2.2、使用反射获取编辑器脚本的扩展方式
  • 三、自定义组件编辑器扩展
    • 3.1、使用 UIElements 构建自定义 UI
      • 3.1.1、创建 MyPlayer 类
      • 3.1.2、创建自定义编辑器脚本MyPlayerEditor
      • 3.1.3、定义 UXML 文件
      • 3.1.4、定义 USS 文件
    • 3.2、使用EditorGUILayout直接绘制
    • 3.3、使用 SerializedObject 和 SerializedProperty绘制

一、Inspector面板头部扩展


通过订阅 Editor.finishedDefaultHeaderGUI 事件，这个事件在 Inspector 面板的默认 GUI 绘制完成后触发。

我们可以在 Unity Editor 的 Inspector 面板顶部添加自定义按钮，从而实现对选中对象的自定义操作。

using UnityEditor;
using UnityEditor.SceneManagement;
using UnityEngine;

[InitializeOnLoadAttribute]
static class EditorHeaderGUID
{
    static EditorHeaderGUID()
    {
        Editor.finishedDefaultHeaderGUI += DisplayGUIDIfPersistent;
    }

    static void DisplayGUIDIfPersistent(Editor editor)
    {
        // 确保当前对象是在场景中的对象
        if (editor.target is GameObject go && !EditorUtility.IsPersistent(go))
        {
            GUI.color = Color.green;
            // 在顶部添加一个按钮
            if (GUILayout.Button("Add Cube Components", GUILayout.Height(30)))
            {
                // 为选中的物体添加组件
                AddComponents(go);
            }

            // 在顶部添加一个按钮
            if (GUILayout.Button("Remove Cube Components", GUILayout.Height(30)))
            {
                // 为选中的物体移除组件
                RemoveComponents(go);
            }

            GUI.color = Color.white;
        }
    }

    static void AddComponents(GameObject go)
    {
        if (go != null)
        {
            // 检查并添加 BoxCollider 组件
            if (go.GetComponent<BoxCollider>() == null)
            {
                go.AddComponent<BoxCollider>();
            }

            // 检查并添加 Rigidbody 组件
            if (go.GetComponent<Rigidbody>() == null)
            {
                go.AddComponent<Rigidbody>();
            }

            // 标记场景已更改
            EditorSceneManager.MarkSceneDirty(go.scene);
        }
    }

    static void RemoveComponents(GameObject go)
    {
        if (go != null)
        {
            // 删除 BoxCollider 组件
            BoxCollider boxCollider = go.GetComponent<BoxCollider>();
            if (boxCollider != null)
            {
                Object.DestroyImmediate(boxCollider);
            }

            // 删除 Rigidbody 组件
            Rigidbody rigidbody = go.GetComponent<Rigidbody>();
            if (rigidbody != null)
            {
                Object.DestroyImmediate(rigidbody);
            }

            // 标记场景已更改
            EditorSceneManager.MarkSceneDirty(go.scene);
        }
    }
}

在本示例中，我们实现了添加和删除BoxCollider 和Rigidbody组件的功能。这种方法可以极大地提高我们在 Unity 编辑器中的工作效率。

在这里插入图片描述


二、原生Component扩展


在 Unity 开发过程中，原生组件（如 Transform、Camera、Text、BoxCollider等组件）是 Unity 自带的基本组件。

2.1、直接继承原生组件的编辑器脚本


适用于可以直接访问和继承原生组件的编辑器脚本，比如 TextEditor等。

[CustomEditor(typeof(Text), true)]
    public class TextExtension : TextEditor
    {
        private Text Target { get { return (Text)target; } }

        public override void OnInspectorGUI()
        {
            base.OnInspectorGUI();
            GUILayout.Space(10);

            GUI.color = new Color(0, 1, 0, 0.5f);
            GUILayout.Space(10);
            if (GUILayout.Button("Set Text", GUILayout.Height(30)))
            {
                Target.fontSize = 20;
                Target.alignment = TextAnchor.MiddleCenter;
                Target.color = Color.white;
            }
            GUI.color = Color.white;
        }
    }

TextEditor外部能够访问，可以直接继承，通过base.OnInspectorGUI();可以绘制父类的GUI，可以保持原先布局不变。

在这里插入图片描述

2.2、使用反射获取编辑器脚本的扩展方式


某些原生组件的编辑器脚本并不直接暴露给开发者，需要通过反射方式获取才能进行扩展，例如某些内部或私有的编辑器脚本。

实现方法：通过 Assembly、Type 和反射来获取和操作目标组件的编辑器脚本

[CustomEditor(typeof(Transform), true)]
    public class ComponentExtension : Editor
    {
        private Editor m_Editor;
        private Transform Target { get { return (Transform)target; } }

        private void OnEnable()
        {
            Type type = Assembly.GetAssembly(typeof(Editor)).GetType("UnityEditor.TransformInspector", false);
            m_Editor = Editor.CreateEditor(target, type);
        }

        public override void OnInspectorGUI()
        {
            if (m_Editor == null) return;
            m_Editor.OnInspectorGUI();

            GUILayout.Space(10);

            GUI.color = new Color(0, 1, 0, 0.5f);
            GUILayout.Space(10);
            if (GUILayout.Button("Reset Position", GUILayout.Height(30)))
            {
                Target.position = new Vector3(0, 0, 0);
                Target.rotation = Quaternion.identity;
                Target.localScale = new Vector3(1, 1, 1);
            }
            GUI.color = Color.white;
        }
    }

Transform的编辑器脚本外界并不能直接访问，这里通过反射Assembly.GetAssembly(typeof(Editor)).GetType(“UnityEditor.TransformInspector”, false);来获取到Transform的编辑器类型TransformInspector

同时通过调用m_Editor.OnInspectorGUI();来绘制原编辑器的GUI，保证原先布局不变。

在这里插入图片描述


三、自定义组件编辑器扩展


3.1、使用 UIElements 构建自定义 UI


在 Unity 中，使用 UIElements 可以更加直观和灵活地设计和实现自定义的 Inspector 面板。以下是一个完整的示例，展示如何使用 UIElements 和 UXML 文件来定义自定义 Inspector 布局，并将其绑定到一个 MyPlayer 对象。

3.1.1、创建 MyPlayer 类


using UnityEngine;

public class MyPlayer : MonoBehaviour
{
    public int damage = 50;
    public int armor = 30;
    public GameObject gun;
}

3.1.2、创建自定义编辑器脚本MyPlayerEditor


首先，我们创建一个自定义编辑器脚本 MyPlayerEditor，继承自 Editor 类，并覆盖 CreateInspectorGUI 方法来加载和设置 UXML 文件和样式表。

using UnityEditor;
using UnityEngine;
using UnityEngine.UIElements;

[CustomEditor(typeof(MyPlayer))]
public class MyPlayerEditor : Editor
{
    const string resourceFilename = "custom-editor-uie";

    public override VisualElement CreateInspectorGUI()
    {
        // 创建一个新的 VisualElement 作为自定义 Inspector 的根元素
        VisualElement customInspector = new VisualElement();

        // 加载 UXML 资源文件
        var visualTree = Resources.Load<VisualTreeAsset>(resourceFilename);
        if (visualTree != null)
        {
            // 克隆 UXML 定义的层级视图到自定义 Inspector 中
            visualTree.CloneTree(customInspector);

            // 加载并添加样式表
            var styleSheet = Resources.Load<StyleSheet>($"{resourceFilename}-style");
            if (styleSheet != null)
            {
                customInspector.styleSheets.Add(styleSheet);
            }
        }
        else
        {
            Debug.LogError($"Could not find UXML resource: {resourceFilename}");
        }

        return customInspector;
    }
}

3.1.3、定义 UXML 文件


创建一个 UXML 文件来定义自定义 Inspector 面板的布局。将该文件保存为 custom-editor-uie.uxml，并将其放置在 Resources 文件夹中。

<UXML xmlns="UnityEngine.UIElements" xmlns:e="UnityEditor.UIElements">
    <VisualElement class="player-property">
        <VisualElement class="slider-row">
            <Label class="player-property-label" text="Damage"/>
            <VisualElement class="input-container">
                <SliderInt class="player-slider" name="damage-slider" high-value="100" direction="Horizontal" binding-path="damage"/>
                <e:IntegerField class="player-int-field" binding-path="damage"/>
            </VisualElement>
        </VisualElement>
        <e:ProgressBar class="player-property-progress-bar" name="damage-progress" binding-path="damage" title="Damage"/>
    </VisualElement>

    <VisualElement class="player-property">
        <VisualElement class="slider-row">
            <Label class="player-property-label" text="Armor"/>
            <VisualElement class="input-container">
                <SliderInt class="player-slider" name="armor-slider" high-value="100" direction="Horizontal" binding-path="armor"/>
                <e:IntegerField class="player-int-field" binding-path="armor"/>
            </VisualElement>
        </VisualElement>
        <e:ProgressBar class="player-property-progress-bar" name="armor-progress" binding-path="armor" title="Armor"/>
    </VisualElement>

    <e:PropertyField class="gun-field" binding-path="gun" label="Gun Object"/>
</UXML>

3.1.4、定义 USS 文件


创建一个 USS 文件来定义 Inspector 面板的样式。将该文件保存为 custom-editor-uie-style.uss，并将其放置在 Resources 文件夹中。

.slider-row {
    flex-direction: row;
    justify-content: space-between;
    margin-top: 4px;
}
.input-container {
    flex-direction: row;
    flex-grow: .6;
    margin-right: 4px;
}
.player-property {
    margin-bottom: 4px;
}
.player-property-label {
    flex: 1;
    margin-left: 16px;
}
.player-slider {
    flex: 3;
    margin-right: 4px;
}
.player-property-progress-bar {
    margin-left: 16px;
    margin-right: 4px;
}
.player-int-field {
    min-width: 48px;
}
.gun-field {
    justify-content: space-between;
    margin-left: 16px;
    margin-right: 4px;
    margin-top: 6px;
    flex-grow: .6;
}

在这里插入图片描述

3.2、使用EditorGUILayout直接绘制


在 Unity 中，自定义 Inspector 面板时，可以直接通过编辑器修改脚本变量。虽然这种方式不支持多对象编辑、撤销和 Prefab 覆盖，但它实现起来更加简单直接，适用于一些简单的自定义编辑器需求。

using UnityEditor;
using UnityEngine;

// 自定义编辑器，直接修改脚本变量，不处理多对象编辑、撤销和 Prefab 覆盖
[CustomEditor(typeof(MyPlayer))]
public class MyPlayerEditorAlternative : Editor
{
    public override void OnInspectorGUI()
    {
        MyPlayerAlternative mp = (MyPlayerAlternative)target;

        mp.damage = EditorGUILayout.IntSlider("Damage", mp.damage, 0, 100);
        ProgressBar(mp.damage / 100.0f, "Damage");

        mp.armor = EditorGUILayout.IntSlider("Armor", mp.armor, 0, 100);
        ProgressBar(mp.armor / 100.0f, "Armor");

        bool allowSceneObjects = !EditorUtility.IsPersistent(target);
        mp.gun = (GameObject)EditorGUILayout.ObjectField("Gun Object", mp.gun, typeof(GameObject), allowSceneObjects);
    }

    // 自定义 GUILayout 进度条
    void ProgressBar(float value, string label)
    {
        // 获取进度条的矩形区域，使用与文本字段相同的边距
        Rect rect = GUILayoutUtility.GetRect(18, 18, "TextField");
        EditorGUI.ProgressBar(rect, value, label);
        EditorGUILayout.Space();
    }
}

3.3、使用 SerializedObject 和 SerializedProperty绘制


使用 SerializedObject 和 SerializedProperty 提供了一种更结构化的方法，带来一些显著的优势：

  • 自动管理数据更改：
    无需手动调用 EditorUtility.SetDirty，因为 ApplyModifiedProperties 会自动处理数据更改。

  • 撤销/重做支持：
    自动支持撤销和重做功能，无需额外代码。

  • 多对象编辑：
    可以轻松实现多个对象的编辑，并自动处理它们的属性同步。

  • 数据一致性：
    确保数据的一致性和正确性，因为 SerializedObject 和 SerializedProperty 直接与 Unity 的序列化系统交互。

using UnityEditor;
using UnityEngine;

// 自定义编辑器，适用于 MyPlayer 脚本
[CustomEditor(typeof(MyPlayer))]
[CanEditMultipleObjects]
public class MyPlayerEditor : Editor
{
    SerializedProperty damageProp;
    SerializedProperty armorProp;
    SerializedProperty gunProp;

    // 在启用编辑器时初始化 SerializedProperties
    void OnEnable()
    {
        // 获取 SerializedProperties
        damageProp = serializedObject.FindProperty("damage");
        armorProp = serializedObject.FindProperty("armor");
        gunProp = serializedObject.FindProperty("gun");
    }

    // 绘制自定义 Inspector GUI
    public override void OnInspectorGUI()
    {
        // 更新 serializedObject，在 OnInspectorGUI 开头调用
        serializedObject.Update();

        // 显示自定义 GUI 控件
        EditorGUILayout.IntSlider(damageProp, 0, 100, new GUIContent("Damage"));
		ProgressBar(damageProp.intValue / 100.0f, "Damage");
       
        EditorGUILayout.IntSlider(armorProp, 0, 100, new GUIContent("Armor"));
		ProgressBar(armorProp.intValue / 100.0f, "Armor");
      
        EditorGUILayout.PropertyField(gunProp, new GUIContent("Gun Object"));

        // 在 OnInspectorGUI 末尾应用属性更改
        serializedObject.ApplyModifiedProperties();
    }

    // 自定义 GUILayout 进度条
    void ProgressBar(float value, string label)
    {
        // 获取进度条的矩形区域，使用与文本字段相同的边距
        Rect rect = GUILayoutUtility.GetRect(18, 18, "TextField");
        EditorGUI.ProgressBar(rect, value, label);
        EditorGUILayout.Space();
    }
}


TechX —— 心探索、心进取！

每一次跌倒都是一次成长

每一次努力都是一次进步

END
感谢您阅读本篇博客！希望这篇内容对您有所帮助。如果您有任何问题或意见，或者想要了解更多关于本主题的信息，欢迎在评论区留言与我交流。我会非常乐意与大家讨论和分享更多有趣的内容。
如果您喜欢本博客，请点赞和分享给更多的朋友，让更多人受益。同时，您也可以关注我的博客，以便及时获取最新的更新和文章。
在未来的写作中，我将继续努力，分享更多有趣、实用的内容。再次感谢大家的支持和鼓励，期待与您在下一篇博客再见！

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/1901886.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

开关阀(4):对于客户技术要求信息的识别

开关阀(4):对于客户技术要求信息的识别

1.阀门部分 2.执行器 行程时间的一般标准 The stroking times are applicable to throttling control valves and should not exceed 2 seconds/inch of valve diameter 3.附件 4.定位器
阅读更多...
ubuntu设置开启自动挂载sftp

ubuntu设置开启自动挂载sftp

1. 前言 与其说 ubuntu 开启自动挂载 sftp, 更确切的说应该是 nautilus (ubuntu上默认的文件管理器) 开机自动挂载 sftp。 因为 这里即使选择永远记住&#xff0c;开机也不会自动挂载 sftp 2.设置方法 gnome-session-properties #开机只启动设置命令设置 gio mount sftp…
阅读更多...
科普文：构建可扩展的微服务架构设计方案

科普文：构建可扩展的微服务架构设计方案

前言 微服务架构是一种新兴的软件架构风格&#xff0c;它将单个应用程序拆分成多个小的服务&#xff0c;每个服务都运行在自己的进程中&#xff0c;这些服务通过网络进行通信。这种架构的优势在于它可以提高应用程序的可扩展性、可维护性和可靠性。 在传统的应用程序架构中&…
阅读更多...
《昇思25天学习打卡营第13天|onereal》

《昇思25天学习打卡营第13天|onereal》

今天学习的内容如下&#xff1a; DCGN生成漫画头像 在下面的教程中&#xff0c;我们将通过示例代码说明DCGAN网络如何设置网络、优化器、如何计算损失函数以及如何初始化模型权重。在本教程中&#xff0c;使用的动漫头像数据集共有70,171张动漫头像图片&#xff0c;图片大小均为…
阅读更多...
Linux SSH服务介绍

Linux SSH服务介绍

1. 引言 在现代IT基础设施中&#xff0c;远程访问和管理服务器已成为日常运维工作的重要组成部分。Secure Shell (SSH) 是一种广泛使用的加密网络协议&#xff0c;允许在不安全的网络上安全地进行远程登录和其他网络服务。本文将详细介绍SSH服务的各个方面&#xff0c;包括其定…
阅读更多...
String类对象比较：==和equals的具体细节

String类对象比较：==和equals的具体细节

public class test {public static void main(String[] args) {String name1 "zzz";String name2 "zzz";String name3 new String("zzz");// hashCode() 方法&#xff1a;基于字符串的内容计算哈希值&#xff0c;因此内容相同的字符串对象其 …
阅读更多...
anaconda中下载压缩包并用conda安装包

anaconda中下载压缩包并用conda安装包

有时直接conda安装包时会出错&#xff1b;报错PackagesNotFoundError: The following packages are not available from current channels 比如 conda install -y bioconda::ucsc-gtftogenepred #直接安装报错 #直接下载压缩包安装https://blog.csdn.net/weixin_45552562/ar…
阅读更多...
最新扣子(Coze)实战案例：使用扩图功能，让你的图任意变换，完全免费教程

最新扣子(Coze)实战案例：使用扩图功能，让你的图任意变换，完全免费教程

&#x1f9d9;‍♂️ 大家好&#xff0c;我是斜杠君&#xff0c;手把手教你搭建扣子AI应用。 &#x1f4dc; 本教程是《AI应用开发系列教程之扣子(Coze)实战教程》&#xff0c;完全免费学习。 &#x1f440; 微信关注公从号&#xff1a;斜杠君&#xff0c;可获取完整版教程。&a…
阅读更多...
电商视角如何理解动态IP与静态IP

电商视角如何理解动态IP与静态IP

在电子商务的蓬勃发展中&#xff0c;网络基础设施的稳定性和安全性是至关重要的。其中&#xff0c;IP地址作为网络设备间通信的基础&#xff0c;扮演着举足轻重的角色。从电商的视角出发&#xff0c;我们可以将动态IP和静态IP比作电商平台上不同类型的店铺安排&#xff0c;以此…
阅读更多...
如何配置 PostgreSQL 以实现高可用性和故障转移？

如何配置 PostgreSQL 以实现高可用性和故障转移？

文章目录 一、高可用性和故障转移的概念&#xff08;一&#xff09;数据复制&#xff08;二&#xff09;监控和检测&#xff08;三&#xff09;快速切换 二、实现高可用性和故障转移的技术方案&#xff08;一&#xff09;流复制&#xff08;Streaming Replication&#xff09;&…
阅读更多...
二叉树中的前序、中序、后续遍历（C语言）

二叉树中的前序、中序、后续遍历（C语言）

目录 前序遍历概念代码递归分解图 中序遍历概念代码 后序遍历概念代码 前序遍历 概念 概念&#xff1a; 前序遍历(Preorder Traversal 亦称先序遍历)——访问根结点的操作发生在遍历其左右子树之前。 简单点来说就是&#xff1a;根 左子树 右子树的访问顺序 例如&#xff1a;…
阅读更多...
Win11 Python3.10 安装pytorch3d

Win11 Python3.10 安装pytorch3d

0&#xff0c;背景 Python3.10、cuda 11.7、pytorch 2.0.1 阅读【深度学习】【三维重建】windows10环境配置PyTorch3d详细教程-CSDN博客 1&#xff0c;解决方法 本来想尝试&#xff0c;结果发现CUB安装配置对照表里没有cuda 11.7对应的版本&#xff0c;不敢轻举妄动&#x…
阅读更多...
【分布式系统】ELK 企业级日志分析系统

【分布式系统】ELK 企业级日志分析系统

目录 一.ELK概述 1.简介 1.1.可以添加的其他组件 1.2.filebeat 结合 logstash 带来好处 2.为什么使用ELK 3.完整日志系统基本特征 4.工作原理 二.部署ELK日志分析系统 1.初始化环境 2.完成JAVA部署 三. ELK Elasticsearch 集群部署 1.安装 2.修改配置文件 3.es 性…
阅读更多...
DDR3（三）

DDR3（三）

目录 1 预取1.1 什么是预取1.2 预取有哪些好处1.3 结构框图1.4 总结 2 突发2.1 什么是突发2.2 突发与预取 本文讲解DDR中常见的两个术语&#xff1a;预取和突发&#xff0c;对这两个概念理解的关键在于地址线的低位是否参与译码&#xff0c;具体内容请继续往下看。 1 预取 1.1…
阅读更多...
利用 Hexo 搭建个人博客

利用 Hexo 搭建个人博客

〇、前言 本文将会讨论&#xff0c;如何将 CSDN 上的博客&#xff0c;拉取到本地&#xff0c;然后PicGo、Hexo、Github 等工具建立个人博客&#xff0c;环境为 Ubuntu 20.04。 一、利用 Hexo 预备工作 首先安装 Node.js、npm、git工具。 > node -v v12.22.9 > npm -…
阅读更多...
华为机试HJ34图片整理

华为机试HJ34图片整理

华为机试HJ34图片整理 题目&#xff1a; 想法&#xff1a; 将输入的字符串中每个字符都转为ASCII码&#xff0c;再通过快速排序进行排序并输出 input_str input() input_list [int(ord(l)) for l in input_str]def partition(arr, low, high):i low - 1pivot arr[high]f…
阅读更多...
[CTF]-PWN：House of Banana堆块题型综合分析

[CTF]-PWN：House of Banana堆块题型综合分析

搭配largebin attack&#xff1a; 例题&#xff08;ISCC2024 heapheap)&#xff1a; 版本&#xff1a;glibc2.31 知识点&#xff1a;largebin attack、house of banana、uaf 查看保护 查看ida delete存在uaf漏洞 largebin attack手法&#xff1a; #创建4个堆块&#xff0…
阅读更多...
图的应用之最短路径

图的应用之最短路径

引入 应用 算法思想 Dijistra算法 用于解决单个顶点间的最短路径问题 将顶点看成两部分&#xff1a; 最短路径顶点集合A与尚未确定最短路径顶点集合B。 先将顶点按最短路径由小到大依次加入到A中&#xff0c;选择由源点到A中最短的顶点&#xff0c;并记录距离与顶点&#xf…
阅读更多...
Java中线程的常用方法(并发编程基础)

Java中线程的常用方法(并发编程基础)

Java中线程的常用方法 sleep 调用sleep会让当前线程从Running进入TIMED WAITING状态其它线程可以使用 interrupt 方法打断正在睡眠的线程,这时sleep方法会抛出InterruptedException睡眠结束后的线程未必会立刻得到执行建议用TimeUnit的sleep代替Thread的sleep来获得更好的可读…
阅读更多...
51单片机STC89C52RC——15.1 AD/DA(模数数模)

51单片机STC89C52RC——15.1 AD/DA(模数数模)

目的/效果 1 LCD1602 显示 可调电阻、光敏电阻、热敏电阻值&#xff08;AD&#xff09; 2 模拟信号控制LED明暗&#xff08;DA&#xff09; 一&#xff0c;STC单片机模块 二&#xff0c;AD/DA 2.1 AD/DA 介绍 AD&#xff08;Analog to Digital&#xff09;&#xff1a;模拟…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023