Unity 6世代のコンテンツ管理最前線 ― AddressablesとContent Directories

4.5K Views

November 18, 26

スライド概要

profile-image

リアルタイム3Dコンテンツを制作・運用するための世界的にリードするプラットフォームである「Unity」の日本国内における販売、サポート、コミュニティ活動、研究開発、教育支援を行っています。ゲーム開発者からアーティスト、建築家、自動車デザイナー、映画製作者など、さまざまなクリエイターがUnityを使い想像力を発揮しています。

Docswellを使いましょう

(ダウンロード不可)

関連スライド

各ページのテキスト
1.

本資料に関する注意事項 本資料は、⼀般的な情報提供⽬的で作成されたものであり、本資料に記載したいかな る内容も、契約内容を構成するものではありません。 いかなる購買決定も、本資料に基づいてされることのないようにご注意ください。 本資料に記載したいかなる機能、コード、サービス内容についても、提供をお約束す るものではありません。 本資料に記載した製品、サービス、機能の開発およびリリース時期については、Unity の判断により決定され、変更の可能性があります。

3.

Unity 6世代の コンテンツ管理最前線 〜AddressablesとContent Directories〜

4.

黒河 優介 Allen Hsu Senior Partner Engineer Senior Partner Engineer

5.

→ Unity 6世代での AssetBundleの改善内容 Agenda → Content Directories について → Addressables 4.x へ更新 Content Directories を使うために

6.

Unity 6世代での AssetBundleの改善内容 Unity6.3でのTypeTreeキャッシュ Unity6.5でのTypeTree外部アセット化

7.

Unity 6世代での AssetBundleの 改善内容 → Unity 6.3 TypeTreeキャッシュによる メモリ削減 → Unity 6.5 TypeTree外部化による ファイルサイズ削減

8.

TypeTree と ? ● バイナリデータ 構 ● データレイアウト ● を記述するため 内部データ 違いを吸収するため データ ○ Editor上で安全にAssetBundleを読むことが出来る ○ 古いバージョンでビルドしたAssetBundleも読むことが出来る デフォルトで ○ AssetBundleファイル毎にデータが含まれている Buildオプション次第で変更可能

9.

TypeTree と ? TypeTree float power; Vector3 position; GameObject target; name type size offset power float 4 bytes +0 position Vector3 12 bytes +4 target PPtr<GameObject> 12 bytes +16 こ ようなデータを持つことによってデータレイアウト 違いを吸収できる

10.

Unity 6.3 より前 Load中 TypeA TypeTree メモリ内で 重複 AssetBundle A Load中 TypeTree TypeA AssetBundle B TypeTree name type size offset name type size offset power float 4 bytes +0 power float 4 bytes +0 position Vector3 12 bytes +4 position Vector3 12 bytes +4 target PPtr<GameObject> 12 bytes +16 target PPtr<GameObject> 12 bytes +16 重複 Unity 6.3より前で 同じTypeTree情報が ロードされたAssetBundle毎に重複してメモリに存在

11.

Unity 6.3 以降で Load中 TypeA TypeTree キャッシュによるメモリ AssetBundle A Load中 TypeTree TypeA name type size offset power float 4 bytes +0 position Vector3 12 bytes +4 target PPtr<GameObject> 12 bytes +16 Unity 6.3以降で キャッシュ対応 削減 AssetBundle B TypeTree 参照 、TypeTreeを重複してメモリに持たないように

12.

MemoryProfiler上での差分 ● Native Unity Subsystems → SerializedFile ● 項目に差分 Load中 AssetBundle数が多いほど効果 大きい ○ 同じような構成 AssetBundleが多 いほど効果 大きい ○ AssetBundle.Unload(false)してい る場合 ロード中で ● ない キャッシュ 参照先 、AssetBundleを Unloadされても解放されない

13.

Unity 6.5 で ● ● 外部ファイル化 AssetBundle毎に重複して含まれるTypeTreeをまとめ、別ファイルに書き出す ○ 各AssetBundleファイル ○ ケースによって サイズが少し減る 全体で100MB以上削減 Addressablesを利用しているプロジェクトで ○ ● TypeTree 利用を推奨 プルダウン一つで対応可能 Addressables 非採用プロジェクトで 利用 ○ SBPScriptable Build Pipeline)で、AssetBundleをビルドする ○ TypeTreeStoreManager APIで TypeTree ソースファイルを読み込み

14.

Addressables で TypeTree 外部化 ● Addressables 2.9.1から対応 ● TypeTree Optionで Extractを選択 ● 外部化されたファイル AssetBundle.typetreedataとして StreamingAssets以下に配置

15.

TypeTree 外部化による初期化処理 ● アプリケーション初期化時にTypeTreeファイルを読み込むコストがかかる ○ Addressables ○ Profiler上で OnCatalogLoadedでそ TypeTreeファイルを読み込む “InitializationOperation.LoadTypeTreeData()ˮ 項目

16.

TypeTree 外部化によるメモリ使用 ● TypeTree メモリ ○ 初期化時に確保される MemoryProfiler上で Native→UnitySubsystems→Managers→TypeTreeStoreManagerになる

17.

Unity 6 世代で ● ● AssetBundle 改善内容 Unity 6.3 で TypeTreeキャッシュによるメモリ削減 ○ AssetBundle数が多いプロジェクトほど削減が見込める ロード中 Unity 6.5 で TypeTree外部ファイル化 ○ AssetBundle ○ Addressables を利用している人向け ○ 初期化時に追加処理 ファイル容量削減

18.

Content Directoriesとは?

19.

Content Directories と ? ● ゲーム アセットをディレクトリ単位でまとめて書き出し、アプリケーション本体と 独立して管理・ロードが可能 ○ 従来よりあるAssetBundle ● Unity 6.6から利用可能 ● Unity 6.7 LTSでいくつか改善 ● ような事が可能 ○ シングルパスビルドによるビルド時間 ○ 決定的なシーン処理 改善 Addressablesパッケージからも利用可能 ○ backendを選択可能 ( AssetBundle / Content Directories )

20.

Content Directories について → AssetBundleでの問題点 → Content Directoriesの概要 → AssetBundleとの⽐較

21.

AssetBundle で ● アセット間 問題点 依存関係を考慮して、適切な単位でアセットを AssetBundleへ まとめる必要がある ○ 考慮していない場合、同じデータが複数 AssetBundleファイルに 重複して含まれることになる ○ Addressablesを利用している場合でも、AssetBundle 構 を 考慮する必要がある ● UnloadがAssetBundle単位になる ■ AssetBundle間 依存関係もあるため、Unload ルールが複雑

22.

AssetBundle 間で 重複 Asset bundle_b bundle_a Prefab B Prefab A 依存 重複 Texture T 依存 Texture T ・bundle_aにPrefab Aを登録、bundle_bにPrefab Bを登録。 ・Prefab A、Prefab Bが依存しているTexture T 、bundle_a / bundle_bに 重複して含まれる。ロード時にも、重複してメモリに載る

23.

重複を避けるために … bundle_b bundle_a Prefab B Prefab A 依存 bundle_c 依存 Texture T ・重複を避けるために 、Texture Tを独立した 別AssetBundleにする ・AssetBundle間で依存関係が生まれるため、bundle_aロード前にbundle_cを ロードする必要がある

24.

こうなったらいい に… ● アプリから動的にロードしたいオブジェクトたちを好きな形で管理できる ● オブジェクトを必要なタイミングでロード /破棄できる ● アセット間 依存 考慮しなくてもよい ○ データ レイアウトも考慮したくない ○ ランタイムでも依存関係を意識したくない

25.

Content Directories ● 概要 アプリから動的にロードしたいオブジェクトたちを好きな形で管理できる → ScriptableObjectでロード対象を登録 ● オブジェクトを必要なタイミングでロード /破棄できる → Loadable<T、LoadableSceneIdで任意 ● アセット間 依存 → 依存関係 考慮しなくてもよい 自動的に解決 タイミングでロード

26.
[beta]
ScriptableObject でロード対象を登録
// ScriptableObjectを定義して、ロード対象

アセットを登録

public class MyGameAssetData : ScriptableObject{
// Loadable<Tとする事で、必要なタイミングで動的ロードが可能
public List< Loadable<GameObject>> gameItems;
// Dictionaryでもシリアライズ可能
[SerializeField]
public Dictionary<string, Loadable<GameObject>> playableCharacters;
// Sceneも LoadableSceneIdで動的ロードが可能
public LoadableSceneId sceneId;
}

27.

Content Directories ビルド Directoryに書き出すScriptableObject 事を「Root Asset」と呼 ぶ。複数 ScriptableObjectから、一つ ディレクトリへ が可能 書き出し

28.

Content Directories ビルド 「BuildPipeline.BuildContentDirectory」APIを利用して、 ScriptableObjectに登録されたアセット、及び依存先アセットをディレク トリに書き出し

29.

Content Directories ビルドコード // ContentDirectoriesビルド パラメーターセットアップ var param = new BuildContentDirectoryParameters{ outputPath = Application.streamingAssetsPath + "/BuiltInContents", rootAssetPaths = new[] { "Assets/MyGameAssetData.asset" }, compression = BuildCompression.LZ4, // UseArchiveで ファイル まとまり、それ以外で 個別ファイル options = BuildContentOptions.UseArchive, }; // ContentDirectories ビルド、返り値としてビルドレポートが返ります var report = BuildPipeline.BuildContentDirectory(param );

30.

BuildContentOptions による違い BuildContentOptions.UseArchive ビルドオプションによって、 1つ ファイルにアーカイブされるか、 個別 ファイルに分割される UseArchiveなし

31.

UseArchive なし ● ダウンロード配信で何度も配信するケースで 利用を推奨 ○ データ更新時、ファイルが細かく分割されているた めダウンロード 差分 あるアセットだけで抑えら れる ● ファイル数が増えても、HTTP2対応によって ダウンロード時間 抑えられる

32.

BuildContentOptions.UseArchive ● アプリ内埋め込みなどで利用を推奨 ● BuildManifestHash.txtとarchiveファイル ● resSファイルやcfファイル、jsonファイル み archiveファ イルにまとめられる ○ archiveファイル 展開可能 、WebExtract.exeで

33.

Content Directories ロード 実行時に、「ContentLoadManager.RegisterContentDirectory」 で ディレクトリを登録。複数ディレクトリ 登録が可能。 AssetBundleと異なり、ディレクトリ同士 ※重複ファイルを除外すること 可能 依存関係 ない

34.
[beta]
Content Directories でロードするコード
var path= Application.streamingAssetsPath + "/BuiltInContents";
// ContentDirectories

ディレクトリを登録 UnregisterContentDirectoryで 破棄も可能 )

var handle = ContentLoadManager.RegisterContentDirectory(path);
// RootAssetをhandle経由で取得
var rootassets = ContentLoadManager.GetRootAssets<MyGameAssetData >(handle);
foreach (var root in rootassets ){
var loadable = root.gameItems[0;
// Loadable<GameObject>から、実際に GameObjectをロードする処理
var prefab = await loadable.LoadAsync();
// ロードしたも を破棄する処理
loadable.Release();
}

35.

複数 ● Directory からロードする場合 アプリ埋め込みとDLCを それぞれ書き出したケース ● アセット 依存先で一部重複がある 状況を想定 BuiltInContents DLC

36.

複数 Directory からロードする場合 BuiltInContents DLC

37.

複数 Directory からロードする場合 DLC BuiltInContents ファイルが 重複

38.

複数 Directory からロードする場合 DLC BuiltInContents 削除可能

39.

Directory からロードする場合 複数 ● RegisterContentDirectory順と 逆順で RegisterContentDirectory ロードするファイルを探す ○ ● DLCフォルダになけれ BuiltInContentsフォルダを参照 Archive形式であっても、個別ファイルであっても BuiltInContents DLC 同様に処理が行われる ● 同じアセットが複数 ディレクトリに含まれている場合、 それぞれからロードするとメモリ上で重複する ○ ディレクトリ毎に独立して管理しているため ロードするファイルを探す順

40.

Content Directories とAssetBundle ● Content Directories ○ 方がビルド時間 比較 短い フルビルド時・インクリメンタルビルドともに ロード時間もContent Directories ● 実行時 ● Content Directoriesで 、依存関係を考慮する必要 ○ ように自由にグループ化出来ない ● 代わりにAssetBundle 実運用を考えた際、Content Directories ○ AssetBundleで グループ内 方が い ない 方が差分ダウンロードが小さくなる 他アセットに差分が出た場合、 ファイル全体 ダウンロードが必要 ○ Content Directoriesで 差分 出たアセットだけ ダウンロードで済む

41.

Content Directories まとめ ● ScriptableObject(RootAsset)にある内容をディレクトリへ書き出し ● 実行時に ● Loadable<T や、LoadableSceneIdで動的ロードが可能 ● アセット ● AssetBundleと比較して、ロードも くなるし、ビルドも くなる ● 複数 ディレクトリへ出力する場合 、ディレクトリからRootAssetを取得する 依存関係を考慮して、グルーピングをする事から解放される ○ ディレクトリ間に依存関係 ○ 重複したファイル ない 削除する事が可能

42.

Addressables 4.x へ更新 Content Directories を使うために

43.

Addressables 3.x から backend を選択できるようになった Addressables API LoadAssetAsync / Release などはそのまま → ユーザーコードの変更は不要 AssetBundle 従来の backend(3.x 以降も利⽤可) または Content Directories 3.x から選択可能になった新しい backend 3.x:ユーザーコードを変えずに Content Directories を選択できる最初のバージョン 4.x (推奨):互換性‧安定性が向上し、ビルド時間も短縮

44.

使い⽅はプロジェクトのフェーズや要件に応じて選択 現時点では、どちらの使い⽅も公式にサポートされている Addressables をすでに使っている場合 Addressables + Content Directories ● ● カタログ機能や既存コードをそのまま活 かせる ロード時間の短縮とメモリ管理の恩恵を 受けられる 新規でシステムを構築する場合 / Addressables の複雑さを避けたい場合 Content Directories 単独 ● ● ● 公式も正式なアプローチとして想定 新しい Loadable<T API と Root Asset ベースで管理 よりシンプルにコンテンツ配信を構築で きる

45.

Unity 6.6 では Local group のみ Content Directories に切り替え可能 Local group → Content Directories / Remote group → AssetBundle のまま 要件:Unity 6.6  Addressables 3.x 以上(4.x 推奨) Content Directories を backend にするメリット ● ● ● 粒度 細かい構成により、メモリ使⽤量や bundle サイズなどが改善 Bundle の packing 方針を考える必要がなくなる ソースコードの変更は必要なし ○ 強く推奨 △ 注意して移⾏ Local group のみのプロジェクト Local + Remote group のプロジェクト リスクが少なく、そのまま移⾏できる Hybrid backendで対応可能 hash 変化による再ダウンロードと、依存関係によ る Asset の複製に注意(詳細は後のスライドで)

46.

Content Directories への切り替え⼿順 ● Package Manager で Addressables を 4.x に更新 ● Group を右クリックし、Convert schema(s) to Content Directory を選択 ● 新しい Group としても追加可能

47.

Default Build Script が BuildScriptSchemaDriven に変わった ● ● 「ビルド = AssetBundle を⽣成する」という前提が なくなった Group Schema ごとに対応する builder がビルドを 担当する ① 準備 build context を作成し、 builder を初期化 ② 収集 各Groupが使⽤するschemaを確 認し、builder に渡す (まだ書き込まない) ⚠ カスタム Build Script を使っていた場合は追加の対応が必要 ③ 書き込み ビルドを実⾏し、各builderの結 果をマージしてcatalog を書き 出す

48.

ビルド成果物 ● content0.archive: コンテンツを 1 ファイルにまとめたもの(UseArchive == true) ○ ○ ○ ○ ● .cf:Scene や Asset のオブジェクトデータ .resS:Mesh や Texture など、streaming ⽤の⼤きなデータ .resource:Audio や Video などのデータ <hash>.json:build manifest 本体(ファイル名は hash 値) BuildManifestHash.txt: 最新の manifest の hash を記録し、Unity が参照先を特定するの に使う

49.

Build Analysis - 1 (余談) ● Window > Analysis > Build Analysis Overview) ● ビルドサイズ、各ステップ の所要時間、ログなどの 確認ができる

50.

Build Analysis - 2 (余談) ● 右クリック > Show in Explorer ● ⾃動的に記録される → ビルドごとにログ、Profiling データを保存 ContentLayout.json: ソースアセットと出⼒ファイル(.cf)の 対応関係、依存関係、サイズ情報を記録 BuildContentTEP.json: Trace Event 形式、Perfetto で閲覧可能 ● ビルドサーバーとの相性も良い → CI 上で report フォルダをアーカイブ → ダウンロードして Build Analysis や Perfetto で表⽰可能

51.

Build Analysis - 3 ● Window > Analysis > Build Analysis Assets ● Content Directories では 全て Groups = 1 Root Asset になることが分かる Library > BuildInstructions > ContentDirectoryRootAssets

52.

Runtime - ロードの流れ ● 従来と同じ API、コード変更なし ● Addressables Catalog (catalog.bin) →address / label を 内部 asset ID に解決 ● ユーザーコード(変更なし) catalog.bin Frontend: address → asset ID 旧: AssetBundleProvider → 新: NativeContentEntryAssetProvider ● LoadAssetAsync("Cube") 内部 asset IDを使い、ContentLoadManager ContentLoadManager + Manifest Backend:asset ID → chunk の場所 / 依存関係 が Content Directory manifest に基づいて実 データをロード content0.archive → Asset .cf / .resS / .resource をロード

53.

Runtime - Release と Unload の単位 • Addressables.Release と ref-count ベースのライフタイム管理 → 変更なし • 変わる点:Unload の単位 AssetBundle Content Directories bundle(bundle 全体がメモリに残る) Asset A 使⽤中 Asset B Release 済み、 メモリに残る Asset C Release 済み、 メモリに残る Asset A 使⽤中 Asset B Unload 済み Asset C Unload 済み Unload 単位 bundle 単位 Unload 単位 Asset 単位(Loadable<T) Ref-count bundle 単位で管理 Ref-count Asset 単位で管理 解放タイミング bundle 内の全 Asset が Release された時 解放タイミング Asset への最後の参照が Release された時 (または Unload(true)) →「1 つの Asset が使⽤中なだけで bundle 全体がメモリに残る」問題がなくなる → Bundle の packing 方針による余分なメモリ消費がなくなる

54.

Hybrid Backends Local CD  Remote AssetBundle) ● 既存のモバイルゲームプロジェクトの多くは remote content を持っている ● DLC group の schema が同じままでも hash は変わる Builder変更のため) → DLC bundle の再ダウンロードが発⽣ ● DLC  Local の依存関係の問題 Cross Backend の依存関係はサポートされていない DLC から local の Addressables entry を直接参照している場合、 その Asset は DLC bundle にコピーされる

55.

DLCLocal直参照の例 - 1 LocalBaseCube ┗Rock Texture ┗Rock Material DlcCubeGroups ┗LocalBaseCube ┗LocalBaseCube ┗LocalBaseCube

56.

DLCLocal直参照の例 - 2 Addressables Groups Content Directory 移⾏前の Remote ビルド結果

57.

DLCLocal直参照の例 - 3 Local GroupをContent Directory へ移⾏後の Remote ビルド結果 ⚠ Texture と Material が意図せずコピーされている

58.

コピーの回避⽅法 AssetReference で直接参照を避け、コードからロードする

59.

Shared Bundle 設定 ● monoscript.bundle →各バンドルが参照するスクリプトの情報を1か所 にまとめた共有バンドル Addressables 2.6 以降はデフォルトで有効 →各バンドルに散らばるスクリプト参照を1か所に まとめ、重複ロードを防ぐ Local Group に置くのが望ましい Legacy schema の Group が 1 つ必要

60.

まとめ ● Unity 6.6  Addressables 3.x から、Addressables の Local Group は backend を Content Directories に切り替え可能 → 4.x (推奨バージョン)でさらに互換性とビルド速度が向上 ● コード変更は不要 ● Remote group を持つプロジェクトも現時点で hybrid backend を使⽤できるが、 DLC bundle への影響を考慮する必要がある → Hash の変化により DLC の再ダウンロードが発⽣ → DLC から Local への直接参照により Asset が重複 → monoscript.bundle を使⽤する場合 legacy Local Group を 1 つ⽤意

61.

Thank you