Rigidbody.SweepTest

パラメーター

戻り値

bool リジッドボディが他のコライダーを横切ってスイープする場合は true を返します。その他の場合は false を返します。

説明

Rigidbody オブジェクトが特定の方向でオブジェクトと衝突するかテストします

Rigidbody オブジェクトが特定の方向でオブジェクトと衝突するかテストします これは、リジッドボディのコライダーのいずれかに含まれるすべてのポイントに対する Physics.Raycast の実行や、（一つでもあれば）報告されたすべての衝突の中でもっとも近いものを返すのに似ています。これは、まったく衝突することなくオブジェクトがどこかに当てはまるかを知る必要がある場合の AI のコードに便利です。

この関数はプリミティブコライダー型（球、キューブまたはカプセル）や凹面メッシュがリジッドボディオブジェクトにアタッチされている場合にのみ動作することに注意してください。つまり、メッシュコライダーはスイープによってシーン内で検知することはできますが、動作はしません。

See Also: 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;
        }
    }
}