UniTask を使った非同期処理と InstantiateAsync の活用例
最終更新：
orika_ex_miyako 2025年11月07日(金) 11:18:09履歴
開発環境 
Unity 6000.2.6f1 UniTask
はじめに
Unity の非同期処理を扱う際には、従来のコルーチンのほかに C# の Task ベースのアプローチ(async/await)を用いることができます。
この記事では、UniTask を使用して非同期処理を管理しつつ、InstantiateAsync と AsyncInstantiateOperation.SetIntegrationTimeMS を組み合わせたサンプルコードを紹介します。
また、MonoBehaviour.destroyCancellationToken を活用したキャンセル処理についても解説し、コルーチンとの違いについて比較します。
UniTask の基礎知識
UniTask は、Unity 向けの軽量な非同期処理ライブラリです。
以下の特徴があります。
・非同期タスクベースの処理管理 ・コルーチンよりも簡潔で柔軟な記述 ・Unity の特定機能（AsyncOperation など）と連携
UniTask をプロジェクトに導入するには、以下の手順を実行します。
１．Unity Package Manager を開く。 ２．ボタンから "Add package from git URL..." を選択。 ３．以下の URL を入力してインストール https://github.com/Cysharp/UniTask.git?path=src/UniTask
非同期生成処理のメリット
Unity 2022.3.20f1 より、非同期処理による生成が可能な InstantiateAsync メソッドが追加されました。(ほかにもいくつかのメソッドが追加されています。)
Unity Releases
Unity 2022.3.20
https://unity.com/ja/releases/editor/whats-new/202...
プレハブを利用したゲームオブジェクトの生成は Instantiate メソッドを利用して行いますが、この場合、複数のオブジェクトの生成をまとめて行うと、処理が重くなる(画面がカクつく)ことが問題でした。
InstantiateAsync メソッドは非同期処理としてプレハブの生成が可能になるため、このデメリットを回避して生成処理を行うことが可能になっています。
ただし、通常の Instantiate メソッドよりは負荷が高いため、運用には注意が必要になります。
つまり、Instantiate メソッドを単純に InstantiateAsync メソッドに置き換えればいい、というわけではない、ということです。
Unity 公式スクリプトリファレンス
Object.InstantiateAsync
https://docs.unity3d.com/6000.0/Documentation/Scri...
InstantiateAsync メソッドを利用してゲームオブジェクトの生成を行うと、生成処理自体は並列で行われます。
そして生成されたゲームオブジェクトは、そのあとに Awake メソッドが呼ばれますが、これは、まとめてメインスレッドで呼ばれます。
そのため大量に生成を行うと、たとえ非同期処理であっても Awake メソッドが大量に処理されてしまって、結果的に恩恵を受けられない状況が発生します。
それを回避するため、AsyncInstantiateOperation.SetIntegrationTimeMS メソッドが追加されています。
これは引数で指定したミリ秒数を超えると、終了していない Awake メソッドは、次のフレームにて解決されるようになります。
Unity 公式動画
【Unity】非同期にインスタンスを大量生成！新 API "InstantiateAsync" を使ってみよう！
https://www.youtube.com/shorts/Q9K-3zkEijQ
Unity 公式スクリプトリファレンス
AsyncInstantiateOperation.SetIntegrationTimeMS
https://docs.unity3d.com/6000.0/Documentation/Scri...
通常のプレハブを使用したサンプルコード
以下は、通常のプレハブを使用してオブジェクトを一定間隔で生成し、UniTask のキャンセル処理も実装した例です。
キャンセル処理については MonoBehaviour.destroyCancellationToken を利用しています。
Unity 公式スクリプトリファレンス
MonoBehaviour-destroyCancellationToken
https://docs.unity3d.com/ja/current/ScriptReferenc...
using UnityEngine;
using Cysharp.Threading.Tasks;
using System.Threading;
public class AsyncSpawner : MonoBehaviour
{
[SerializeField] private GameObject prefab;
[SerializeField] private int spawnCount = 10;
[SerializeField] private float spawnInterval = 1.0f;
private void Start()
{
SpawnObjectsAsync(destroyCancellationToken).Forget();
}
private async UniTaskVoid SpawnObjectsAsync(CancellationToken cancellationToken)
{
for (int i = 0; i < spawnCount; i++)
{
// 生成
GameObject instance = Instantiate(prefab);
// 配置と初期化
instance.transform.position = new Vector3(i * 2, 0, 0);
// 指定間隔で待機
await UniTask.Delay(System.TimeSpan.FromSeconds(spawnInterval), cancellationToken: cancellationToken);
}
}
}
コードのポイントとしては、生成処理自体は同期処理である Instantiate メソッドを利用しています。
また、Addressables を使わず、直接プレハブをインスペクターから指定して登録しています。
キャンセル処理については、destroyCancellationToken を使用して、UniTask が破棄時に中断できるようにハンドリングしています。
非同期処理の制御については、コルーチンではなく UniTask.Delay を利用して一定間隔で生成を行っています。
コルーチンとの違い
上記と同じ処理をコルーチンで実装すると以下のようになります。
追加したり、修正した部分だけを抜粋します。
using System.Collections;
private void Start()
{
StartCoroutine(SpawnObjectsCoroutine);
}
private IEnumerator SpawnObjectsCoroutine()
{
for (int i = 0; i < spawnCount; i++)
{
GameObject instance = Instantiate(prefab);
instance.transform.position = new Vector3(i * 2, 0, 0);
yield return new WaitForSeconds(spawnInterval);
}
}
もしもこのコルーチンを、ゲームオブジェクトの破棄以外でも途中で停止させたい場合には、上記の処理では停止できません。
下記のような、変数に処理を代入する形で処理を作ることで、途中で停止できるようになります。
書式は異なりますが、IEnumerator 型と Coroutine 型のどちらでも対応できます。
private IEnumerator coroutine;
private void Start()
{
coroutine = SpawnObjectsCoroutine();
StartCoroutine(SpawnObjectsCoroutine);
}
// コルーチンを途中で停止するメソッド
public void StopSpawning()
{
StopCoroutine(spawnCoroutine);
}
private Coroutine coroutine;
private void Start()
{
coroutine = StartCoroutine(SpawnObjectsCoroutine);
}
// コルーチンを途中で停止するメソッド
public void StopSpawning()
{
if (spawnCoroutine != null)
{
StopCoroutine(spawnCoroutine);
spawnCoroutine = null;
}
}
Addressables を利用したサンプルコード
以下は、Addressables を使用してオブジェクトを一定間隔で非同期的に生成し、キャンセル処理も実装した例です。
こちらでは InstantiateAsync メソッドと AsyncInstantiateOperation.SetIntegrationTimeMS メソッドを利用して
非同期処理を利用してオブジェクトの生成を行っています。
生成処理は�´△里匹舛蕕任皺椎修任后�
using UnityEngine;
using Cysharp.Threading.Tasks;
using System.Threading;
using UnityEngine.AddressableAssets;
using UnityEngine.ResourceManagement.AsyncOperations;
using System.Collections.Generic;
public class AsyncSpawner : MonoBehaviour {
public AssetReference prefabReference; // Addressables 参照。インスペクタでアセットを指定可能。
public int spawnCount = 5;
public float spawnInterval = 1.0f; // 生成後に待機する秒
public float timeMs = 2.0f; // ミリ秒
private List<GameObject> spawnedObjectList = new(); // 生成したインスタンスを管理するリスト
private void Start() {
// SuppressCancellationThrow を指定することで、Destroy 時のキャンセルを安全に無視できます
SpawnObjectsAsync(destroyCancellationToken).Forget(SuppressCancellationThrow: true);
}
private async UniTaskVoid SpawnObjectsAsync(CancellationToken cancellationToken) {
for (int i = 0; i < spawnCount; i++) {
// キャンセルチェック
cancellationToken.ThrowIfCancellationRequested();
// 非同期処理による生成処理の実行� “麁唄�ロード ＆ 生成を行う。
AsyncOperationHandle<GameObject> handle = prefabReference.InstantiateAsync();
// 非同期処理による生成処理の実行�◆“麁唄�ロード ＆ 生成を行う。
AsyncOperationHandle<GameObject> handle = Addressables.InstantiateAsync(prefabReference);
// SetIntegrationTimeMS を利用して Awake 実行タイミングを制御
AsyncInstantiateOperation.SetIntegrationTimeMS(timeMs);
// Addressables のロード完了、生成完了まで待機
GameObject instance = await handle.Task;
// 配置と初期化
instance.transform.position = new Vector3(i * 2, 0, 0);
// 後で解放できるようリストに追加
spawnedObjectList.Add(instance);
// 指定間隔で待機
await UniTask.Delay(System.TimeSpan.FromSeconds(spawnInterval), cancellationToken: cancellationToken);
}
}
private void OnDestroy()
{
// 生成したインスタンスをすべて解放
// Addressables.InstantiateAsync で生成されたオブジェクトは Destroy ではなく ReleaseInstance 推奨
foreach (var obj in spawnedObjectList)
{
if (obj != null) {
// �，諒�法で生成している場合の解放方法
prefabReference.ReleaseInstance(obj);
// �△諒�法で生成している場合の解放方法
Addressables.ReleaseInstance(obj);
}
}
spawnedObjectList.Clear();
}
}
public AssetReference prefabReference; の宣言ですが、この型指定は汎用的な指定です。そのため、どのようなデータ型でもアサインできます。
AssetReferenceGameObject 型も用意されており、アサインできる型をプレハブ(GameObject 型)に限定して問題ないのであれば、こちらの宣言の方が型安全です。
MonoBehaviour.destroyCancellationToken は MonoBehaviour が破棄されたときに発生するキャンセルトークンです。
Unity 2022.2 以降または 6000.0 以降で利用できます。
Addressables.InstantiateAsync() は、ロードとインスタンス化を同時に行う便利なメソッドです。
ただし、Addressables を事前ロードしておいて使い回す場合は Addressables.LoadAssetAsync → Instantiate の方が効率的です。
ReleaseInstance() は「Addressables.InstantiateAsync で生成したオブジェクト」専用の解放関数なので、普通の Instantiate とは扱いが異なります。
参考サイト
Unity 公式スクリプトリファレンス
MonoBehaviour.destroyCancellationToken
https://docs.unity3d.com/ja/2023.1/ScriptReference...
Unity 公式マニュアル
Method InstantiateAsync
https://docs.unity3d.com/ja/Packages/com.unity.add...
Unity 公式マニュアル
Method ReleaseInstance
https://docs.unity3d.com/ja/Packages/com.unity.add...
Addressables を使わずに、非同期で Instantiate したい場合
最初の１つ目の生成だけ同期的に生成し、２つ目の生成以降は非同期で生成する方法を紹介します。
たとえば画面の最初に表示するオブジェクトのみを生成しておいて、２つ目以降は順次裏側で生成されれば間に合うようなケースを想定しています。
複数のオブジェクトをまとめて生成して画面が止まって見えてしまうような場合には効果的です。
using UnityEngine;
using Cysharp.Threading.Tasks;
using System.Threading;
using System.Collections.Generic;
public class AsyncViewSpawner : MonoBehaviour {
public View viewPrefab; // 自作クラスをアタッチしてあるプレハブ
public Transform viewTran; // 生成位置
public int spawnCount = 5;
public float spawnInterval = 1.0f;
private List<View> viewList = new();
private void Start() {
await CreateViewAsync(destroyCancellationToken).Forget();
}
/// <summary>
/// View を生成する（1つ目を同期で待機、2つ目以降を非同期で並列実行）
/// </summary>
protected async UniTask CreateViewAsync(CancellationToken cancellationToken) {
// View の生成と設定
for (int i = 0; i < spawnCount; i++) {
int index = i;
// 非同期生成(生成は１つであっても配列で受け取る)
UniTask<View[]> createTask = InstantiateAsync(viewPrefab, viewTran).ToUniTask(); // worldPositionStays: false の指定不要
// 最初の１つ目のみ
if (index == 0) {
// 同期で非同期生成が終るまで待機
View[] viewArray = await createTask;
// 待機後、生成されたオブジェクトを取り出す
View view = viewArray[0];
// 必要に応じて初期設定と配置位置設定
view.SetUpView();
view.transform.localPosition = Vector3.zero;
viewList.Add(view);
} else {
// ２つ目以降は非同期で生成
createTask.ContinueWith(viewArray => {
// 非同期生成後にオブジェクトを取り出す
View view = viewArray[0];
// 必要に応じて初期設定と配置位置設定
view.SetUpView();
view.transform.localPosition = Vector3.zero;
viewList.Add(view);
return UniTask.CompletedTask; // UniTaskバージョンの戻り値
}).AttachExternalCancellation(cancellationToken).Forget();
}
}
}
}
同期生成内の処理と非同期生成の処理で重複している処理がありますので、メソッド化を検討するとよりよいコードになります。
/// <summary>
/// 生成後の初期設定とリスト登録
/// </summary>
private void InitializeView(View view) {
view.SetUpView();
view.transform.localPosition = Vector3.zero;
viewList.Add(view);
}
またオブジェクトプールと一緒に利用することで再利用性も高まります。
まとめ
この記事では、UniTask と通常のプレハブを利用した同期オブジェクトの生成処理と、非同期オブジェクト生成処理について解説しました。
１．UniTask を利用した非同期処理により、フレームパフォーマンスを維持。 ２．柔軟なキャンセル処理の組み込み。
オブジェクトの生成はコストのかかる処理でありますが、同期的な生成処理が適しているか、あるいは非同期処理でも問題がないのか、
これらを適切な場面で使い分けることで柔軟な処理を実装できるようになります。
特にプロジェクトでの非同期処理の最適化を行う際には、こういった部分を念頭においてチャレンジしてみてください。
参考サイト
参考にさせていただきました。ありがとうございました。
Zenn amp 様
【Unity】InstantiateAsyncの使い方と速度検証
https://zenn.dev/ambr_inc/articles/1636d59bdf8786
Hatena Blog MRが楽しい 様
UnityでMonoBehaviourの破棄を検知するキャンセルトークンを参照する
https://bluebirdofoz.hatenablog.com/entry/2024/10/...
LIGHT11 様
【Unity】Unity6から追加された「InstantiateAsync」でオブジェクトを非同期生成する
https://light11.hatenadiary.com/entry/2024/12/18/1...
LIGHT11 様
【UniTask】キャンセル時に例外を発生させずにハンドリングできるSuppressCancellationThrowの使い方
https://light11.hatenadiary.com/entry/2025/04/17/1...
コメントをかく