Unity 异步编程:协程、async/await、UniTask 与 Awaitable
协程和 async/await 在语言层面的原理(编译器生成的状态机),见 C# 迭代器与 async/await 原理。
一、为什么需要异步
游戏中有大量”需要等一会儿”的逻辑:
- 等资源加载完成、等网络请求返回;
- 延迟 2 秒后执行、每隔 1 秒执行一次;
- 先播动画,播完再弹出奖励,再等玩家点击……
这些逻辑不能用循环加等待来写,因为 Unity 的脚本都运行在主线程上,一旦阻塞,整个游戏就卡住了。异步方案要解决的是:把一段跨越多帧的流程,写成顺序执行的代码,同时不阻塞主线程。
Unity 中有四种主要方案:
| 方案 | 来源 | 基础 |
|---|---|---|
| 协程(Coroutine) | Unity 内置 | C# 迭代器 |
| async/await + Task | C# / .NET | async 状态机 + Task |
| UniTask | 第三方开源(Cysharp) | async 状态机 + 自定义的结构体任务类型 |
| Awaitable | Unity 2023.1 起内置 | async 状态机 + Unity 官方的任务类型 |
二、协程
运行机制
IEnumerator ShowReward(){ PlayAnimation(); yield return new WaitForSeconds(1f); // 1 秒后再继续 OpenRewardPopup(); yield return null; // 下一帧再继续 PlaySound();}
StartCoroutine(ShowReward());StartCoroutine会立即执行协程,直到第一个yield return。- Unity 记下 yield 出来的对象,在之后的每一帧检查条件是否满足。
- 条件满足时调用迭代器的
MoveNext(),执行到下一个yield return,如此往复,直到方法结束。
yield 指令与执行时机
| yield 返回 | 什么时候继续 |
|---|---|
null | 下一帧,在所有 Update 执行完之后 |
new WaitForSeconds(t) | 经过 t 秒(受 Time.timeScale 影响)后的那一帧,在 Update 之后 |
new WaitForSecondsRealtime(t) | 经过 t 秒真实时间,不受 timeScale 影响 |
new WaitForFixedUpdate() | 下一次 FixedUpdate 之后 |
new WaitForEndOfFrame() | 当前帧渲染完成、显示到屏幕之前,适合截屏 |
new WaitUntil(条件) / WaitWhile | 每帧检查条件,在 Update 之后、LateUpdate 之前 |
AsyncOperation(如场景、资源异步加载) | 操作完成后 |
StartCoroutine(另一个协程) | 等待另一个协程结束 |
yield break | 立即结束协程 |
暂停游戏时常把 Time.timeScale 设为 0,这时 WaitForSeconds 永远不会结束。暂停界面中的倒计时、动画要用 WaitForSecondsRealtime。
生命周期
协程依附于启动它的 MonoBehaviour:
| 操作 | 协程会怎样 |
|---|---|
gameObject.SetActive(false) | 停止,重新激活后也不会恢复 |
Destroy(gameObject) 或销毁组件 | 停止 |
enabled = false(只禁用组件) | 不会停止,继续运行 |
StopCoroutine(handle) / StopAllCoroutines() | 停止 |
物体被禁用后协程不会恢复,这一点经常导致”界面关掉又打开,倒计时不走了”的 Bug,需要在 OnEnable 中重新启动。
GC 分配
- 每次
StartCoroutine都会创建一个迭代器对象和一个Coroutine对象。 yield return new WaitForSeconds(1)每次都会 new 一个对象,可以缓存复用:
static readonly WaitForSeconds OneSecond = new WaitForSeconds(1f);yield return OneSecond;yield return 0会把 int 装箱,用yield return null代替。
局限
- 不能返回值:想拿到协程的结果,只能通过回调或者成员变量。
- 异常处理困难:
yield return不能放在带catch的try中;协程中抛出的异常只会输出到日志,并终止这个协程,外部无从得知。 - 取消不方便:只能通过保存
Coroutine句柄来StopCoroutine,嵌套的子协程管理起来很麻烦。 - 必须依附 MonoBehaviour:普通的 C# 类中无法直接启动协程。
三、原生 async/await 与 Task
Unity 在主线程上安装了 UnitySynchronizationContext,所以在主线程中 await 之后,代码会回到主线程继续执行,可以调用 Unity API:
async void Start(){ await Task.Delay(1000); transform.position = Vector3.zero; // 回到了主线程,可以调用}写法比协程自然很多:有返回值、可以 try/catch、可以在任何类中使用。但在 Unity 中直接使用 Task 有几个坑:
| 问题 | 说明 |
|---|---|
| 不受对象生命周期管理 | 物体被销毁后,await 之后的代码照样执行,访问已销毁的对象就会报 MissingReferenceException |
| 退出 Play 模式后仍在运行 | 编辑器中停止运行后,没结束的 Task 还会继续执行 |
| 不受 timeScale 影响 | Task.Delay 用的是系统计时器,游戏暂停时它照样计时 |
| GC 分配 | 每个 Task 都是对象,频繁使用会产生 GC |
| 异常被吞 | 没被 await 的 Task 中抛出的异常,不会出现在日志里 |
| WebGL 不支持多线程 | Task.Run 等依赖线程的用法不能用 |
所以在 Unity 中写游戏逻辑,一般不直接使用 Task,而是使用 UniTask 或 Awaitable。原生 Task 主要用于和 .NET 类库交互。
四、UniTask
UniTask 是专为 Unity 设计的 async/await 方案,是目前 Unity 项目中最常用的异步库。
为什么快
UniTask和UniTask<T>是结构体,并且配套了自定义的状态机构建器。同步完成时零分配,需要暂停时使用对象池复用内部对象,基本不产生 GC。- 不依赖 SynchronizationContext,而是直接挂在 Unity 的 PlayerLoop 上运行,每帧在指定的时机检查和推进。可以精确控制在 Update、LateUpdate、FixedUpdate 等哪个阶段继续执行。
常用 API
// 等待时间与帧await UniTask.Delay(1000); // 受 timeScale 影响await UniTask.Delay(1000, ignoreTimeScale: true); // 不受影响await UniTask.Yield(); // 等到下一次 PlayerLoopawait UniTask.NextFrame(); // 下一帧await UniTask.WaitForFixedUpdate();await UniTask.WaitUntil(() => isReady);
// 直接 await Unity 的异步操作var asset = await Resources.LoadAsync<Sprite>("Icon");await SceneManager.LoadSceneAsync("Battle");var request = await UnityWebRequest.Get(url).SendWebRequest();
// 并行await UniTask.WhenAll(LoadA(), LoadB(), LoadC());var (winIndex, result) = await UniTask.WhenAny(TaskA(), TaskB());
// 切换线程await UniTask.SwitchToThreadPool(); // 之后在线程池执行HeavyCompute();await UniTask.SwitchToMainThread(); // 回到主线程
// 不需要等待结果的"发射后不管"DoSomethingAsync().Forget();方法声明:
async UniTask LoadAsync() { ... } // 无返回值async UniTask<int> GetCountAsync() { ... } // 有返回值async UniTaskVoid OnClickAsync() { ... } // 代替 async void绑定生命周期:取消
UniTask 最重要的用法,是把异步流程和对象的生命周期绑定:
async UniTaskVoid Start(){ var token = this.GetCancellationTokenOnDestroy(); // 物体销毁时自动取消 await UniTask.Delay(3000, cancellationToken: token); transform.position = Vector3.zero; // 物体已销毁时不会执行到这里}物体销毁时,正在等待的 Delay 会抛出 OperationCanceledException,后面的代码不再执行。这就解决了原生 Task “对象销毁后还在跑”的问题。
注意事项
- 一个 UniTask 只能 await 一次。它是结构体,内部对象完成后会被回收复用,再次 await 会出错。确实需要多次 await 时,调用
.Preserve()。 Forget()的任务中出现的异常,会通过UniTaskScheduler.UnobservedTaskException输出到日志,不会被悄悄吞掉。- 编辑器中有 UniTask Tracker 窗口,可以查看当前所有正在运行的 UniTask,方便排查没有结束的任务(泄漏)。
- 很多第三方库(DOTween、Addressables、YooAsset 等)都有 UniTask 的扩展,可以直接 await。
五、Awaitable(Unity 官方)
Unity 2023.1 起(包括 Unity 6)内置了 Awaitable 类型,思路和 UniTask 类似:
async Awaitable Start(){ await Awaitable.WaitForSecondsAsync(1f); await Awaitable.NextFrameAsync(); await Awaitable.EndOfFrameAsync(); await Awaitable.FixedUpdateAsync();
await Awaitable.BackgroundThreadAsync(); // 切到后台线程 HeavyCompute(); await Awaitable.MainThreadAsync(); // 切回主线程}- 内部对象使用对象池,GC 很少;同样只能 await 一次。
- 配合 MonoBehaviour 的
destroyCancellationToken(Unity 2022.2 起)实现销毁时取消。 - 优点:官方内置,不需要引入第三方库。
- 不足:功能比 UniTask 少(比如组合多个任务的工具、调试窗口等),并且只能在较新的 Unity 版本中使用。
六、统一的取消方式:CancellationToken
不管用哪种基于 async 的方案,取消都通过 CancellationToken 实现:
CancellationTokenSource _cts;
void StartCountdown(){ _cts?.Cancel(); // 取消上一次 _cts = new CancellationTokenSource(); CountdownAsync(_cts.Token).Forget();}
async UniTaskVoid CountdownAsync(CancellationToken token){ for (int i = 10; i > 0; i--) { label.text = i.ToString(); await UniTask.Delay(1000, cancellationToken: token); }}
void OnDisable() => _cts?.Cancel(); // 界面关闭时取消- 需要多个取消条件时(比如界面关闭或者物体销毁),用
CancellationTokenSource.CreateLinkedTokenSource合并。 - 被取消时抛出的
OperationCanceledException是正常的控制流,不是错误,日志中不需要当错误处理。UniTask 也提供了SuppressCancellationThrow(),可以把取消转换成返回值来判断。 CancellationTokenSource用完要Dispose。
七、选型
| 协程 | Task | UniTask | Awaitable | |
|---|---|---|---|---|
| 返回值 | 不支持 | 支持 | 支持 | 支持 |
| try/catch | 受限 | 支持 | 支持 | 支持 |
| 取消 | StopCoroutine | CancellationToken | CancellationToken | CancellationToken |
| 绑定对象生命周期 | 自动(依附 MonoBehaviour) | 不绑定 | GetCancellationTokenOnDestroy | destroyCancellationToken |
| GC | 每次启动有分配 | 每个 Task 有分配 | 基本零分配 | 很少(对象池) |
| 受 timeScale 影响 | 可选 | 不受 | 可选 | 可选 |
| 使用位置 | 只能在 MonoBehaviour 中启动 | 任何地方 | 任何地方 | 任何地方 |
| 并行组合 | 不方便 | WhenAll | WhenAll / WhenAny | 较少 |
| 需要引入 | 无 | 无 | 第三方库 | Unity 2023.1+ |
建议:
- 新项目:首选 UniTask。功能最全、性能最好、生态最完善。
- 不想引入第三方库,且 Unity 版本够新:用 Awaitable。
- 协程:简单的、和单个物体强绑定的表现逻辑(比如一段特效序列)仍然可以用。但复杂的业务流程(加载 → 请求 → 弹窗 → 等待点击)用 async 写更清晰。
- 原生 Task:只用于和 .NET 类库交互,不用来写游戏流程。
八、异步与多线程的分工
上面这些方案解决的都是”等待”的问题,默认都在主线程上运行,本身不提供并行计算。
| 需求 | 方案 | 注意 |
|---|---|---|
| 等待加载、网络、时间 | 协程 / UniTask / Awaitable | 主线程,可以直接调用 Unity API |
| 少量耗时计算(解析大文件、压缩) | Task.Run、UniTask.SwitchToThreadPool、Awaitable.BackgroundThreadAsync | 在其他线程上不能调用大部分 Unity API,算完要切回主线程 |
| 大量数据的并行计算(大量单位寻路、物理、网格生成) | Job System + Burst | 数据要用 NativeArray 等容器,编译器保证线程安全 |
协程和 async 的原理、“异步不等于多线程”的详细说明,见 C# 迭代器与 async/await 原理。
常见追问
协程是多线程吗? 不是。协程运行在主线程上,由 Unity 每帧调用迭代器的 MoveNext 推进,本质是同一线程上的分时执行。
yield return null 和 WaitForEndOfFrame 有什么区别?
null 在下一帧所有 Update 之后继续;WaitForEndOfFrame 在当前帧渲染完成之后继续,常用于截屏。
物体被 SetActive(false) 后协程会怎样?
协程停止,重新激活后也不会恢复。只禁用组件(enabled = false)不会停止协程。
为什么不推荐在 Unity 中直接使用 Task? 不受对象生命周期管理(销毁后还会继续执行)、退出 Play 模式后仍在运行、不受 timeScale 影响、每次都有 GC 分配。
UniTask 为什么性能好? UniTask 是结构体并配合对象池,基本零分配;它挂在 PlayerLoop 上运行,不依赖 SynchronizationContext,还能指定在哪个更新阶段继续。
物体销毁后,异步方法还在执行怎么办?
用 CancellationToken:UniTask 的 GetCancellationTokenOnDestroy(),或 MonoBehaviour 的 destroyCancellationToken,在等待时传入,物体销毁时自动取消。
协程和 async/await 怎么选? 简单的、和单个物体绑定的表现序列可以用协程;需要返回值、异常处理、取消、组合多个异步操作的业务流程用 async(UniTask 或 Awaitable)。
UniTask 能 await 两次吗?
不能,内部对象完成后会被复用。需要多次 await 时调用 Preserve()。
想在后台线程做计算怎么办?
少量计算用 Task.Run 或 UniTask 的 SwitchToThreadPool,算完切回主线程再调用 Unity API;大规模并行计算用 Job System + Burst。
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!