Rigidbody.SweepTest

参数

返回

bool 当刚体扫描与任何碰撞体交叠时为 true，否则为 false。

描述

测试如果刚体在场景中移动时，是否会与任何对象发生碰撞。

测试如果刚体在场景中移动时，是否会与任何对象发生碰撞。 这类似于对刚体的任何碰撞体包含的所有点进行 Physics.Raycast，并返回报告的最近的命中对象（如果有的话）。这对于 AI 代码非常有用，比如，您可能需要知道某个对象能否从一个间隙中穿过而不碰到任何东西。

注意，该函数仅在刚体对象附加了原始碰撞体类型（球体、立方体或胶囊体）或凸面网格时有效 - 对于凹面网格碰撞器无效（虽然可以通过扫描在场景中检测到它们）。

另请参阅：Physics.SphereCast、Physics.CapsuleCast、Rigidbody.SweepTestAll。

using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour
{
    public float collisionCheckDistance;
    public bool aboutToCollide;
    public float distanceToCollision;
    public Rigidbody rb;

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

    void Update()
    {
        RaycastHit hit;
        if (rb.SweepTest(transform.forward, out hit, collisionCheckDistance))
        {
            aboutToCollide = true;
            distanceToCollision = hit.distance;
        }
    }
}