Coroutine basics (IEnumerator) in Unity - Mini Project: Build & Apply

Coroutine basics (IEnumerator)

📖 Scenario: You are making a simple Unity game where you want to show a message, wait for a few seconds, and then show another message.

🎯 Goal: Build a coroutine using IEnumerator that waits for 3 seconds before printing a message in the Unity console.

📋 What You'll Learn

Create a coroutine method using IEnumerator

Use yield return new WaitForSeconds(3) to wait

Start the coroutine from the Start() method

Print messages before and after the wait

💡 Why This Matters

🌍 Real World

Coroutines let you pause and resume actions in games, like waiting for animations or delays without freezing the whole game.

💼 Career

Understanding coroutines is important for game developers to manage timed events and smooth gameplay experiences.

1

Create a Start() method and print the first message

Create a Start() method inside a MonoBehaviour class called MessagePrinter. Inside Start(), write Debug.Log("Starting coroutine...") to print the first message.

Unity

using UnityEngine;

public class MessagePrinter : MonoBehaviour
{
    // Create Start() method and print the first message
    // Your code here
}

Hint

Remember, Start() is a special method called automatically when the game starts.

2

Create a coroutine method called WaitAndPrint()

Add a coroutine method called WaitAndPrint() that returns IEnumerator. Inside it, write yield return new WaitForSeconds(3); to wait for 3 seconds.

Unity

using UnityEngine;

public class MessagePrinter : MonoBehaviour
{
    void Start()
    {
        Debug.Log("Starting coroutine...");
    }

    // Create IEnumerator method WaitAndPrint() with 3 seconds wait
    // Your code here
}

Hint

Use IEnumerator as the return type and yield return new WaitForSeconds(3); to pause.

3

Start the coroutine WaitAndPrint() inside Start()

Inside the Start() method, add the line StartCoroutine(WaitAndPrint()); to start the coroutine.

Unity

using UnityEngine;
using System.Collections;

public class MessagePrinter : MonoBehaviour
{
    void Start()
    {
        Debug.Log("Starting coroutine...");
        // Start the coroutine WaitAndPrint()
        // Your code here
    }

    IEnumerator WaitAndPrint()
    {
        yield return new WaitForSeconds(3);
    }
}

Hint

Use StartCoroutine() to run the coroutine method.

4

Print a message after the wait inside WaitAndPrint()

Inside the WaitAndPrint() coroutine, after the yield return line, add Debug.Log("3 seconds passed!"); to print the message after waiting.

Unity

using UnityEngine;
using System.Collections;

public class MessagePrinter : MonoBehaviour
{
    void Start()
    {
        Debug.Log("Starting coroutine...");
        StartCoroutine(WaitAndPrint());
    }

    IEnumerator WaitAndPrint()
    {
        yield return new WaitForSeconds(3);
        // Print message after wait
        // Your code here
    }
}

Hint

Use Debug.Log() to print the message after the wait.

Practice

1. What is the main purpose of using a Coroutine in Unity?

easy

A. To handle user input events only

B. To create new game objects instantly

C. To pause and resume code execution over time without freezing the game

D. To permanently stop the game

Solution

1. Step 1: Understand Coroutine behavior

   Coroutines allow code to pause and continue later, useful for timed actions.

2. Step 2: Compare options

   Only To pause and resume code execution over time without freezing the game describes pausing and resuming code smoothly without freezing the game.

3. Final Answer:

   To pause and resume code execution over time without freezing the game -> Option C

4. Quick Check:

   Coroutine = pause and resume code [OK]

Hint: Coroutines pause code without freezing game [OK]

Common Mistakes:

• Thinking coroutines create objects
• Confusing coroutines with event handlers
• Believing coroutines stop the game

2. Which of the following is the correct way to declare a coroutine method in Unity?

easy

A. public IEnumerator MyCoroutine() { yield return null; }

B. public string MyCoroutine() { yield return null; }

C. public int MyCoroutine() { yield return null; }

D. public void MyCoroutine() { yield return null; }

Solution

1. Step 1: Recall coroutine method signature

   Coroutine methods must return IEnumerator to support yield return.

2. Step 2: Check each option's return type

   Only public IEnumerator MyCoroutine() { yield return null; } returns IEnumerator and uses yield return correctly.

3. Final Answer:

   public IEnumerator MyCoroutine() { yield return null; } -> Option A

4. Quick Check:

   Coroutine method returns IEnumerator [OK]

Hint: Coroutine methods always return IEnumerator [OK]

Common Mistakes:

• Using void as return type
• Returning int or string instead of IEnumerator
• Forgetting yield return inside coroutine

3. What will be the output of this Unity coroutine code snippet?

IEnumerator PrintNumbers() {
    for (int i = 1; i <= 3; i++) {
        Debug.Log(i);
        yield return new WaitForSeconds(1);
    }
}

StartCoroutine(PrintNumbers());

medium

A. Prints 1, 2, 3 immediately without delay

B. Prints 1, then waits 1 second, prints 2, waits 1 second, prints 3

C. Prints 3 three times with 1 second delay

D. No output because coroutine is not started properly

Solution

1. Step 1: Understand the for loop with yield

   The loop prints i, then waits 1 second before next iteration.

2. Step 2: Trace output timing

   It prints 1, waits 1 second, prints 2, waits 1 second, then prints 3.

3. Final Answer:

   Prints 1, then waits 1 second, prints 2, waits 1 second, prints 3 -> Option B

4. Quick Check:

   yield return WaitForSeconds delays output [OK]

Hint: yield return pauses loop iteration [OK]

Common Mistakes:

• Assuming all prints happen instantly
• Thinking it prints 3 repeatedly
• Forgetting to start coroutine with StartCoroutine

4. Identify the error in this coroutine code:

IEnumerator Example() {
    Debug.Log("Start");
    yield WaitForSeconds(2);
    Debug.Log("End");
}

StartCoroutine(Example());

medium

A. Missing 'return' keyword before WaitForSeconds

B. Coroutine method should return void

C. StartCoroutine cannot be used with IEnumerator

D. Debug.Log cannot be used inside coroutines

Solution

1. Step 1: Check yield statement syntax

   Correct syntax requires 'yield return' before WaitForSeconds.

2. Step 2: Verify other parts

   Coroutine returns IEnumerator, StartCoroutine usage is correct, Debug.Log works inside coroutines.

3. Final Answer:

   Missing 'return' keyword before WaitForSeconds -> Option A

4. Quick Check:

   Use 'yield return' with WaitForSeconds [OK]

Hint: Always write 'yield return' before waiting [OK]

Common Mistakes:

• Writing 'yield' without 'return'
• Using void return type for coroutine
• Thinking StartCoroutine can't start IEnumerator

5. You want to create a coroutine that fades out a UI element over 3 seconds smoothly. Which approach correctly uses IEnumerator and yield return to achieve this?

hard

A. Change opacity once, then yield return new WaitForSeconds(3) without gradual change

B. Call StartCoroutine inside Update() every frame without stopping

C. Use a for loop without yield return to change opacity instantly

D. Use a loop that changes opacity gradually, yielding null each frame until 3 seconds pass

Solution

1. Step 1: Understand smooth fading with coroutine

   Smooth fade requires gradual opacity change over time with frame-by-frame updates.

2. Step 2: Analyze options for gradual change and yielding

   Use a loop that changes opacity gradually, yielding null each frame until 3 seconds pass uses a loop with yield return null to wait one frame each iteration, allowing smooth fade over 3 seconds.

3. Final Answer:

   Use a loop that changes opacity gradually, yielding null each frame until 3 seconds pass -> Option D

4. Quick Check:

   Gradual change + yield return null = smooth fade [OK]

Hint: Yield null each frame for smooth animation [OK]

Common Mistakes:

• Waiting full time without gradual change
• Not yielding inside loop causing freeze
• Starting coroutine repeatedly without stop