Unity基础—射线概念和API

射线：射线是3D世界中一个点向一个方向发射的一条无终点的线，在发射轨迹中与其他物体发生碰撞时，它将停止发射 。

用途：射线应用范围比较广， 多用于碰撞检测（如：子弹飞行是否击中目标）、角色移动等 等。

Physics.Raycast 光线投射

JavaScript ⇒ public static function Raycast(origin: Vector3, direction: Vector3, maxDistance: float = Mathf.Infinity, layerMask: int = DefaultRaycastLayers): bool; 

function Update() {
	var ray = Camera.main.ScreenPointToRay (Input.mousePosition);
 
	if (Physics.Raycast (ray, 100)) {
		print ("I am good man");
	}
}




C# ⇒ public static bool Raycast(Vector3 origin, Vector3 direction, float maxDistance = Mathf.Infinity, int layerMask = DefaultRaycastLayers);

一个静态的发射射线的方法，在场景中投下可与所有碰撞器碰撞的一条光线。

using UnityEngine;
using System.Collections;
 
public class ExampleClass : MonoBehaviour {
    void Update() {
        Ray ray = Camera.main.ScreenPointToRay(Input.mousePosition);
        if (Physics.Raycast(ray, 100))
            print("I am good man");
 
    }
}

Parameters 参数解释：

 

Parameters参数

origin	The starting point of the ray in world coordinates. 在世界坐标，射线的起始点。
direction	The direction of the ray. 射线的方向。
distance	The length of the ray. 射线的长度。
layerMask	A Layer mask that is used to selectively ignore colliders when casting a ray. 当投射线时，layerMask用来选择忽略碰撞器。

   layerMask:只选定Layermask层内的碰撞器，其它层内碰撞器忽略。

返回布尔类型，当光线投射与任何碰撞器交叉时为真，否则为假。

（注意：如果从一个球型体的内部到外部用光线投射，返回为假。 ）这一点测试不成功！

Returns 返回

bool True when the ray intersects any collider, otherwise false.

当光线投射与任何碰撞器交叉时为真，否则为假。

Description 描述

Same as above using /ray.origin/ and /ray.direction/ instead of origin and direction.

使用ray.origin和ray.direction同上，替代origin和direction。

相关API：

1、Ray Camera.main.ScreenPointToRay(Vector3 pos)   返回一条射线Ray从摄像机到屏幕指定一个点

2、Ray Camera.main.ViewportPointToRay(Vector3 pos)  返回一条射线Ray从摄像机到视口（视口之外无效）指定一个点

3、Ray 射线类 

4、RaycastHit 光线投射碰撞信息

5、bool Physics.Raycast(Vector3 origin, Vector3 direction, float distance, int layerMask)

    当光线投射与任何碰撞器交叉时为真，否则为假。

    bool Physics.Raycast(Ray ray, Vector3 direction, RaycastHit out hit, float distance, int layerMask)

    在场景中投下可与所有碰撞器碰撞的一条光线，并返回碰撞的细节信息()。

    bool Physics.Raycast(Ray ray, float distance, int layerMask)

    当光线投射与任何碰撞器交叉时为真，否则为假。

    bool Physics.Raycast(Vector3 origin, Vector3 direction, RaycastHit out hit,float distance, int layerMask)

    当光线投射与任何碰撞器交叉时为真，否则为假。

 

    注意：如果从一个球型体的内部到外部用光线投射，返回为假。

6、RaycastHit[] RaycastAll(Ray ray, float distance, int layerMask)

   投射一条光线并返回所有碰撞，也就是投射光线并返回一个RaycastHit[]结构体。

下面一个利用射线做的拾取的小例子（将代码直接拖拽到主相机上）

using UnityEngine;
using System.Collections;

public class RayTest : MonoBehaviour {

    // Use this for initialization
    void Start () {
    
    }
    
    // Update is called once per frame
    void Update () 
    {
        if(Input.GetMouseButton(0))
        {
            Ray ray = Camera.main.ScreenPointToRay(Input.mousePosition);//从摄像机发出到点击坐标的射线
            RaycastHit hitInfo;
            if(Physics.Raycast(ray,out hitInfo))
            {
                Debug.DrawLine(ray.origin,hitInfo.point);//划出射线，只有在scene视图中才能看到
                GameObject gameObj = hitInfo.collider.gameObject;
                Debug.Log("click object name is " + gameObj.name);
                if(gameObj.tag == "boot")//当射线碰撞目标为boot类型的物品 ，执行拾取操作
                {
                    Debug.Log("pick up!");
                }
            }
        }
    }
}