用途:在 Unity 中用 async/await 处理异步操作,如加载、网络请求、延时,替代协程,并管理取消与生命周期绑定。
安装:在 manifest.json 加入 "com.cysharp.unitask": "https://github.com/Cysharp/UniTask.git?path=src/UniTask/Assets/Plugins/UniTask"。
主要能力:提供 UniTask 与 UniTask<T> 返回值;UniTaskVoid 用于真正的 fire-and-forget,而 Forget() 会抑制警告但丢失错误处理。支持 CancellationToken,MonoBehaviour 推荐 this.GetCancellationTokenOnDestroy() 在对象销毁时自动取消,也可用 CreateLinkedTokenSource 链接外部与销毁令牌;支持 Timeout、TimeoutWithoutException、AttachExternalCancellation。集成 Unity 生命周期:UniTask.Yield、WaitForEndOfFrame、WaitForFixedUpdate、DelayFrame、按 PlayerLoopTiming 等待,以及 WaitUntil、WaitWhile。等待 Unity 事件如 OnClickAsync、OnTriggerEnterAsync、OnCollisionEnterAsync、WaitForAnimationEvent。并行操作支持 WhenAll、WhenAny,可用 SemaphoreSlim 限制并发。协程互操作:协程或 IEnumerator 用 ToUniTask() 转换(可带 cancellationToken),UniTask 用 ToCoroutine() 转回。资源加载涵盖 Addressables、SceneManager、AssetBundle 的异步封装。进度用 IProgress;错误处理有 try-catch、SuppressCancellationThrow、WhenAll 中的 AggregateException。章节还给出 UniTask 与 Task 的取舍、常见陷阱(缺取消令牌、Forget 无错误处理、主线程阻塞、不必要分配)及最佳实践与性能提示。
适用场景:Unity 加载、网络、延时、初始化、并行异步操作。
限制:资料未给出许可、版本、性能基准或对具体 Unity 版本的支持范围,这些暂未提供;实际效果需自行验证。