Список функций:
В первую очередь перечислим все подобные функции. Всего их 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
.
Важно:
- События столкновений отправляются даже на неактивные компоненты.
- События столкновений НЕ отправляются на объекты с отключенным или временно неактивным компонентом 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.
Важно:
- Функции-триггеры вызываются в FixedUpdate после непосредственного входа в триггер/выхода из триггера и т.д., поэтому объекты, участвующие в столкновении, в момент вызова функции-триггера могут уже находиться не той позиции, где были в момент столкновения.
- Функции-триггеры не являются непосредственной частью столкновений, а лишь функцией MonoBehaviour'a.
- Функция 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
вызывается практически каждый кадр, потому что она зависит от физического таймера, и нет необходимости вызывать ее каждый кадр.