アセットバンドルの管理について

⾃自⼰己紹介 $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE • 中村克也 •
エンジニアマネージャー • Unityを使⽤用した社内ライブラリ開発・運⽤用 • 社外窓⼝口 • エンジニアのリクルート

アジェンダ $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE • Unity4からUnity5へ •
Unity5の新要素について • シングルマニフェスト • バリアント • 依存関係 • リソース管理理 • ロードAPIと圧縮 • Jenkins連携 • おまけ • 質疑応答

• Cygamesでは、Unity5リリースと同時期に開発中プロジェクトに関してはUnity5へ移⾏行行 • Unity4からの変更更部分で⼤大きい部分は、アセットバンドルビルド • Unity4のビルド資産を破棄して、再構築を試みる • とりあえず作って、使ってみる、後追いでリファクタリ
ング（他PJへ横展開できるように） $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

<講演ファイル> http://japan.unity3d.com/unite/unite2015/files/DAY1_̲1300_̲room2_̲Ito.pdf <サンプルプロジェクト> http://files.unity3d.com/vincent/assetbundle-‐‑‒demo/users_̲assetbundle-‐‑‒demo.zip $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE
2015/3 Unity5リリース Unite2015での講演からベースはこれを参考に進めました。

アセットバンドルに関しては、シングルマニフェストとバリアントの２つが⼤大きな機能追加ですが、今回のプロジェクトでは両⽅方とも使⽤用することをやめました。 $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

全アセットバンドルのCRC/依存関係/ハッシュなどを持った、⼀一意のファイル BuildPipeline.BuildAssetBundlesで指定した出⼒力力フォルダ名で出⼒力力される $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

シングルマニフェストの中⾝身個別マニフェストの中⾝身 CRC/Hash/Dependenciesの情報を持ってて便便利利 $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

なぜ使わないのか。『１回のビルド出⼒力力で１つのシングルマニフェストが作成される』これがネック。 $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

例例えば、上記のようなフォルダを⽤用意してアセットを管理理する場合フォルダ（カテゴリ）ごとにビルドしたい！というニーズに３つのAndroid.manifestが作成される。 root Assets Resources Bg 背景画像 Chara キャラ画像
3d 3dアセットフォルダ構成 Android.manifest （Bg） Android.manifest （Chara） Android.manifest （3d）同名なので管理理できない $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

結果、同等の情報を持った独⾃自のリソースリストを作成することに。カテゴリごとに、name/hash/version/groupをCSVでアセットバンドルビルド時に出⼒力力するように。 name hash version group bg_001.unity3d 621a0f92b9f32c8126f2aa6af5ab4cc7
00000000 common bg_002.unity3d 3d534a8f488cdf3f50837d7ed337d2c3 00000000 common bg_101.unity3d 45b0bab78240018ee411401410c2dbe2 00000000 tutorial_g1 bg_102.unity3d 4095525f35ea45a83ddf67b8ec4178ff 00000000 tutorial_g2 bg_103.unity3d 66d254f9fb533dcf90463f7d96ce2a54 00000000 every bg_104.unity3d 7798907c2e4d18a0f3b5e509377e7680 00000000 every Unity4でも同じことしてました。。 $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

解決策はある出⼒力力先を変えることで、名前が変えられる分散出⼒力力されるマニフェストとランタイム側で複数マニフェストを管理理することで解決はします。 AndroidBg.manifest（Bg） AndroidChara.manifest （Chara） Android3d.manifest （3d）開発中の運⽤用が複雑になる。
独⾃自フォーマットのリストには柔軟性で敵わない。 Groupタグとか便便利利 $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

HD（⾼高画質）とSD（標準画質）を同じアセットとして扱える仕組み $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE Hoge.unity3d.hd Hoge.unity3d.sd
別のバンドルを同じものと⾒見見なして切切り替えする

なぜ使わないのか。『プロジェクトにHD/SD２つのリソースを管理理する必要がある』これがネック。 $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

デザイナーには、HD版１リソースで作業させる（SD版を意識識させたくない） SD版は⾃自動⽣生成するように、対象はテクスチャです。変換svを別途⽤用意、変換処理理を経由してアセットバンドルビルドsvへ Repository 変換sv Build sv リソースsv
リサイズ（50%） & 減色 clone cp rsync $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

サウンドとムービーは⾃自動化しない⾼高⾳音質（画質）/標準⾳音質（画質）は、デザイナにそれぞれ出⼒力力してもらい、リポジトリでHD/SDを管理理 Repository 変換sv Build sv リソースsv リサイズ（50%）
& 減色 clone cp rsync clone AB(HD)/Sound/Movie AB(SD) サウンド、ムービーも品質を分けるのでCygamesでは HD/SD-‐‑‒>High/Lowと呼ぶように $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

リソースサーバーの階層構造 00000000/High/AssetBundle/Android など品質をデバイスのスペックに合わせて変更更するバージョン品質種類プラットフォーム 00000000 High
AssetBundles Android 00000001 Low Sounds iOS 01010001 Movies PC $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

品質レベル基準デバイスの搭載RAMで判断、アプリ初期化時にデバイスチェック。 512Mb未満は『Low』 512Mb以上は『High』デフォルトで決まった品質レベルは、オプション画⾯面などでユーザーが任意で切切り替えられるように動的に対応できるようにする。切切り替え後は、対象の種類ごとにストレージから全削除し再ダウンロードさせる。共存不不可。
$POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

Low版の必要性搭載RAM512Mb未満の端末は、国内Android端末では2012 年年初発売端末までさかのぼる。 iOSはiPhone4s（2011年年）以前。シェア的に微妙なところ、⾮非推奨とした上で採⽤用判断はプロジェクトにお任せ $POGJEFOUJBM $PQZSJHIU $ZHBNFT
*OD "MM3JHIUT3FTFSWFE

Unity4では、PushしてPopして、ビルドシーケンスが複雑いつロードされて破棄されてるのか不不明確シングルマニフェスト使いたくない（前述の独⾃自リソースリスト使いたい） $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

アセットバンドルは、共有アセットバンドルと固有アセットバンドルを分けて作成 CommonShader CommonMaterial Model001 ModelTexture001 CommonTexture 3DCommonShader.unity3d 3DCommonTexture.unity3d 3DCommonMaterial.unity3d
3DCharaModel001.unity3d 3D Build Group ModelMaterial001 AssetImporter::assetBundleNameを全て設定してから BuildPipeline.BuildAssetBundles() アセットの依存が残り、依存するアセットは固有バンドルに格納されない $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

シーン単位なのか、画⾯面単位なのか、アセットのライフスパンを明確にして、共有アセットバンドルのロード固有アセットバンドルのロード、アンロードを管理理する Object/ABの破棄固有AB DL/Load Load順番は、⼦子からある⼀一定の状態（バトル、xx画⾯面など）開始処理理
終了了処理理 CommonShader CommonTexture CommonMaterial Model001 共有AB DL/Load $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

①１プロジェクト構成ソースコード（アプリ）、リソースを１つのプロジェクトに全て含める $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE Game
script resources Prein 3D UI Card resources 3D Editor script Editor script resources UI Editor script BG resources Prein Game script Title. unityproject Title. unityproject 3DWork. unityproject UIWork. unityproject ②複数プロジェクト構成アプリとカテゴリごとのリソースで分ける 3D/UI/Cardなど、アセットバンドルビルド⽤用プロジェクトに分ける

メリット、デメリットを考える ①１プロジェクト構成リソース作成-‐‑‒>即時プレビュー。ゲーム上で確認したい。プロジェクトの肥⼤大化。 ②複数プロジェクト構成プロジェクトはシンプル。作業に必要なプロジェクトだけ使う確認に⼿手間がかかる（ビルドしてサーバーアップして。。） ※カードビューアー、モデルビューアーといった最終形を担保できるツールを別途⽤用意する必要がある
結果：①を採⽤用することにソースとリソースのリポジトリは分けます $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

root Assets ①_ProjectName Resources プリインストールリソース Scenes Scripts ②_ProjectNameResources Resources アセットバンドルリソース
リソースリポジトリで管理アプリビルド時はcloneしない ③_ProjectNameDebug xxx デバッグツールなどアプリビルド時にフォルダごと削除 Plugins StreamingAssets その他assetフォルダプロジェクトフォルダ構成 $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

１プロジェクト構成のメリットは、ローカルに置いたアセットを直接ロードできるアセットバンドルとローカルアセットのロードを吸収するクラスでResourcesのロードをラップする public T LoadObject<T>(string assetName, string objectName,
bool isServerResources = true) where T : Object { if (!isServerResources) { // Resourcesから return Resources.Load<T>(objectName); } else { // AssetBundleから var o = assetManager.LoadObject(assetName, objectName, typeof(T)); if (o != null) { return (T)o; } // なければResourcesから T resource = Resources.Load<T>(objectName); return resource; } } $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

アセットバンドルのダウンロード WWW.LoadFromCacheOrDownload ・キャッシュサイズ上限・Caching.ready肥⼤大化・150⽇日制限⻑⾧長い運営を⾒見見据えると不不向き前述した、独⾃自のリソースリストで管理理するようにして WWW.LoadFromCacheOrDownloadを使わないように $POGJEFOUJBM $PQZSJHIU
$ZHBNFT *OD "MM3JHIUT3FTFSWFE

・アプリ初期化時に最新のリソースリストをダウンロードしておく・アセットバンドルを１度度DLしたらハッシュをセーブする・２回⽬目以降降は、セーブしたハッシュと独⾃自リストのハッシュ、バージョンから再DLチェック・差分があれば再DL この繰り返し初期化時：リソースリストダウンロード ②差分ありダウンロード（www） ③ハッシュセーブ
①セーブデータハッシュチェック $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

アセットバンドルからのロード AssetBundle.CreateFromFileを使⽤用したいのですが、 BuildAssetBundleOptions.UncompressedAssetBundle 付けないとロード出来ない（無圧縮アセットバンドル）おおよそな数値ですが、実例例では 5,000アセットバンドルで2.5GBくらいになってしまった。 $POGJEFOUJBM $PQZSJHIU $ZHBNFT
*OD "MM3JHIUT3FTFSWFE

アセットバンドル⾃自体を圧縮することに。 5,000ファイル：2.5GB -‐‑‒> 450MB ※アルゴリズムは⾮非公開。アセットバンドルビルドシーケンスアセットバンドルロードシーケンス AssetImporter.assetBundleName BuildPipeline.BuildAssetBundles
圧縮ハッシュ生成リソースリスト生成 www ダウンロード解凍 AssetBundle.CreateFromMemory 管理クラスに登録圧縮したままストレージへ保存解凍時にメモリに乗るのでFromMemory使う $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

$POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE アプリとアセットバンドルのビルドは、Jenkinsで⾃自動化、 NightlyBuild（安定版）と⼿手動ビルドを使い分ける出⼒力力されたアプリは、配布サーバーへ転送される出社と同時に、最新リソースでチェックできるように

ビルドマシン：Mac mini（2012年年モデル Intel Core i5 2.5GHz）アプリビルド３０分、アセットバンドルビルド２時間（１プラットフォーム）ビルドマシン：Mac Pro（mem
64GB DDR ECC）アプリビルド５分、アセットバンドルビルド１５分（１プラットフォーム） $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

PC High/Low BuildTarget.WebPlayer iOS High iOS Low Android High Android
Low PC/iOS/Android Low 画像コンバート $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

Mac Pro ５台！やりすぎ反省省。。現在は１台の並列列jobで⼗十分対応できてます $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD
"MM3JHIUT3FTFSWFE

LTE7GB超過したユーザーの国内キャリアの128kbps速度度制限対策 iOSの場合、（「設定（デベロッパ）」）で通信速度度変更更できるファイルサイズ６、７Mbくらいでダウンロードできなくなっているアセットバンドルを細かく、多くの⽅方針が功を奏して１ファイルのサイズを軽減していたでもオーバーするものもあったサウンド、ムービーなどダウンロードしないオプションを⽤用意サイズオーバーしているムービーは泣く泣く削除したり。おまけ $POGJEFOUJBM
$PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

• シングルマニフェストは使わず、依存関係は使い⽅方でカバー • バリアントは、サーバーリソースでスイッチする • LoadFromCacheOrDownloadを使わず、バージョンチェックは⾃自作リストでまかなう • ⾮非アセットバンドル状態のリソースを使えるように •
jenkinsで常に最新のアプリ、アセットバンドルを提供するように振り返り $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

懇親会で気軽にお声掛けください。質疑応答 $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

アセットバンドルの管理について

アセットバンドルの管理について

Cygames, Inc. PRO

Transcript

⾃自⼰己紹介 $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE • 中村克也 •

アジェンダ $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE • Unity4からUnity5へ •

アジェンダ $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE • Unity4からUnity5へ •

<講演ファイル> http://japan.unity3d.com/unite/unite2015/files/DAY1_̲1300_̲room2_̲Ito.pdf <サンプルプロジェクト> http://files.unity3d.com/vincent/assetbundle-‐‑‒demo/users_̲assetbundle-‐‑‒demo.zip $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

アセットバンドルに関しては、シングルマニフェストとバリアントの２つが⼤大きな機能追加ですが、今回のプロジェクトでは両⽅方とも使⽤用することをやめました。 $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

アジェンダ $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE • Unity4からUnity5へ •

全アセットバンドルのCRC/依存関係/ハッシュなどを持った、⼀一意のファイル BuildPipeline.BuildAssetBundlesで指定した出⼒力力フォルダ名で出⼒力力される $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

シングルマニフェストの中⾝身個別マニフェストの中⾝身 CRC/Hash/Dependenciesの情報を持ってて便便利利 $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

なぜ使わないのか。『１回のビルド出⼒力力で１つのシングルマニフェストが作成される』これがネック。 $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

例例えば、上記のようなフォルダを⽤用意してアセットを管理理する場合フォルダ（カテゴリ）ごとにビルドしたい！というニーズに３つのAndroid.manifestが作成される。 root Assets Resources Bg 背景画像 Chara キャラ画像

結果、同等の情報を持った独⾃自のリソースリストを作成することに。カテゴリごとに、name/hash/version/groupをCSVでアセットバンドルビルド時に出⼒力力するように。 name hash version group bg_001.unity3d 621a0f92b9f32c8126f2aa6af5ab4cc7

アジェンダ $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE • Unity4からUnity5へ •

HD（⾼高画質）とSD（標準画質）を同じアセットとして扱える仕組み $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE Hoge.unity3d.hd Hoge.unity3d.sd

なぜ使わないのか。『プロジェクトにHD/SD２つのリソースを管理理する必要がある』これがネック。 $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

サウンドとムービーは⾃自動化しない⾼高⾳音質（画質）/標準⾳音質（画質）は、デザイナにそれぞれ出⼒力力してもらい、リポジトリでHD/SDを管理理 Repository 変換sv Build sv リソースsv リサイズ（50%）

リソースサーバーの階層構造 00000000/High/AssetBundle/Android など品質をデバイスのスペックに合わせて変更更するバージョン品質種類プラットフォーム 00000000 High

アジェンダ $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE • Unity4からUnity5へ •

Unity4では、PushしてPopして、ビルドシーケンスが複雑いつロードされて破棄されてるのか不不明確シングルマニフェスト使いたくない（前述の独⾃自リソースリスト使いたい） $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

アセットバンドルは、共有アセットバンドルと固有アセットバンドルを分けて作成 CommonShader CommonMaterial Model001 ModelTexture001 CommonTexture 3DCommonShader.unity3d 3DCommonTexture.unity3d 3DCommonMaterial.unity3d

アジェンダ $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE • Unity4からUnity5へ •

①１プロジェクト構成ソースコード（アプリ）、リソースを１つのプロジェクトに全て含める $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE Game

root Assets ①_ProjectName Resources プリインストールリソース Scenes Scripts ②_ProjectNameResources Resources アセットバンドルリソース

１プロジェクト構成のメリットは、ローカルに置いたアセットを直接ロードできるアセットバンドルとローカルアセットのロードを吸収するクラスでResourcesのロードをラップする public T LoadObject<T>(string assetName, string objectName,

アジェンダ $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE • Unity4からUnity5へ •

アジェンダ $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE • Unity4からUnity5へ •

ビルドマシン：Mac mini（2012年年モデル Intel Core i5 2.5GHz）アプリビルド３０分、アセットバンドルビルド２時間（１プラットフォーム）ビルドマシン：Mac Pro（mem

PC High/Low BuildTarget.WebPlayer iOS High iOS Low Android High Android

Mac Pro ５台！やりすぎ反省省。。現在は１台の並列列jobで⼗十分対応できてます $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD

懇親会で気軽にお声掛けください。質疑応答 $POGJEFOUJBM $PQZSJHIU $ZHBNFT *OD "MM3JHIUT3FTFSWFE

More Decks by Cygames, Inc.

Other Decks in Programming

Featured