Use Invoke methods to execute code at a given time

What if you need to invoke a specific code in 2 seconds? You can write an accumulator that counts time, use coroutine to wait for 2 seconds or simply use Invoke or InvokeRepeating methods.

Invoke

Invoke is a public method of MonoBehaviour class (so you can access it from your game scripts). It takes method name and time as parameters and it can be used in that way:

using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    public Rigidbody projectile;
    void LaunchProjectile() {
        Rigidbody instance = Instantiate(projectile);
        instance.velocity = Random.insideUnitSphere * 5;
    }
    void Start() {
        Invoke("LaunchProjectile", 2);
    }
}

This example executes LaunchProjectile method 2 seconds after starting. It’s just that simple.

InvokeRepeating

InvokeRepeating is very similar to Invoke method but it takes repeat interval as a third parameter, so there can be a difference between the first execution time and any other. Here’s an example:

using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    public Rigidbody projectile;
    void LaunchProjectile() {
        Rigidbody instance = Instantiate(projectile);
        instance.velocity = Random.insideUnitSphere * 5;
    }
    void Start() {
        InvokeRepeating("LaunchProjectile", 2, 0.3F);
    }
}

In this example LaunchProjectile method will be invoked 2 seconds after starting and then in 0.3 second intervals.

CancelInvoke

CancelInvoke allows you to cancel any pending invoke scheduled using two previous methods. It takes a scheduled method name as a parameter.

CancelInvoke("LaunchProjectile");

You may also want to check if the method is scheduled for invocation using IsInvoking method.

Possible alternatives

Invoke methods may be a nice shortcut when you want to quickly schedule a method to be invoked in the future, but it can be difficult to maintain because of passing a string as a method name. Because of that, the refactoring errors will be visible only in the run time and this usually means trouble.

Instead of using Invoke methods you may prefer to use coroutines. Coroutines are lengthy by nature, but a lot safer to maintain (of course if you’re using StartCoroutine overload that takes IEnumerator value type as parameter instead of string).

using UnityEngine;
using System.Collections;

public class ExampleClass : MonoBehaviour {
    public Rigidbody projectile;
    IEnumerator WaitAndLaunchProjectile(float wait) {
        yield return new WaitForSeconds(wait);

        Rigidbody instance = Instantiate(projectile);
        instance.velocity = Random.insideUnitSphere * 5;
    }
    void Start() {
        Invoke(LaunchProjectile(2));
    }
}

 

related
IntermediateTips
Use decorator drawers to improve inspector view of your scripts
If you're writing a custom script then most probably you want to manipulate its public field...
0
GuideIntermediateTipsTutorial
Project Tiny: Play Your Games Instantly
Unity Technologies is one of these companies that constantly bring something new to the table....
0
BasicsTips
Use unitypackage files to share part of your project
Did you know that there's an easier way to share your Unity project files than zipping it all...
0
Call The Knights!
We are here for you.
Please contact us with regards to a Unity project below.



The Knights appreciate your decision!
Expect the first news soon!
hire us!