InvokeRepeating 是 Unity 内置的延时重复调用方法,作用是:等待指定时间后,每隔固定时间重复执行一个方法,是 Unity 中最简单的定时 / 循环执行方案。
一、核心语法
c
InvokeRepeating(string methodName, float delayTime, float repeatRate);
参数说明
1. methodName:要重复执行的方法名(字符串格式)
2. delayTime:首次延迟时间(秒),等待这么久后开始第一次执行
3. repeatRate:重复间隔时间(秒),之后每隔多久执行一次
二、简单示例
c
using UnityEngine;
public class InvokeTest : MonoBehaviour
{
void Start()
{
// 含义:延迟1秒后,每隔2秒执行一次 PrintLog 方法
InvokeRepeating("PrintLog", 1f, 2f);
}
void PrintLog()
{
Debug.Log("重复执行!");
}
}
运行结果:
游戏启动 → 等待 1 秒 → 打印一次
之后每隔 2 秒打印一次,直到停止或销毁物体
三、关键规则(必看)
1.调用限制
只能调用无参数、无返回值的方法
方法必须是当前脚本(或父类)中的方法
2.生命周期
脚本所在物体被禁用(SetActive (false)) → 停止执行
脚本被销毁 → 停止执行
场景切换 → 自动停止
3.停止重复调用
停止当前脚本的所有 Invoke 调用:
c
CancelInvoke();
停止指定方法的重复调用:
c
CancelInvoke("PrintLog");
4.判断是否正在调用
c
bool isRunning = IsInvoking("PrintLog");
四、实用完整代码
c
using UnityEngine;
public class AutoSpawn : MonoBehaviour
{
public GameObject prefab; // 要生成的物体
public float startDelay = 2f; // 首次延迟
public float spawnInterval = 1f; // 生成间隔
void Start()
{
// 开始重复生成
InvokeRepeating("SpawnObject", startDelay, spawnInterval);
}
void SpawnObject()
{
Instantiate(prefab, transform.position, transform.rotation);
}
// 外部调用此方法可以停止生成
public void StopSpawn()
{
CancelInvoke("SpawnObject");
Debug.Log("已停止生成");
}
}
六、适用场景
自动生成敌人 / 道具
定时回血、回蓝
简单的 AI 重复动作
每隔几秒打印日志、刷新数据