Unity API 解析—— GameObject 类

GameObject 类是Unity场景中所有实体的基类。一个GameObject对象通常由多个组件component组成，且至少含有一个transform组件。

activeSelf 属性 —— GameObject的Active标识

activeInHierarchy 属性的功能是返回GameObject实例在程序运行时的激活状态，它只有当GameObect实例的状态被激活时才会返回true。而且它会受父类对象激活状态的影响。如果其父类至最顶层的对象中有一个对象未被激活，activeInHierarchy就会返回false

using UnityEngine;
using System.Collections;

public class ActiveSelf_ts : MonoBehaviour {
    public GameObject cube1, cube2, cube3;
    void Start () {
    // 对cube2设置为false，其他设置为true
    cube1.SetActive(true);
    cube2.SetActive(false);
    cube3.SetActive(true);

    Debug.Log("activeSelf:");
    // 尽管cube2被设置为false，但其子类cube3的activeSelf返回值仍然为true
    Debug.Log("cube1.activeSelf:" + cube1.activeSelf);
    Debug.Log("cube2.activeSelf:" + cube2.activeSelf);
    Debug.Log("cube3.activeSelf:" + cube3.activeSelf);

    Debug.Log("nactiveInHierarchy:");
    // cube2 和 cube3的activeInHierarchy返回值都为false
    Debug.Log("cube1.activeInHierarchy:" + cube1.activeInHierarchy);
    Debug.Log("cube2.activeInHierarchy:" + cube2.activeInHierarchy);
    Debug.Log("cube3.activeInHierarchy:" + cube3.activeInHierarchy);

    }
}

---

GameObject 构造方法

public GameObject();

public GameObject(string name);

public GameObject(string name,params Type[] components)

using UnityEngine;
using System.Collections;

public class Constructors_ts : MonoBehaviour {
    void Start () {
    // 使用构造函数 GameObject (name : String)
    GameObject g1 = new GameObject("G1");
    g1.AddComponent();
    // 使用构造函数 GameObject () 
    GameObject g2 = new GameObject();
    g2.AddComponent();
    // 使用构造函数 GameObject (name : String, params components : Type[])
    GameObject g3 = new GameObject("G3",typeof(MeshRenderer),typeof(Rigidbody),typeof(SpringJoint));

    Debug.Log("g1 name:" + g1.name + "nPosition:" + g1.transform.position);
    Debug.Log("g2 name:" + g2.name + "nPosition:" + g2.transform.position);
    Debug.Log("g3 name:" + g3.name + "nPosition:" + g3.transform.position);
    }
}

---

GameObject 类实例方法

GetComponent 方法 —— 获取组件

public T GetComponent() where T: Component;

public Component GetComponent(string type);

public Component GetComponent(Type type);

using UnityEngine;
using System.Collections;

public class GetComponent_ts : MonoBehaviour {
    void Start () {
    Debug.Log("以下是GetComponent 的相关使用代码。n GetComponet 方法用来获取当前GameObject中符合Type类型的第一个组件");
    //GetComponent (type : Type)
    Rigidbody rb = GetComponent(typeof(Rigidbody))as Rigidbody;
    Debug.Log("使用 GetComponent (type : Type) 获取 Rigidbody" + rb.GetInstanceID());

    //GetComponent.()
    rb=GetComponent();
    Debug.Log("使用 GetComponent.()获取 Rigidbody" + rb.GetInstanceID());

    //GetComponent (type : String)
    rb = GetComponent("Rigidbody") as Rigidbody;
    Debug.Log("使用 GetComponent (type : String)获取 Rigidbody" + rb.GetInstanceID());

    Debug.Log("以下是GetComponentInChildren的相关使用代码。n GetComponentInChildren 方法来获取当前GameObject的所有子类中符合Type类型的第一个组件");

    //GetComponentInChildren (type : Type)
    rb = GetComponentInChildren(typeof(Rigidbody)) as Rigidbody;
    Debug.Log("使用GetComponentInChildren (type : Type)获取Rigidbody " + rb.name);

    //GetComponentInChildren. ()
    rb=GetComponentInChildren();
    Debug.Log("使用GetComponentInChildren.()获取Rigidbody " + rb.name);

    //GetComponents (type : Type)
    Component[] cjs = GetComponents(typeof(ConfigurableJoint)) as Component[];
    foreach(ConfigurableJoint cj in cjs){
        Debug.Log("使用GetComponents (type : Type)获取ConfigurableJoint " + cj.GetInstanceID());
    }

    //GetComponents. ()
    cjs = GetComponents();
    foreach (ConfigurableJoint cj in cjs)
    {
        Debug.Log("使用GetComponents.()获取ConfigurableJoint " + cj.GetInstanceID());
    }


    //GetComponentsInChildren(type: Type, includeInactive: boolean = false)
    cjs = GetComponentsInChildren(typeof(ConfigurableJoint), false) as Component[];
    foreach (ConfigurableJoint cj in cjs)
    {
        Debug.Log("使用GetComponentsInChildren(type: Type, false)获取ConfigurableJoint " + cj.name);
    }

    cjs = GetComponentsInChildren(typeof(ConfigurableJoint), true) as Component[];
    foreach (ConfigurableJoint cj in cjs)
    {
        Debug.Log("使用GetComponentsInChildren(type: Type, true)获取ConfigurableJoint " + cj.name);
    }

    //GetComponentsInChildren. (includeInactive : boolean)
    cjs = GetComponentsInChildren(true);
    foreach (ConfigurableJoint cj in cjs)
    {
        Debug.Log("使用GetComponentsInChildren.(includeInactive : boolean)获取ConfigurableJoint " + cj.name);
    }

    //GetComponentsInChildren. ()
    cjs = GetComponentsInChildren();
    foreach (ConfigurableJoint cj in cjs)
    {
        Debug.Log("使用GetComponentsInChildren.()获取ConfigurableJoint " + cj.name);
    }
    }
}

---

SendMessage 方法：发送消息

和自身同级的物体不会收到消息

SendMessageOptions 有两个可选方式：SendMessageOptions.RequireReceiver 和 SendMessageOptions.DontRequireReceiver 前者要求信息的接收方必须有接收信息的方法，否则程序报错，后者无此要求

BroadcastMessage 向自身以及所有子类发送消息，和自身同级的物体不会收到消息

SendMessageUpwards 方法的功能是向GameObject 自身及其所有父类发送消息，和自身同级的物体不会受到消息

using UnityEngine;
using System.Collections;

public class SendMessageUpward_ts : MonoBehaviour {
    void Start () {
        // 向父类及自己发送消息
        gameObject.SendMessageUpwards("GetChildrenMessage", gameObject.name + ":use SendMessageUpwards send!");

        // 向子类及自己发送消息
        gameObject.BroadcastMessage ("GetParentMessage ",gameObject.name +":use BroadcastMessage send");

        // 向自己发送消息
        gameObject.SendMessage ("GetSelfMessage",gameObject.name +" : use SendMessage send");
    }
    private void GetParentMessage(string str)
    {
        Debug.Log(gameObject.name + "收到父类发送的消息" + str);
    }

    private void GetSelfMessage(string str)
    {
        Debug.Log(gameObject.name + "受到自身发送的消息" + str);
    }

    private void GetChildrenMessage(string str)
    {
        Debug.Log(gameObject.name + "受到子类发送的消息" + str);
    }
}

---

CreatePrimitive —— 创建GameObject 对象

静态方法

using UnityEngine;
using System.Collections;

public class CreatePrimitive_ts : MonoBehaviour
{
    void Start()
    {
    // 使用GameObject.CreatePrimitive方法创建 GameObject
    GameObject g1 = GameObject.CreatePrimitive(PrimitiveType.Sphere);
    g1.name = "G1";
    g1.tag = "sphere_Tag";
    // 使用 AddComponent (className : String)添加组件
    g1.AddComponent("SpringJoint");
    // 使用AddComponent (componentType : Type)添加组件
    g1.AddComponent(typeof(GUITexture));
    g1.transform.position = Vector3.zero;

    GameObject g2 = GameObject.CreatePrimitive(PrimitiveType.Sphere);
    g2.name = "G2";
    g2.tag = "sphere_Tag";
    // 使用AddComponent.() 添加组件
    g2.AddComponent();
    g2.transform.position = 2.0f * Vector3.right;
    g2.GetComponent().useGravity = false;

    GameObject g3 = GameObject.CreatePrimitive(PrimitiveType.Sphere);
    g3.name = "G1";
    g3.tag = "sphere_Tag";
    g3.transform.position = 4.0f * Vector3.right;

    // 使用GameObject.FindÀ类方法获取GameObject，返回符合条件的第一个对象
    Debug.Log("use Find:" + GameObject.Find("G1").transform.position);
    // 使用GameObject.FindGameObjectWithTag类方法获取GameObject，返回符合条件的第一个对象
    Debug.Log("use FindGameObjectWithTag:" + GameObject.FindGameObjectWithTag("sphere_Tag").transform.position);
    // 使用GameObject.FindGameObjectsWithTag类方法获取GameObject，返回符合条件的所有对象
    GameObject[] gos = GameObject.FindGameObjectsWithTag("sphere_Tag");
    foreach (GameObject go in gos)
    {
        Debug.Log("use FindGameObjectsWithTag:" + go.name + ":" + go.transform.position);
    }

            // 更改 g1，g2，和g3的层级关系
    g3.transform.parent = g2.transform;
    g2.transform.parent = g1.transform;

    Debug.Log("use Find again1:" + GameObject.Find("G1").transform.position);
    // 使用“/” 限定条件的方式查找GameObject
    Debug.Log("use Find again2:" + GameObject.Find("/G1/G2/G1").transform.position);
    }
}

---

若要获取当前脚本所在GameObject对象中的某个组件，直接使用GetCompoent方法即可，如

Rigidbody br = GetComponent()

若要获取非当前脚本所在GameObject对象中的某个组件，则需要有GameObject作为前置引用，如变量go为指向GameObject对象的引用，则

Rigidbody br = go.GetComponent()

using UnityEngine;
using System.Collections;

public class GameObjectAndComponent_ts : MonoBehaviour {
    public GameObject sp;
    void Start () {
    //以下3种表达方式功能相同
    Rigidbody rb1 = rigidbody;
    Rigidbody rb2 = GetComponent();
    Rigidbody rb3 = rigidbody.GetComponent();
    Debug.Log("rb1µÄInstanceID£º" + rb1.GetInstanceID());
    Debug.Log("rb2µÄInstanceID£º" + rb2.GetInstanceID());
    Debug.Log("rb3µÄInstanceID£º" + rb3.GetInstanceID());

    // 使用前置引用获取引用对象的Rigidbody组件
    Debug.Log("前置引用sp对象中Rigidbody的InstanceID "+sp.GetComponent().GetInstanceID());
    }
}