14

Этот пост содержит в себе ответы на такие частые вопросы, как:

  • Для чего предназначены и как работают функции: OnCollisionEnter, OnTriggerEnter, OnCollisionEnter2D, OnTriggerStay, OnCollisionExit и подобные;
  • Как их правильно вызывать / почему они не срабатывают;
  • Что они принимают и возвращают;
  • Почему функции OnCollisionStay/OnTriggerStay/... перестают работать спустя несколько кадров, если изначально работали, а объект даже не двигался.

ВАЖНО: здесь также описано, что такое триггер, что он делает и чем отличается от обычного коллайдера.

5
  • 1
    Теперь надо, чтобы старшины/корифеи дали ОфИцИаЛьНоЕ разрешение иметь возможность закрывать вопросы по этой теме как дубликаты) 😂😂😂 25 апр 2021 в 20:07
  • Это право вам дает StackOverflow :)
    – aepot
    25 апр 2021 в 20:31
  • @aepot <strike>Уряяя!!!<\strike> Превысокомного благодарен! :) 25 апр 2021 в 20:31
  • Если ответ точный и правильный - то можно закрывать. 25 апр 2021 в 21:05
  • Развлекаемся на последок, принятие закона о просветительской деятельности на носу. 😂
    – Yaroslav
    26 апр 2021 в 0:39

1 ответ 1

13

Список функций:

В первую очередь перечислим все подобные функции. Всего их 12:

Те же функции, но для 2D объектов:

! Все ссылки рабочие и направляют на страницу своей функции


О функциях OnCollision... и их 2D версиях

Из документации:

  • OnCollisionEnter вызывается, когда этот Collider1/Rigidbody начал соприкосновение с другим Rigidbody/Collider.
  • OnCollisionStay вызывается один раз в кадр для каждого Collider/Rigidbody, который касается другого Rigidbody/Collider.
  • OnCollisionExit вызывается, когда Collider/Rigidbody прекращает контакт с другим Rigidbody/Collider.

Все вышеперечисленные тезисы верны в том числе и для 2D версий функций.

Аргументы:
Все они принимают в качестве первого и единственного аргумента — Collision (не путать с Collider). Класс Collision содержит информацию о точках соприкосновения, скорости воздействия и т.д.

Требования:

  • Оба объекта должны иметь на себе компонент Collider.
  • У обоих объектов в компоненте Collider должно быть ОТКЛЮЧЕНО свойство isTrigger.
  • Хотя бы один из двух объектов должен иметь компонент Rigidbody.
  • У объекта(-ов) с компонентом Rigidbody должно быть ОТКЛЮЧЕНО свойство isKinematic.

Важно:

  1. События столкновений отправляются даже на неактивные компоненты.
  2. События столкновений НЕ отправляются на объекты с отключенным или временно неактивным компонентом Rigidbody.

О функциях-триггерах OnTrigger... и их 2D версиях

англ. trigger [ˈtrɪgə] - спусковой крючок, пусковой сигнал, триггер

Collider с свойством триггера не является телесным и ни с кем не сталкивается (физически), а используется как зона, которая способна реагировать на события входа/выхода/нахождения в ней чего-либо и запуска неких сценариев.

Любой объект будет проходить сквозь триггер, не оказывая физического воздействия.

Из документации:

  • OnTriggerEnter вызывается, когда Collider other входит в триггер.
  • OnTriggerStay вызывается практически2 каждый кадр для каждого Collider other, которые соприкасаются с триггером.
  • OnTriggerExit вызывается, когда Collider other перестает соприкасаться с триггером.

Все вышеперечисленные тезисы верны в том числе и для 2D версий функций.

Аргумент:
Все они принимают в качестве первого и единственного аргументаCollider (не путать с Collision), то есть ссылку на компонент объекта, с которым произошло триггерное столкновение.

Требования:

  • Оба объекта должны иметь на себе компонент Collider.
  • РОВНО один объект (НЕ два) должен быть помечен как триггер (то есть свойство isTrigger должно быть равно true) в компоненте Collider.
  • Хотя бы один из двух объектов должен иметь компонент Rigidbody.

Важно:

  1. Функции-триггеры вызываются в FixedUpdate после непосредственного входа в триггер/выхода из триггера и т.д., поэтому объекты, участвующие в столкновении, в момент вызова функции-триггера могут уже находиться не той позиции, где были в момент столкновения.
  2. Функции-триггеры не являются непосредственной частью столкновений, а лишь функцией MonoBehaviour'a.
  3. Функция OnTriggerStay зависит от физического таймера, поэтому нет необходимости вызывать ее каждый кадр — она может вызываться НЕ в каждом кадре.

Помните также о том, что если вы не используете аргументы, указываемые в функциях (Collision other, Collider collider...), вам следует их опустить: в таком случае ненужные расчеты не будут производиться. Например:

private void OnCollisionEnter () // Не нужен Collision collision — не пишем
{
...
}

О переводе в "спящее" состояние

Многие могли сталкиваться с такой ситуацией: на объекте висит Collider, Rigidbody, всё настроено как надо, на объект повешен скрипт с функцией OnCollisionStay, OnTriggerStay или их 2D версиями. Однако при нахождении объекта в коллайдере, эти функции вдруг перестают работать! А если в них поместить Debug.Log для дебага, оказывается, что спустя несколько десятков кадров, объект просто перестает выполнять свою функцию, выводы в консоль прекращаются, и объект, который даже не двигался, будто засыпает! Почему такое происходит?

Дело в том, что Rigidbody действительно может засыпать!

Когда Rigidbody двигается медленнее определенной скорости, считается, что он остановился. После этого объект будет переведен в "спящий" режим. Это сделано для оптимизации: ресурсы процессора не будут расходоваться на обновление Rigidbody, пока он не "проснется" (т.е. снова придет в движение)

В некоторых случаях (например, когда передвижение физического объекта производится через т.н. "телепортацию"), объект может не проснуться, хотя должен. В таком случае его можно принудительно разбудить функцией WakeUp.

Источник: https://docs.unity3d.com/Manual/RigidbodiesOverview.html




Сноски:
1 Здесь и далее под компонентом Collider понимается любой тип коллайдера, любой его наследник. То есть вы можете использовать BoxCollider, SphereCollider, CapsuleCollider, любые 2D коллайдеры: BoxCollider2D, CircleCollider2D — или любой другой коллайдер, соответствующий вашим нуждам.

2 OnTriggerStay вызывается практически каждый кадр, потому что она зависит от физического таймера, и нет необходимости вызывать ее каждый кадр.

1
  • Комментарии не предназначены для расширенной дискуссии; разговор перемещён в чат.
    – Grundy
    26 апр 2021 в 14:16

Ваш ответ

By clicking “Отправить ответ”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Всё ещё ищете ответ? Посмотрите другие вопросы с метками или задайте свой вопрос.