Unity 脚本常用特性

最新推荐文章于 2024-10-03 11:26:55 发布

幽满谷

最新推荐文章于 2024-10-03 11:26:55 发布

阅读量1.7k

点赞数 5

分类专栏： Unity 文章标签： unity

本文链接：https://blog.csdn.net/youmangu/article/details/125526783

版权

Unity 专栏收录该内容

21 篇文章 1 订阅

订阅专栏

标记方法已过时

[system.obsolete(“注释”)]

把公有字段的隐藏

[HideInInspector]

提示, 鼠标放属性上会有提示内容

[Tooltip("xxxxx")]

添加标题

[Header("xxxxx")]

取值范围

[Range(minnum,maxNum)]

Space

[Space(10)]

public string a;

文本框扩大，超过最大行数会出现滚动条

[TextArea（最小行数，最大行数）]

实现一个变量多行显示，也可不加参数

[Multiline（5）]

为挂载脚本的物体的Inspector界面脚本添加一个脚本右键选项,点击执行方法内的逻辑

[ContextMenuItem]

例如下面脚本，在Inspector右键，Reset,即可重置变量为空。
[ContextMenuItem("Reset", "ResetString")]
public string abc;
public void ResetString()
{
abc = "";
}

ContextMenu 允许我们在Inspect检视面板对Component组件添加菜单功能。

[ContextMenu("Do Something")]
public void DoSomething()
{
   Debug.Log("Do Something.");
}

CreateAssetMenu

用于ScriptableObject的子类，将这个类（相当于资源文件添加到Asset菜单项中），关于ScriptableObject具体可以看这位大神的博客

在 Assets 下任意文件夹内，鼠标右键， Create -> New Bullet

序列化一个类，作为一个子属性显示在监视面板。

//在父类面板里 曝光子类public变量 或者内部类
class B{} 没有继承Mono
在父类里使用:
[Serializable]
public B b;

//让私有变量显示在Inspector面板 ,并且可以赋值
[SerializeField]  
private B b;

反序列化一个变量，并且在监视版上隐藏。

public变量不暴露显示在Inspector面板
[NonSerialized]
public B b;

修改Color的配置

颜色选择器，color picker，只能应用在Color字段上。默认参数为是否显示alpha，
参数： 
hdr：是否将颜色视为HDR颜色（默认为false） true显示透明通道,当== false)]隐藏透明通道此时alpha默认为1
minBrightness： 使用HDR颜色选择器时的最低允许HDR颜色分量值（默认值：0）。 
maxBrightness： 使用HDR颜色选择器时的最大允许HDR颜色分量值（默认值：8）。 
minExposureValue： HDR颜色选择器中允许的最小曝光值（默认值：1/8 = 0.125）。 
maxExposureValue： HDR颜色选择器中允许的最大曝光值（默认值：3）。
[ColorUsage(true, true, 0, 8, 0.125f, 3)]
public Color color3;
[ColorUsage(true)]//显示透明通道
public Color color1;

用于在脚本中使float，int或string变量的属性被延迟。只有按了回车或焦点离开字段才会返回新值。

[Delayed]
public float speed=3;

//修饰类型和方法，配置该属性，使它禁用自动Null检查和自动数组边界检查。这样可以加速代码的执行，有时可以大幅加快速度。

[Il2CppSetOptionAttribute(Option.NullChecks,false)]
void Function()
{
}

在运行时，当前类初始化完成，自动调用被该特性应用的静态函数,这和static静态构造函数还不一样，static静态构造函数是在所有的方法之前运行的，而RuntimeInitializeOnLoadMethod特性的方法是Awake方法之后执行的(如果是MonoBehaviour派生类)。如果一个类中有多个静态方法使用了RuntimeInitializeOnLoadMethod特性，执行顺序是不固定的。

[RuntimeInitializeOnLoadMethod]
static void OnAutoRun()
{
    Debug.Log("OnAutoRun");
}

第一次点击到父物体上（挂载到类上）

[SelectionBase]

描述

将此属性添加到脚本类，可将其 GameObject 标记为 Scene View 选取的选择基础对象。

在 Unity Scene View 中，当单击以选择对象时，Unity 将尝试找出为您选择的最佳对象。如果您单击作为预制件一部分的某个对象，则会选择该预制件的根，因为预制件根被视为选择基础。您也可以使其他对象被视为选择基础。您需要创建具有 SelectionBase 属性的脚本类，然后需要将该脚本添加到 GameObject。

创建菜单属性

[MenuItem(“菜单名/属性名”)]

创建菜单子节点

[AddComponentMenu(path)]

AddComponentMenu将脚本放到菜单栏Component的Scripts外的菜单中
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
 
[AddComponentMenu("MyComponentMenu/Test")]
public class Test : MonoBehaviour
{
 
}
添加上面的代码后，会发现 Component 菜单栏下多了 MyComponentMenu/Test 选项

访问网站

[HelpURL(“Https://xxxx.com”)]

编译正确后，然后点击脚本上的右边的“？”问号书本，即可跳转到刚才设定的帮助链接位置，具体如下图

重命名不丢失数据

[FormerlySerializedAs(“对象名”)]

例如：把 CameraSize01 的名字改为 CameraSize02，又不想让CameraSize01之前的设置数据丢失，可以这样
[FormerlySerializedAs("CameraSize01")]
public CameraSizeHandler CameraSize02;
详细示例如下：Unity FormerlySerializedAs的使用_海涛高软的博客-CSDN博客

在编辑模式下执行代码

[ExecuteInEditorMode]

使脚本的实例总是执行，无论是作为播放模式的一部分还是编辑时。

[ExecuteAlways]

提示：[ExecuteInEditorMode] 和 [ExecuteAlways] 的详细使用和说明可参考：Unity ExecuteInEditMode详解_弹吉他的小刘鸭的博客-CSDN博客_executeineditmode

防止将相同类型（或子类型）的 MonoBehaviour 多次添加到 GameObject。

[DisallowMultipleComponent]

属性捆绑

[RequireComponent(typeof(绑定的组件类型)]

提示：【DisallowMultipleComponent】和【RequireComponent】结合使用可避免添加错误脚本到GameObject上。
[DisallowMultipleComponent]
[RequireComponent(typeof(GraphicRaycaster))]
public class View :MonoBehaviour
{
}

程序集级别的属性。具有该属性的程序集中的任何类都将被视为编辑器类。

[AssemblyIsEditorAssembly]

脚本不挂载到游戏对象执行

通常情况下，新建的脚本要挂载到游戏对象上才能运行，如果在脚本中的方法前使用[RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.AfterSceneLoad)]，可以不用挂载到任何游戏对象上即可在程序运行时执行此方法，方便在在程序初始化前做一些额外的初始化工作。如下代码所示：
[RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.AfterSceneLoad)]
public static void DoSomething()
{
    Debug.Log("It's the start of the game");
}