Physics2D.Raycast

Бросает луч на коллайдеры в Scene.

A рейкаст Концептуально это как лазерный луч, который выстреливается из точки в пространстве в определенном направлении. Любой объект, контактирующий с лучом, может быть обнаружен и сообщен.

Эта функция возвращает объект RaycastHit2D со ссылкой на объект Collider, по которому попадает луч (свойство Collider результата будет NULL, если ничего не попало). layerMask может использоваться для выборочного обнаружения объектов только на определенных слоях (это позволяет применять обнаружение только к вражеским персонажам, например).

Перегрузки этого метода, которые используют contactFilter можно фильтровать результаты по параметрам, доступным в ContactFilter2D.

Потоки лучей полезны для определения линии обзора, целей, попадающих под огонь, и для многих других целей в игре.

Кроме того, это также обнаружит Collider(s) в начале луча. В этом случае, луч начинается внутри Collider и не пересекает поверхность Collider. Это означает, что нормаль столкновения не может быть вычислена, в этом случае возвращаемая нормаль столкновения устанавливается на обратную величину тестируемого вектора луча. Это легко обнаружить, потому что такие результаты всегда находятся в RaycastHit2D доле от нуля.

NOTE: Все результаты отсортированы в порядке возрастания расстояния i.e. первый результат является ближайшим.

Дополнительные ресурсы: LayerMask class, RaycastHit2D class, RaycastAll, Linecast, DefaultRaycastLayers, IgnoreRaycastLayer, raycastsHitTriggers.

using UnityEngine;

public class Example : MonoBehaviour
{
    // Float a rigidbody object a set distance above a surface.

    public float floatHeight;     // Desired floating height.
    public float liftForce;       // Force to apply when lifting the rigidbody.
    public float damping;         // Force reduction proportional to speed (reduces bouncing).

    Rigidbody2D rb2D;


    void Start()
    {
        rb2D = GetComponent<Rigidbody2D>();
    }

    void FixedUpdate()
    {
        // Cast a ray straight down.
        RaycastHit2D hit = Physics2D.Raycast(transform.position, -Vector2.up);

        // If it hits something...
        if (hit)
        {
            // Calculate the distance from the surface and the "error" relative
            // to the floating height.
            float distance = Mathf.Abs(hit.point.y - transform.position.y);
            float heightError = floatHeight - distance;

            // The force is proportional to the height error, but we remove a part of it
            // according to the object's speed.
            float force = liftForce * heightError - rb2D.linearVelocity.y * damping;

            // Apply the force to the rigidbody.
            rb2D.AddForce(Vector3.up * force);
        }
    }
}

Бросает луч на коллайдеры в Scene.

Эта функция возвращает число найденных контактов и помещает эти контакты в массив results. Результаты также могут быть отфильтрованы по contactFilter.

NOTE: Все результаты сортируются в порядке возрастания расстояния i.e. первый результат является ближайшим.

Дополнительные ресурсы: ContactFilter2D и RaycastHit2D.

Бросает луч на коллайдеры в Scene.

Возвращаемое целое число представляет собой число результатов, записанных в список results. Список результатов будет изменен, если в нем не будет достаточно элементов для отображения всех результатов. Это предотвращает выделение памяти для результатов, когда список results не нуждается в изменении размера, и повышает производительность сбора мусора, когда запрос выполняется часто.

Результаты также могут быть отфильтрованы по contactFilter.

NOTE: Все результаты сортируются по возрастающему расстоянию i.e. первый результат является ближайшим.

Дополнительные ресурсы: ContactFilter2D и RaycastHit2D.