VContainer-integrations/unitask | 集成——Unitask

合集 - VContainer 中文文档(33)

1.VContainer 介绍02-172.VContainer-about/what-is-vcontainer | 概述——VContainer 是什么？02-173.VContainer-about/what-is-di | 概述——DI 是什么？02-174.VContainer-getting-started/installation | 入门——安装02-175.VContainer-getting-started/hello-world | 入门——Hello World02-176.VContainer-resolving/constructor-injection | 解析——构造函数注入02-177.VContainer-resolving/method-injection | 解析——方法注入02-178.VContainer-resolving/property-field-injection | 解析——属性/字段注入02-179.VContainer-resolving/gameobject-injection | 解析——注入到 MonoBehaviours 中02-1710.VContainer-resolving/container-api | 解析——容器 API02-1711.VContainer-registering/register-type | 注册——注册纯 C# 类型02-1712.VContainer-registering/register-using-delegate | 注册——注册使用委托02-1713.VContainer-registering/register-factory | 注册——注册工厂02-1714.VContainer-registering/register-monobehaviour | 注册——注册 MonoBehaviour02-1715.VContainer-registering/register-scriptable-object | 注册——注册 ScriptableObject02-1716.VContainer-registering/register-collection | 注册——注册集合02-1717.VContainer-registering/register-callbacks | 注册——注册回调02-1718.VContainer-integrations/entrypoint | 集成——纯 C# 入口点02-17

19.VContainer-integrations/unitask | 集成——Unitask02-18

20.VContainer-integrations/unirx | 集成——UniRx02-1821.VContainer-integrations/messagepipe | 集成——MessagePipe02-1822.VContainer-integrations/ecs | 集成——ECS (beta)02-1823.VContainer-scoping/lifetime-overview | 作用域——生命周期管理总览02-1824.VContainer-scoping/generate-child-via-scene | 作用域——通过场景或 prefab 生成子作用域02-1825.VContainer-scoping/generate-child-with-code-first | 作用域——通过代码优先生成子作用域02-1826.VContainer-scoping/project-root-lifetimescope | 作用域——项目根作用域 LifetimeScope02-1827.VContainer-diagnostics/diagnostics-window | 诊断——VContainer 诊断窗口02-1828.VContainer-optimization/source-generator | 优化——源码生成器02-1829.**VContainer-optimization/async-container-build | 优化——异步容器构建02-1830.VContainer-optimization/parallel-container-build | 优化——并行容器构建02-1831.VContainer-optimization/codegen | 优化——预生成 IL 代码（已弃用）02-1832.VContainer-comparing/comparing-to-zenject | 对比 Zenject02-1833.MessagePipe 中文文档02-20

收起

UniTask 是为 Unity 优化的 async/await 解决方案。提供与 .NET 标准的 基于任务的异步模式 相似的API，但针对 Unity 的 PlayerLoop 进行了优化。还增加了对 Unity 内置异步操作（如 UnityWebRequest）的 async/await 支持。

项目中安装 com.cysharp.unitask 包后，
VCONTAINER_UNITASK_INTEGRATION 编译器符号和以下功能将自动启用。

IAsyncStartable

启用 VCONTAINER_UNITASK_INTEGRATION 集成，IAsyncStartable 将使用 UniTask 作为返回值。

public class FooController : IAsyncStartable
{
    public async UniTask StartAsync(CancellationToken cancellation)
    {
        await LoadSomethingAsync(cancellation);
        await ...
        ...
    }
}

一旦注册了实现 IAsyncStartable 的类，其 StartAsync 方法将自动执行，类似于 IStartable。

builder.RegisterEntryPoint<FooController>();

RegisterEntryPoint 更多相关信息见 纯 C# 入口点。

StartAsync() 时机

目前，VContainer 提供的唯一 async 接口是 IAsyncStartable。若需在不同的 PlayerLoop 阶段执行 async 代码，UniTask 本身提供了在方法内控制执行时机的方式。

若需在不同的时间调度进程，可使用 UniTask 的 PlayerLoopTiming。

await UniTask.Yield(PlayerLoopTiming.FixedUpdate);

注意，所有 StartAsync 调用将同时安排在主线程上执行（除非在每个实现中另有指定），并且未来的 PlayerLoop 阶段不会等待它们完成。

更多信息参见 UniTask 的 PlayerLoop 文档。

异常处理

• 与 IEnumerator 支持的协程不同，async 支持完整的 try/catch/finally 语法。
• 可通过 UniTaskScheduler.UnobservedTaskException 全局捕获异常。
• 或使用 builder.RegisterEntryPointExceptionHandler(ex => ..) 为每个 LifetimeScope 注册一个单独的错误处理程序。

更多信息参见 纯 C# 入口点 部分。

CancellationToken

StartAsync 提供了一个 CancellationToken，会在所属的 LifetimeScope 被销毁时自动取消。

异步资源加载

UniTask 能够实现异步加载资源和场景。与 VContainer 的 LifetimeScope.Enqueue* 方法之一结合使用将更方便。

var extraAsset = await Addressables.LoadAssetAsync<ExtraAsset>(key);

using (LifetimeScope.EnqueueParent(parentScope))
using (LifetimeScope.Enqueue(builder => builder.RegisterInstance(extraAsset))
{
    await SceneManager.LoadSceneAsync("AdditiveScene");
}

更多信息参见 作用域 部分。