版本

作者

参与者

完成日期

备注

UnityAPI_Collider_V01_1.0

严立钻

2020.06.10

立钻哥哥：Unity是一个入门快、提高难的游戏引擎，想要提升能力，至少需要越过3道坎：API+Shader+综合能力；

++1、API的积累：对API的合理利用不仅可以减轻自己的编码负担，而且往往可以提高程序的运行效率；这也是钻哥开始“Unity API”独立打造分类的初衷；

++2、Shader编程：想要做出一款精品游戏往往需要有高效的Shader的支持；Unity提供了一套改良的“Shader Lab”系统，优化了繁杂的“Open GL”编程；

++3、综合能力（技术+业务+管理）：一款产品的制作除了功能编程外，往往会涉及很多其他领域，例如产品架构、UI交互设计、模型制作等，作为主要的编程人员，对其他相关领域的了解程序往往会影响到产品制作直至最后的产品体验；

++++立钻哥哥一直在推动【VR云游戏=Unity+SteamVR+云技术+5G+AI】，这个只是一个引子，抛砖引玉让大家对整个知识体系有一个明确的落地方向，宝宝们可以根据自己的兴趣方向进行拓展：比如Unity这里是指一种“3D游戏引擎”，也可拓展至“UE4、Cocos2dx”等游戏引擎；SteamVR是一种跨硬件解决方案，也可拓展至“VRTK”等第三方插件；“云技术+5G”是一种跨平台解决方案的核心技术，同样可拓展至其他平台解决方案；AI也是一种先进技术的举例，也可以拓展至任何一种前沿技术；

#Collider碰撞器

#Collider碰撞器

++A1、Description描述

++B2、Variables变量

++C3、Public Function共有函数

++D4、Message消息

#A1、Description描述

#B2、Variables变量

++B2、Variables变量

++++B2.1、attachedRigidbody

++++B2.2、bounds

++++B2.3、contactOffset

++++B2.4、enabled

++++B2.5、isTrigger

++++B2.6、material

++++B2.7、sharedMaterial

++++B2.8、YanlzXREngine.Collider.Variables

++B2.1、attachedRigidbody

public Rigidbody attachedRigidbody;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCollider : MonoBehaviour{

    void MyTestFunc(){

        GetComponent<Collider>().attachedRigidbody.AddForce(0, 1, 0);

    }    //立钻哥哥：void MyTestFunc(){}

}    //立钻哥哥：public class YanlzCollider{}

++B2.2、bounds

public Bounds bounds;

Debug.Log(GetComponent<Collider>().bounds);

++B2.3、contactOffset

public float contactOffset;

++B2.4、enabled

public bool enabled;

GetComponent<Collider>().enabled = false;

++B2.5、isTrigger

public bool isTrigger;

GetComponent<Collider>().isTrigger = true;

++B2.6、material

public PhysicMaterial material;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCollider : MonoBehaviour{

    public float dynFriction;

    public float statFriction;

    public Collider coll;

    void Start(){

        coll = GetComponent<Collider>();

        coll.material.dynamicFriction = dynFriction;

        coll.material.staticFriction = statFriction;

    }    //立钻哥哥：void Start(){}

}    //立钻哥哥：public class YanlzCollider{}

++B2.7、sharedMaterial

public PhysicMaterial sharedMaterial;

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCollider : MonoBehaviour{

    public PhysicMaterial material;

    public void Awake(){

        GetComponent<Collider>().sharedMaterial = material;

    }    //立钻哥哥：public void Awake(){}

}    //立钻哥哥：public class YanlzCollider{}

#C3、Public Functions公有函数

++C3、Public Functions公有函数

++++C3.1、ClosestPointOnBounds

++++C3.2、Raycast

++++C3.3、YanlzXREngine.Collider.PublicFunctions

++C3.1、ClosestPointOnBounds

public Vector3 ClosestPointOnBounds(Vector3 position);

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCollider : MonoBehaviour{

    public float hitPoints = 100.0F;

    public Collider coll;

    void Start(){

        coll = GetComponent<Collider>();

    }    //立钻哥哥：void Start(){}

    void MyApplyHitPoints(Vector3 explosionPos, float radius){

        //The distance from the explosion position to the surface of the collider.

        Vector3 closestPoint = coll.ClosestPointOnBounds(explosionPos);

        float distance = Vector3.Distance(closestPoint, explosionPos);

        //The damage should decrease with distance from the explosion.

        float damage = 1.0F - Mathf.Clamp01(distance / radius);

        hitPoints -= damage * 10.0F;

    }    //立钻哥哥：void MyApplyHitPoints(){}

}    //立钻哥哥：public class YanlzCollider{}

++C3.2、Raycast

public bool Raycast(Ray ray, out RaycastHit hitInfo, float maxDistance);

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCollider : MonoBehaviour{

    public Collider coll;

    void Start(){

        coll = GetComponent<Collider>();

    }    //立钻哥哥：void Start(){}

    void Update(){

        if(Input.GetMouseButtonDown(0)){

            Ray ray = Camera.main.ScreenPointToRay(Input.mousePosition);

            RaycastHit hit;

            if(coll.Raycast(ray, out hit, 100.0F)){

                transform.position = ray.GetPoint(100.0F);

            }    //立钻哥哥：if(coll.Raycast()){}

        }    //立钻哥哥：if(Input.GetMouseButtonDown()){}

    }    //立钻哥哥：void Update(){}

}    //立钻哥哥：public class YanlzCollider{}

#D4、Message消息

++D4、Message消息

++++D4.1、OnCollisionEnter

++++D4.2、OnCollisionExit

++++D4.3、OnCollisionStay

++++D4.4、OnTriggerEnter

++++D4.5、OnTriggerExit

++++D4.6、OnTriggerStay

++++D4.7、YanlzXREngine.Collider.Message

++D4.1、OnCollisionEnter

Collider.OnCollisionEnter(Collision collision);

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCollider : MonoBehaviour{

    void OnCollisionEnter(Collision collision){

        foreach(ContactPoint contact in collision.contacts){

            Debug.DrawRay(contact.point, contact.normal, Color.white);

        }

        if(collision.relativeVelocity.magnitude > 2){

            audio.Play();

        }

    }    //立钻哥哥：void OnCollisionEnter(){}

}    //立钻哥哥：public class YanlzCollider{}

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCollider : MonoBehaviour{

    public Transform explosionPrefab;

    void OnCollisionEnter(Collision collision){

        ContactPoint contact = collision.contacts[0];

        Quaternion rot = Quaternion.FromToRotation(Vector3.up, contact.normal);

        Vector3 pos = contact.point;

        Instantiate(explosionPrefab, pos, rot) as Transform;

        Destroy(gameObject);

    }    //立钻哥哥：void OnCollisionEnter(){}

}    //立钻哥哥：public class YanlzCollider{}

++D4.2、OnCollisionExit

Collider.OnCollisionExit(Collision collisionInfo);

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCollider : MonoBehaviour{

    void OnCollisionExit(Collision collisionInfo){

        Debug.Log(“立钻哥哥：No longer in contact with ” + collisionInfo.transform.name);

    }    //立钻哥哥：void OnCollisionExit(){}

}    //立钻哥哥：public class YanlzCollider{}

++D4.3、OnCollisionStay

Collider.OnCollisionStay(Collision collisionInfo);

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCollider : MonoBehaviour{

    void OnCollisionStay(Collision collisionInfo){

        foreach(ContactPoint contact in collisionInfo.contacts){

            Debug.DrawRay(contact.point, contact.normal * 10, Color.white);

        }

    }    //立钻哥哥：void OnCollisionStay(){}

}    //立钻哥哥：public class YanlzCollider{}

++D4.4、OnTriggerEnter

Collider.OnTriggerEnter(Collider other);

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCollider : MonoBehaviour{

    void OnTriggerEnter(Collider other){

        Destroy(other.gameObjects);

    }    //立钻哥哥：void OnTriggerEnter(){}

}    //立钻哥哥：public class YanlzCollider{}

++D4.5、OnTriggerExit

Collider.OnTriggerExit(Collider other);

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCollider : MonoBehaviour{

    void OnTriggerExit(Collider other){

        //Destroy everything that leaves the trigger

        Destroy(other.gameObject);

    }    //立钻哥哥：void OnTriggerExit(){}

}    //立钻哥哥：public class YanlzCollider{}

++D4.6、OnTriggerStay

Collider.OnTriggerStay(Collider other);

using UnityEngine;

using System.Collections;

using YanlzXREngine;

public class YanlzCollider : MonoBehaviour{

    //Applies an upwards force to all rigidbodies that enter the trigger.

    void OnTriggerStay(Collider other){

        if(other.attachedRigidbody){

            other.attachedRigidbody.AddForce(Vector3.up * 10);

        }

    }    //立钻哥哥：void OnTriggerStay(){}

}    //立钻哥哥：public class YanlzCollider{}

#E5、立钻哥哥对Collider类的拓展

立钻哥哥推荐的拓展学习链接（Link_Url）