Где выполняются Coroutine?

Место выполнения Coroutine в Unity

Coroutine в Unity выполняются в рамках основного потока игры, внутри цикла обновления (Update) игрового движка. Это ключевой принцип, который отличает их от многопоточности и определяет их поведение.

Механизм выполнения внутри главного потока

Coroutine не создают отдельные потоки. Они работают как специальная система управления состояниями внутри единственного главного потока (Main Thread). Исполнение кода Coroutine интегрировано в стандартный цикл Unity:

Unity Main Thread Execution Cycle:
1. Обработка ввода (Input)
2. Вызов всех Update() методов MonoBehaviour
3. Вызов Coroutine, ожидающих выполнения на этом кадре
4. Обработка физики (Physics), если это FixedUpdate
5. Отрисовка (Render)

Таким образом, код вашей Coroutine выполняется после методов Update() всех объектов в том же кадре, где она была "активирована" (например, после вызова yield return null).

Детали процесса: Yield и продолжение

Coroutine управляются через механизм yield. Когда Coroutine достигает оператора yield return, она временно приостанавливает свое выполнение и передает управление обратно движку. Unity помещает эту Coroutine в внутреннюю очередь, связанную с конкретным условием yield.

Пример и пояснение:

using UnityEngine;
using System.Collections;

public class ExampleCoroutine : MonoBehaviour
{
    void Start()
    {
        // StartCoroutine помещает Coroutine в список активных для MonoBehaviour
        StartCoroutine(MyRoutine());
    }

    IEnumerator MyRoutine()
    {
        Debug.Log("Coroutine началась, кадр: " + Time.frameCount);
        
        // Yield return null - означает: "приостановиться и продолжить в следующем кадре"
        yield return null;
        
        // Этот код выполнится в следующем кадре после всех Update()
        Debug.Log("Выполнилось после yield null, кадр: " + Time.frameCount);
        
        // Yield return new WaitForSeconds(2) - продолжить через ~2 секунды
        yield return new WaitForSeconds(2f);
        
        // Этот код выполнится примерно через 2 секунды, в кадре, когда движок проверит,
        // что время ожидания истекло (проверка происходит также в главном потоке).
        Debug.Log("Выполнилось после 2 секунд ожидания");
    }
}

Конкретные "ожидающие" объекты и их место в цикле

В зависимости от объекта, возвращаемого с yield return, Unity планирует продолжение Coroutine в разных точках цикла:

• yield return null / WaitForEndOfFrame: Продолжение в следующем кадре, после Update().
• yield return WaitForSeconds: Продолжение, когда системное время превысит заданное значение (проверка происходит в главном потоке).
• yield return WaitForFixedUpdate: Продолжение в следующем физическом кадре, после обработки FixedUpdate().
• yield return AsyncOperation (например, WWW, AssetBundleRequest): Продолжение, когда операция завершена (движок проверяет завершение в главном потоке).
• yield return Coroutine (вложенная Coroutine): Продолжение после полного завершения вложенной Coroutine.

Ключевые выводы и ограничения

1. НЕ многопоточность: Все выполняется в главном потоке. Coroutine не дают вычислительного параллелизма для тяжелых задач.
2. Безопасность доступа к API Unity: Поскольку выполняется в главном потоке, можно свободно модифицировать Transform, GameObject, Renderer и другие компоненты Unity без риска конфликтов потоков.
3. Опасность "заморозки" игры: Если код внутри Coroutine выполняет тяжелый синхронный расчет (например, сложный цикл без yield), он блокирует весь главный поток, вызывая фризы игры, так как движок не может продолжить цикл обновления до завершения этого кода.

Понимание, что Coroutine выполняются в главном потоке, интегрировано в цикл обновления, является фундаментальным для их правильного и эффективного использования в Unity. Они идеальны для задач, требующих временной задержки или последовательности действий, разнесенных по времени, но не для распараллеливания вычислений. Для последних следует использовать асинхронные операции (async/await) или фоновые потоки (System.Threading) с последующей синхронизацией результатов в главном потоке.