游戏蛮牛学习群(纯技术交流,不闲聊):159852603
游戏蛮牛 手机端
开启辅助访问
 找回密码
 注册帐号

扫一扫,访问微社区

开发者专栏

关注:2332

当前位置:游戏蛮牛 技术专区 开发者专栏

__________________________________________________________________________________
开发者干货区版块规则:

  1、文章必须是图文形式。(至少2幅图)
      2、文章字数必须保持在1500字节以上。(编辑器右下角有字数检查)
      3、本版块只支持在游戏蛮牛原创首发,不支持转载。
      4、本版块回复不得无意义,如:顶、呵呵、不错......【真的会扣分的哦】
      5、......
__________________________________________________________________________________
查看: 2382|回复: 18

[海澜] Unity-Attributes-自带特性

[复制链接]  [移动端链接]
排名
11619
昨日变化
3

9

主题

25

帖子

190

积分

Rank: 9Rank: 9Rank: 9

UID
164034
好友
0
蛮牛币
3781
威望
0
注册时间
2016-8-24
在线时间
76 小时
最后登录
2018-7-30
发表于 2018-4-29 18:01:18 | 显示全部楼层 |阅读模式

马上注册,结交更多好友,享用更多功能,让你轻松玩转社区。

您需要 登录 才可以下载或查看,没有帐号?注册帐号

x
# AddComponentMenu

> AddComponentMenu属性允许您将脚本放置在“组件”菜单中的任何位置,而不仅仅是“组件 - >脚本”菜单。
您可以使用它来更好地组织“组件”菜单,这样可以在添加脚本时改进工作流程。重要提示:您需要重新启动。

*  **componentOrder**   组件菜单中的组件顺序(低于顶部)。
* **AddComponentMenu**  在“组件”菜单中添加一个项目。
```
using UnityEngine;

[AddComponentMenu("Transform/Follow Transform")]
public class FollowTransform : MonoBehaviour
{
}
```
#### 效果如下
![](?imageMogr2/auto-orient/strip)

# AssemblyIsEditorAssembly
> 装配级属性。具有此属性的程序集中的任何类将被视为编辑器类。
**构造函数**
[AssemblyIsEditorAssembly](https://docs.unity3d.com/ScriptReference/AssemblyIsEditorAssembly-ctor.html)

# ContextMenu
> ContextMenu属性允许您向上下文菜单添加命令。在所附脚本的督察中。当用户选择上下文菜单时,将执行该功能。这对于自动从脚本设置场景数据是最有用的。该功能必须是非静态的。
```
using UnityEngine;

public class ContextTesting : MonoBehaviour
{
    /// Add a context menu named "Do Something" in the inspector
    /// of the attached script.
    [ContextMenu("Do Something")]
    void DoSomething()
    {
        Debug.Log("Perform operation");
    }
}
```

* [ContextMenu](https://docs.unity3d.com/ScriptReference/ContextMenu-ctor.html) 将功能添加到组件的上下文菜单。
#### 效果如下

![](?imageMogr2/auto-orient/strip)


# ContextMenuItemAttribute
> 使用此属性将上下文菜单添加到调用命名方法的字段。
```
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour
{
    [ContextMenuItem("Reset", "ResetBiography")]
    [Multiline(8)]
    public string playerBiography = "";
    void ResetBiography()
    {
        playerBiography = "";
    }
}
```
#### 效果如下
![](?imageMogr2/auto-orient/strip)

# CreateAssetMenu
> [fileName](https://docs.unity3d.com/ScriptReference/CreateAssetMenuAttribute-fileName.html)
新创建的此类实例使用的默认文件名。(创建文件必须以 .asset 结尾)
[menuName](https://docs.unity3d.com/ScriptReference/CreateAssetMenuAttribute-menuName.html)
此类型显示的名称显示在“资产/创建”菜单中。
[order](https://docs.unity3d.com/ScriptReference/CreateAssetMenuAttribute-order.html)
菜单项在资产/创建菜单中的位置。

```
using UnityEngine;

[CreateAssetMenu(fileName = "自定义资源.asset", menuName = "菜单/子项0")]
public class CreateAsset : ScriptableObject
{
    public string Name = "自定义资源";

    public Vector3[] Pos = new Vector3[10];
}
```

#### 效果如下
![](?imageMogr2/auto-orient/strip)

# DelayedAttribute
> 用于在脚本中使float,int或string变量的属性被延迟。

当使用此属性时,float,int或text字段将不会返回一个新的值,直到用户按下enter或焦点离开该字段。

```
using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class DelayedAttributeExample : MonoBehaviour
{
    [DelayedAttribute()]
    public string content;

}
```
#### 效果如下
![](?imageMogr2/auto-orient/strip)

# DisallowMultipleComponent
> 防止将相同类型(或子类型)的MonoBehaviour多次添加到GameObject。
```
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
[DisallowMultipleComponent]
public class Disallow : MonoBehaviour
{

}
```

#### 效果如下
![](?imageMogr2/auto-orient/strip)


# ExecuteInEditMode
> 使脚本的所有实例在编辑模式下执行。

默认情况下,MonoBehaviours只能在播放模式下执行。
通过添加此属性,MonoBehaviour的任何实例将在编辑器不处于播放模式时执行其回调函数。

这些功能不会像播放模式一样被调用。

[更新](https://docs.unity3d.com/ScriptReference/MonoBehaviour.Update.html)仅在场景中的某些内容更改时才调用。当游戏视图接收到一个[事件](https://docs.unity3d.com/ScriptReference/Event.html)时,[OnGUI](https://docs.unity3d.com/ScriptReference/MonoBehaviour.OnGUI.html)被调用。[OnRenderObject](https://docs.unity3d.com/ScriptReference/MonoBehaviour.OnRenderObject.html)和其他渲染回调函数在场景视图或游戏视图的每次重绘时都被调用。
另请参见:[runInEditMode](https://docs.unity3d.com/ScriptReference/MonoBehaviour-runInEditMode.html)。
```
using UnityEngine;

[ExecuteInEditMode]
public class PrintAwake : MonoBehaviour
{
    void Awake()
    {
        Debug.Log("Editor causes this Awake");
    }

    void Update()
    {
        Debug.Log("Editor causes this Update");
    }
}
```

#### 效果如下
![](?imageMogr2/auto-orient/strip)

# GUITargetAttribute
> 控制对应的OnGUI在那个Display上显示
```
using UnityEngine;
public class ExampleClass1 : MonoBehaviour
{
    // Label will appear on display 0 and 1 only
    [GUITarget(0, 1)]
    void OnGUI()
    {
        GUI.Label(new Rect(10, 10, 300, 100), "Visible on TV and Wii U GamePad only");
    }
}
```

#### 效果如下

![](?imageMogr2/auto-orient/strip)

# HeaderAttribute
> 在Inspector 中显示属性对应属性的注释
使用此
[PropertyAttribute](https://docs.unity3d.com/ScriptReference/PropertyAttribute.html)在检查器中的某些字段上方添加标题。
标题是使用[DecoratorDrawer](https://docs.unity3d.com/ScriptReference/DecoratorDrawer.html)完成的。

```
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour
{
    [Header("生命 Settings")]
    public int health = 0;
    public int maxHealth = 100;
    [Header("防御 Settings")]
    public int shield = 0;
    public int maxShield = 0;
}
```

#### 效果如下
![](?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

# HelpURLAttribute
> 帮助图标对应跳转的URL(注意此类需要继承MonoBehaviour,不继承在2017测试跳转地址无效)

```
using UnityEngine;
using UnityEditor;

[HelpURL("http://www.jianshu.com/u/84e03bc5c4a6")]
public class MyComponent:MonoBehaviour
{
}
```

#### 效果如下
![](?imageMogr2/auto-orient/strip)

# HideInInspector
> 隐藏在Inspector面板中显示的Public属性
```
using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour
{
    [HideInInspector]
    public int Hide = 0;

    [Header("生命 Settings")]
    public int health = 0;
    public int maxHealth = 100;
    [Header("防御 Settings")]
    public int shield = 0;
    public int maxShield = 0;
}
```

####效果如下

![](?imageMogr2/auto-orient/strip)

# ImageEffectAllowedInSceneView
> 具有此属性的任何图像效果可以渲染到场景视图相机中。
如果您希望将图像效果应用于场景视图相机,则会添加此属性。效果将应用于相同的位置,并且具有与相机效果相同的值。(5.4开始新加的特性,目前不知道怎么用)

# MultilineAttribute
> 用于使字符串值的属性显示在多行文本区域中。
```
using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class Example1 : MonoBehaviour
{
    [MultilineAttribute(10)]
    public string str = "";

}
```
#### 效果如下

![](?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)


# PreferBinarySerialization
> 这对于包含大量数据的自定义资产类型很有用。始终保持存储为二进制可以提高读/写性能,并在磁盘上生成更紧凑的表示。(说白了就是一二进制形式保存提高性能)

```
using UnityEngine;


[CreateAssetMenu]
[PreferBinarySerialization]
public class CustomData : ScriptableObject
{
    public float[] lotsOfFloatData = new[] { 1f, 2f, 3f };
    public byte[] lotsOfByteData = new byte[] { 4, 5, 6 };
}
```

# PropertyAttribute
> 派生自定义属性属性的基类。
使用它来创建脚本变量的自定义属性。

自定义属性可以与自定义的
[PropertyDrawer(https://docs.unity3d.com/2017.2/Documentation/ScriptReference/PropertyDrawer.html)类挂钩,以控制如何在Inspector中显示具有该属性的脚本变量。
另请参见:[PropertyDrawer](https://docs.unity3d.com/2017.2/Documentation/ScriptReference/PropertyDrawer.html)类。

# RangeAttribute
> 用于在脚本中创建一个float或int变量的属性被限制在一个特定的范围内。
当使用此属性时,float或int将在Inspector中显示为滑块,而不是默认数字字段

```
using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class Example1 : MonoBehaviour
{
    [RangeAttribute(0,1000f)]
    public int speed;
}
```
#### 效果如下

![](?imageMogr2/auto-orient/strip)

# RequireComponent
> RequireComponent属性自动将所需组件添加为依赖关系。
当您将一个使用RequireComponent的脚本添加到GameObject时,所需的组件将自动添加到GameObject中。这有助于避免安装错误。例如,脚本可能需要将Rigidbody总是添加到同一个GameObject中。使用RequireComponent这将自动完成,因此您永远不会得到设置错误。请注意,RequireComponent仅在组件添加到GameObject的时刻检查缺少的依赖关系。GameObject缺少新依赖关系的组件的现有实例将不会自动添加这些依赖关系。(自动添加指定组建,有组件的不添加,没有的添加)

```
using UnityEngine;

[RequireComponent(typeof(Rigidbody))]
public class PlayerScript : MonoBehaviour
{
    Rigidbody rb;

    void Start()
    {
        rb = GetComponent<Rigidbody>();
    }

    void FixedUpdate()
    {
        rb.AddForce(Vector3.up);
    }
}
```
#### 效果如下
![](?imageMogr2/auto-orient/strip)

# RuntimeInitializeOnLoadMethodAttribute
> 允许运行时类方法在运行时加载游戏时被初始化,而不需要用户的操作。
标记[RuntimeInitializeOnLoadMethod]的方法在游戏加载后被调用。这是在Awake方法被调用之后。
注意:[RuntimeInitializeOnLoadMethod]不保证标记的方法的执行顺序。调用的方法需静态


**场景加载前调用**     
```
[RuntimeInitializeOnLoadMethodAttribute(RuntimeInitializeLoadType.BeforeSceneLoad)]
```
**场景加载后调用**  
```
[RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.AfterSceneLoad)]
```   

```
// Create a non-MonoBehaviour class which displays
// messages when a game is loaded.
using UnityEngine;

class MyClass
{
    [RuntimeInitializeOnLoadMethod]
    static void OnRuntimeMethodLoad()
    {
        Debug.Log("场景加载和游戏运行后");
    }

    [RuntimeInitializeOnLoadMethod]
    static void OnSecondRuntimeMethodLoad()
    {
        Debug.Log("SecondMethod场景加载和游戏运行后");
    }
}
```

#### 效果如下

![](?imageMogr2/auto-orient/strip)

# SelectionBaseAttribute
> 将此属性添加到脚本类以将其GameObject标记为用于场景视图挑选的选择基础对象。
在Unity Scene View中,单击选择对象时,Unity将尝试找出最适合您选择的对象。如果单击作为预制体一部分的对象,则选择预制根的根,因为预制根被视为选择库。您也可以使其他对象也被视为选择库。您需要使用SelectionBase属性创建一个脚本类,然后您需要将该脚本添加到GameObject中。

```
using UnityEngine;

[SelectionBase]
public class PlayerScript : MonoBehaviour
{

}
```
#### 效果如下

![](?imageMogr2/auto-orient/strip)

# SerializeField
> 在Inspector可以看到标记为private的属性
```
using UnityEngine;

public class SomePerson : MonoBehaviour
{
    //This field gets serialized because it is public.
    public string firstName = "John";

    //This field does not get serialized because it is private.
    private int age = 40;

    //This field gets serialized even though it is private
    //because it has the SerializeField attribute applied.
    [SerializeField]
    private bool hasHealthPotion = true;

    void Start()
    {
        if (hasHealthPotion)
            Debug.Log("Person's first name: " + firstName + " Person's age: " + age);
    }
}
```

#### 效果如下
![](?imageMogr2/auto-orient/strip)

# SharedBetweenAnimatorsAttribute
> SharedBetweenAnimatorsAttribute是一个属性,指定该StateMachineBehaviour应仅实例化一次,并在所有Animator实例之间共享。
此属性减少每个控制器实例的内存占用。

程序员可以选择哪个StateMachineBehaviour可以使用此属性。
请注意,如果您的StateMachineBehaviour更改一些成员变量,它将影响使用它的所有其他Animator实例。
另请参见:[StateMachineBehaviour](https://docs.unity3d.com/2017.2/Documentation/ScriptReference/StateMachineBehaviour.html)类。
```
using UnityEngine;

[SharedBetweenAnimators]
public class AttackBehaviour : StateMachineBehaviour
{
    public override void OnStateEnter(Animator animator, AnimatorStateInfo stateInfo, int layerIndex)
    {
        Debug.Log("OnStateEnter");
    }
}
```

# SpaceAttribute
> 使用此
[PropertyAttribute](https://docs.unity3d.com/2017.2/Documentation/ScriptReference/PropertyAttribute.html)在检查器中添加一些间距。
间距使用[DecoratorDrawer](https://docs.unity3d.com/2017.2/Documentation/ScriptReference/DecoratorDrawer.html)完成。

```
using UnityEngine;
using System.Collections;

public class ExampleClass2 : MonoBehaviour
{
    public int health = 0;
    public int maxHealth = 100;
  [Space(10)]
    public int shield = 0;
    public int maxShield = 0;
}
```

#### 效果如下

![](?imageMogr2/auto-orient/strip)

# TextAreaAttribute
> 使用高度灵活和可滚动的文本区域编辑字符串的属性。
您可以指定TextArea的最小和最大行,并且字段将根据文本的大小进行扩展。如果文本大于可用区域,则会显示一个滚动条。

```
using UnityEngine;

public class TextAreaExample : MonoBehaviour
{
    [TextArea()]
    public string MyTextArea;
}
```
#### 效果如下
![](?imageMogr2/auto-orient/strip)

# TooltipAttribute
> 在“检查器”窗口中指定一个字段的工具提示。

```
using UnityEngine;
using System.Collections;

public class ExampleClass3 : MonoBehaviour
{
    [Tooltip("Health 值 从 0 到 100.")]
    public int health = 0;
}
```
#### 效果如下
![](?imageMogr2/auto-orient/strip)

# UnityAPICompatibilityVersionAttribute
> 声明一个程序集与特定的Unity API兼容(API明智)。由内部工具使用,以避免处理程序集,以确定程序集是否可能使用旧的Unity API。
(目前没弄明白怎么用)


本帖被以下淘专辑推荐: