Unity 3D编辑器扩展介绍、教程(二) —— 创建窗口

简介: Unity编辑器扩展教程(二)本文提供全流程,中文翻译。Chinar坚持将简单的生活方式,带给世人!(拥有更好的阅读体验 —— 高分辨率用户请根据需求调整网页缩放比例)...

Unity编辑器扩展教程(二)


本文提供全流程,中文翻译。

Chinar坚持将简单的生活方式,带给世人!

(拥有更好的阅读体验 —— 高分辨率用户请根据需求调整网页缩放比例)




此教程是在教程(一)基础上进行扩展:如果不知道如何创建编辑器按钮,推荐先看教程(一)

Unity3D编辑器扩展介绍、教程 —— 创建菜单项(一)


Brief Introduction —— 简介


我们在做工程的时候,需要对数据进行操作。

为节省时间,会使用一些快捷键,菜单栏上的功能、或是右键菜单

这些便捷的功能,都是Unity官方为了方便我们对所需数据进行操作。

对Unity编辑进行了一些封装处理,简化数据操作流程,封装为一个按钮/一个窗口/窗口功能。

这些诸如此类的功能就是编辑器的扩展,和封装

功能键、Inspector面板、Game视窗等等都是编辑器的功能


注意:编辑器类脚本,必须放在 Assets/Editor 资源目录中

此文件夹下的脚本只对编辑器进行操作。最后资源打包,Editor文件夹下的所有资源都不会被打包到工程中

如果没有此文件夹,需自行创建:在Project视窗下,右键Create - - Folder

举个栗子黑白88

这里写图片描述

这里写图片描述


ScriptableWizard —— 脚本化向导


ScriptableWizard 是一个编辑器类,继承自 EditorWindow

从这个类派生来创建一个编辑器向导


1

- - DisplayWizard —— 显示器向导


创建一个显示器向导,调用静态方法

DisplayWizard <类型>(“标题”, “第一个按钮”, “第二个按钮”);

即可创建一个 显示器向导

举个栗子黑白88

using UnityEditor; //引用Unity编辑器命名空间
using UnityEngine; //引用Unity引擎命名空间


/// <summary>
/// 改变所有敌人脚本
/// </summary>
public class ChangeAll : ScriptableWizard
{
    public int AddHp = 10; //每次增加血量值
    public int Num = 0;//一个数字为了测试 isValue

    /// <summary>
    /// 菜单栏 我的工具 中,创建一个按钮
    /// </summary>
    [MenuItem("我的工具/修改所有敌人属性")]
    static void 修改所有敌人属性()
    {
        //显示器向导 <所管控的类>( 窗口的名字,窗口中按钮的名字,第二个按钮的名字 );
        DisplayWizard<ChangeAll>("修改所有敌人血量", "确认修改血量", "第二个按钮");
    }
}

这里写图片描述


2

- - ScriptableWizard Messages Sent —— 脚本化向导的信息传递


其中内置了一些固定函数,用来传递信息

OnEnable() —————————————————– 脚本有效时就会执行

OnWizardCreate() ————————————— 在 创建 / 第一个 按钮上点击时调用

OnWizardOtherButton() ————————— 在 其他 按钮上点击时调用(允许一个动作)

OnWizardUpdate() ————————————– 在向导被打开 / 向导中数据发生变化时被调用

OnSelectionChange() ——————————— 当选择发生改变,调用此函数
(此函数在EditorWindow中,而ScriptableWizard继承自EditorWindow,所以可以在其中直接调用)
举个栗子黑白88

using UnityEditor; //引用Unity编辑器命名空间
using UnityEngine; //引用Unity引擎命名空间


/// <summary>
/// 改变所有敌人脚本
/// </summary>
public class ChangeAll : ScriptableWizard
{
    public int AddHp = 10; //每次增加血量值
    public int Num   = 0;  //一个数字为了测试 isValue


    /// <summary>
    /// 菜单栏 我的工具 中,创建一个按钮
    /// </summary>
    [MenuItem("我的工具/修改所有敌人属性")]
    static void 修改所有敌人属性()
    {
        //显示器向导 <所管控的类>( 窗口的名字,窗口中按钮的名字,第二个按钮的名字 );
        DisplayWizard<ChangeAll>("修改所有敌人血量", "确认修改血量", "第二个按钮");
    }


    /// <summary>
    /// 固定函数名:窗口开始时执行
    /// </summary>
    void OnEnable()
    {
        AddHp = EditorPrefs.GetInt("ChangeAll_health", AddHp); //取值,默认为初始值   并赋值给AddHp
    }


    /// <summary>
    /// 固定函数名:对应现实向导中的第一个按钮 —— 确认修改血量
    /// </summary>
    void OnWizardCreate()
    {
        //进度条
        EditorUtility.DisplayProgressBar("修改进度", "0/" + Selection.gameObjects.Length + "完成修改", 1);
        int count = 0;

        foreach (var gameObject in Selection.gameObjects) //遍历选中的物体
        {
            CompleteProject.EnemyHealth health = gameObject.GetComponent<CompleteProject.EnemyHealth>(); //获取其身上脚本组件
            Undo.RecordObject(health, "Change health");                                                  //记录变量 health 之后做的更改
            health.startingHealth += AddHp;                                                              //自增 设置的值   //需要修改其他属性,自己往下写

            count++;
            //进度条
            EditorUtility.DisplayProgressBar("修改进度", count + "/" + Selection.gameObjects.Length + "完成修改", progress: count / Selection.gameObjects.Length);
        }
        EditorUtility.ClearProgressBar();//清除进度条
    }


    /// <summary>
    /// 固定函数名:对应现实向导中的第二按钮 —— 第二个按钮
    /// </summary>
    void OnWizardOtherButton()
    {
        //弹出通知(新建一个 GUI内容(被选中物体的个数)+“字符” )
        ShowNotification(new GUIContent(Selection.gameObjects.Length + "个元素被选中"));
    }


    /// <summary>
    /// 当属性值被修改时,每帧调用。 /  当界面开启时,会调用一次
    /// </summary>
    void OnWizardUpdate()
    {
        helpString  = null; //每次调用就归零一次,否则会出现字体不消除的情况
        errorString = null;

        if (Selection.gameObjects.Length > 0)
        {
            helpString = "当前选择了" + Selection.gameObjects.Length + "个敌人"; //及时更新选择的数量
        }
        else
        {
            errorString = "最少选择一个啊"; //错误提示
        }

        EditorPrefs.SetInt("ChangeAll_health", AddHp); //修改后存入一个值,就是记录一下。
    }


    /// <summary>
    /// 当选择的物体发生改变,调用此函数
    /// </summary>
    void OnSelectionChange()
    {
        OnWizardUpdate();
    }
}

这里写图片描述


3

- - DisplayProgressBar —— 进度条


在显示器向导中创建一个进度条

EditorUtility.DisplayProgressBar( 进度条标题,进度信息,进度比例 )

EditorUtility.ClearProgressBar() 调用此函数,进度条才会被删除
举个栗子黑白88

using UnityEditor; //引用Unity编辑器命名空间
using UnityEngine; //引用Unity引擎命名空间


/// <summary>
/// 改变所有敌人脚本
/// </summary>
public class ChangeAll : ScriptableWizard
{
    public int AddHp = 10; //每次增加血量值
    public int Num   = 0;  //一个数字为了测试 isValue


    /// <summary>
    /// 菜单栏 我的工具 中,创建一个按钮
    /// </summary>
    [MenuItem("我的工具/修改所有敌人属性")]
    static void 修改所有敌人属性()
    {
        //显示器向导 <所管控的类>( 窗口的名字,窗口中按钮的名字,第二个按钮的名字 );
        DisplayWizard<ChangeAll>("修改所有敌人血量", "确认修改血量", "第二个按钮");
    }


    /// <summary>
    /// 固定函数名:对应现实向导中的第二按钮 —— 第二个按钮
    /// </summary>
    void OnWizardOtherButton()
    {
        EditorUtility.DisplayProgressBar("修改进度", "0/" + Selection.gameObjects.Length + "完成修改", 1); //进度条
        int count = 0;                                                                             //计数
        foreach (var gameObject in Selection.gameObjects)                                          //遍历选中的物体
        {
            CompleteProject.EnemyHealth health = gameObject.GetComponent<CompleteProject.EnemyHealth>();                                         //获取其身上脚本组件
            Undo.RecordObject(health, "Change health");                                                                                          //记录变量 health 之后做的更改
            health.startingHealth += AddHp;                                                                                                      //自增 设置的值   //需要修改其他属性,自己往下写
            count++;                                                                                                                             //计数自增1
            EditorUtility.DisplayProgressBar("修改进度", count + "/" + Selection.gameObjects.Length + "完成修改", count / Selection.gameObjects.Length); //进度条
        }

        //EditorUtility.ClearProgressBar(); //清除进度条(只有调用此方法,进度条才会删除)
    }
}

这里写图片描述


EditorWindow —— 编辑器窗口


创建一个编辑器窗口,在我们的Unity编辑器中

GetWindow(bool, 窗口名字)

bool 值为: false 窗口可以与其他窗口合并
bool 值为: true 窗口独立,不可合并

以下是我写的一个简单的梨子,用于批量修改物体的名称(选择物体内数组,并没有进行内部处理)
举个栗子黑白88

using UnityEditor; //引用Unity编辑器命名空间
using UnityEngine; //引用Unity引擎命名空间


/// <summary>
/// 创建一个窗口类
/// </summary>
public class ChinarWindow : EditorWindow//继承自 EditorWindow
{
    string      CustomName = "CustomName"; //自定义名字
    private int ChinarNum  = 0;            //空物体数量


    /// <summary>
    /// 创建一个菜单项
    /// </summary>
    [MenuItem("我的工具/显示新窗口")]
    static void 显示新窗口()
    {
        ChinarWindow chinar = GetWindow<ChinarWindow>(false, "Chinar窗口"); //获取到一个窗口,赋值给当前编辑器类的对象
        chinar.Show();                                                    //显示对象的窗口
    }


    /// <summary>
    /// 此函数中实现编辑器界面的定义/绘制
    /// </summary>
    void OnGUI()
    {
        GUILayout.Label("这是Chianr窗口");                                     //标题
        CustomName = GUILayout.TextField(CustomName);                      //文本框
        ChinarNum  = int.Parse(GUILayout.TextField(ChinarNum.ToString())); //数字框

        //可以直接判断按钮的点击
        if (GUILayout.Button("修改所有物体名字"))
        {
            for (int i = 0; i < Selection.transforms.Length; i++) //遍历选中的元素
            {
                Undo.RecordObjects(Selection.gameObjects as GameObject[], "ChinarWindow_GameObject[]"); //Selection.gameObjects 返回一个GameObject[] ,并记录键(用于回退)
                Selection.transforms[i].SetSiblingIndex(i);                                             //为选择的物体设置下标
                Selection.transforms[i].name = CustomName + i;                                          //设置名字+i
            }
        }

        //判断按钮的点击
        if (GUILayout.Button("创建多个空物体"))
        {
            if (ChinarNum <= 0) //如果数字 小于等于 0
            {
                ShowNotification(new GUIContent("请写入创建空物体数量")); //提示 输入
            }
            else //不为0
            {
                for (int i = 0; i < ChinarNum; i++) //遍历个数
                {
                    Undo.RegisterCreatedObjectUndo(new GameObject(CustomName), "Chinar Create gameobject"); //创建一个名为 CustomName 的空物体
                }
            }
        }
    }
}

仔细看


END

本博客为非营利性个人原创,除部分有明确署名的作品外,所刊登的所有作品的著作权均为本人所拥有,本人保留所有法定权利。违者必究

对于需要复制、转载、链接和传播博客文章或内容的,请及时和本博主进行联系,留言,Email: ichinar@icloud.com

对于经本博主明确授权和许可使用文章及内容的,使用时请注明文章或内容出处并注明网址

相关文章
|
20天前
|
小程序
【微信小程序-原生开发】富文本编辑器 editor 的使用教程
【微信小程序-原生开发】富文本编辑器 editor 的使用教程
27 0
【微信小程序-原生开发】富文本编辑器 editor 的使用教程
|
26天前
|
Rust 图形学
【unity实战】使用unity制作一个类似Rust的3D生存建造建筑系统,具有很好的吸附性(附项目源码)
【unity实战】使用unity制作一个类似Rust的3D生存建造建筑系统,具有很好的吸附性(附项目源码)
27 1
|
23天前
|
JSON 搜索推荐 定位技术
地图主题编辑器使用教程
地图主题编辑器使用教程
17 0
|
26天前
|
图形学
【实现100个unity特效之4】Unity ShaderGraph使用教程与各种特效案例(下)
【实现100个unity特效之4】Unity ShaderGraph使用教程与各种特效案例
33 0
|
26天前
|
数据可视化 图形学 开发者
【实现100个unity特效之4】Unity ShaderGraph使用教程与各种特效案例(上)
【实现100个unity特效之4】Unity ShaderGraph使用教程与各种特效案例
60 0
|
26天前
|
图形学
【推荐100个unity插件之19】武器拖尾特效插件——Pocket RPG Weapon Trails(2d 3d通用)
【推荐100个unity插件之19】武器拖尾特效插件——Pocket RPG Weapon Trails(2d 3d通用)
21 0
|
26天前
|
图形学
【unity实战】3D水系统,游泳,潜水,钓鱼功能实现
【unity实战】3D水系统,游泳,潜水,钓鱼功能实现
47 0
|
26天前
|
图形学
【制作100个unity游戏之25】3D背包、库存、制作、快捷栏、存储系统、砍伐树木获取资源、随机战利品宝箱12(附带项目源码)
【制作100个unity游戏之25】3D背包、库存、制作、快捷栏、存储系统、砍伐树木获取资源、随机战利品宝箱12(附带项目源码)
9 0
|
19天前
|
开发工具
vi编辑器,现在vi\vim是文本文件进行编辑的最佳选择,Vim是vi的加强的版本,兼容vi的所有指令,vim编辑器有三种工作模式,一开始进入的是命令模式,命令模式i是插入的意思,两下y+p复制内容
vi编辑器,现在vi\vim是文本文件进行编辑的最佳选择,Vim是vi的加强的版本,兼容vi的所有指令,vim编辑器有三种工作模式,一开始进入的是命令模式,命令模式i是插入的意思,两下y+p复制内容
|
1月前
|
开发工具
Vim 编辑器:高效文本编辑的瑞士军刀
**Vim 概览:** Vim 是一个功能丰富的文本编辑器,以其高度可定制性著称。文章介绍了 Vim 的高效使用技巧,包括快捷打开文件、命令行模式下的常用命令、查找与替换、删除和复制文本。还讨论了配置 `.vimrc` 文件以自定义设置,如改变 leader 键、设置缩进和高亮,并展示了安装插件如 vim-airline 和 vim-snazzy 的方法。通过这些技巧,用户能提升 Vim 使用效率。
24 5