Unity3D API之GameObject

在Unity场景中所有实体的基类。

最近在研究U3D的API，感觉太多了不好记，所以在此做了个整理。

全文基于Unity官方文档，萌新能力不足，如果有错误，欢迎指出_(:з」∠)_

[info]变量[/info]

activeInHierarchy

public bool activeInHierarchy;

返回一个bool值，判断游戏物体是否在程序运行时被激活。

如果父物体被禁用，那么无论面板中是否勾选上，都将返回false。

activeSelf

public bool activeSelf;【只读】

返回一个bool值，判断物体在本地活跃状态，不考虑父物体的状态。

即使返回true，如果父物体没有被启用，那么该物体也不会起作用。

isStatic

public bool isStatic;

返回一个bool值，判断物体是否为静态。

layer

public int layer;

游戏物体所在的层级，范围在[0,31]。

通常用来使摄像机有选择性的渲染或者忽略射线。

scene

public SceneManagement.Scene scene;

游戏物体所处的场景。

tag

public string tag;

游戏物体的标签。常用来区分游戏物体的类别。

transform

public Transform transform;

游戏物体的transform信息。

name 【继承】【父类：Object】

public string name;

游戏对象的名称。

组件和游戏对象共享的名称。

[info]构造器[/info]

注意：

创建游戏物体至少且必须会有一个Transform组件；

GameObject player;
player = new GameObject("Player");

[info] 实例方法[/info]

CompareTag

public bool CompareTag(string tag);

判断物体的标签是不是[kbd]tag[/kbd]。

if (other.gameObject.CompareTag("Player"))
            Destroy(other.gameObject);

（怎么感觉用处不大呢_(:з」∠)_ ）

GetComponent

此方法用于获取游戏物体中第一个符合Type类型的组件。

public T GetComponent<T>();【常用】

public Component GetComponent(Type type);

public Component GetComponent(string type);

Transform transform = GetComponent<Transform>();

使用字符串获取组件的方法可能效率较低，但是适用于从JavaScript中获取C#脚本之类的场合。

GetComponents

public Component[] GetComponents(Type type);

作用同上，不过返回的是组件集合。

注意：

在使用该方法时：

Components[] cjs = GetComponents(typeof(Example)) as Component[];   //正确

不可以这样写：

Components[] cjs = GetComponents(typeof(Example)) as Example[];     //错误

因为Example不是Component，而是其子类，建议使用其他泛型方式。

GetComponentsInChildren()同理。

GetComponentInChildren

获取子物体的组件；

List<HingeJoint> hingeJoints = new List<HingeJoint>();

GetComponentsInParent<HingeJoint>(false, hingeJoints);

SphereCollider sc = gameObject.AddComponent<SphereCollider>() as SphereCollider;
SphereCollider sc = gameObject.AddComponent(typeof(SphereCollider)) as SphereCollider;
SphereCollider sc = gameObject.AddComponent("SphereCollider") as SphereCollider;

gameObject.SetActive(false);

public class ExampleClass : MonoBehaviour {
    void ApplyDamage(float damage) {
        print(damage);
    }
    void Example() {
        gameObject.SendMessage("ApplyDamage", 5.0F);
    }
}

向一个游戏物体发送消息，调用该物体和其父物体的所有组件中的目标方法；

其他同上；

public class ExampleClass : MonoBehaviour {
    void ApplyDamage(float damage) {
        print(damage);
    }
    void Example() {
        gameObject.BroadcastMessage("ApplyDamage", 5.0F);
    }

public class ExampleClass : MonoBehaviour {
    public GameObject hand;
    void Example() {
        hand = GameObject.Find("Hand");
        hand = GameObject.Find("/Hand");
        hand = GameObject.Find("/Monster/Arm/Hand");
        hand = GameObject.Find("Monster/Arm/Hand");
    }
}

public class ExampleClass : MonoBehaviour {
    void Awake() {
        DontDestroyOnLoad(transform.gameObject);
    }
}

Instantiate(prefab, new Vector3(i * 2.0F, 0, 0), Quaternion.identity);

查找指定类型的对象。

GUITexture texture = (GUITexture)FindObjectOfType(typeof(GUITexture));

返回第一个找到的；

该方法效率较低，不建议每帧都调用；

FindObjectsOfType 【继承】【父类：Objective】

public static Object[] FindObjectsOfType(Type type);

查找指定类型的对象集合。

其他同上；

[info]操作符[/info]

bool

描述游戏物体是否存在。

public class ExampleClass : MonoBehaviour {
    void Example() {
        if (rigidbody)
            Debug.Log("Rigidbody attached to this transform");
        
    }
}

完