CRIWARE Unity Plugin Manual  Last Updated: 2024-12-05
アセットのインポート
Asset Supportアドオンで対応している拡張子のファイルをUnityアセットとしてインポート可能になります。
ファイルはプロジェクト内の任意のフォルダー内に配置可能です。

注意
ファイル名に日本語などの多バイト文字が含まれると、DeployTypeの設定や実行環境によっては正しくロードできない場合があります。
可能な限り多バイト文字を避けたファイル名での取り扱いをおすすめします。

Deploy Typeの設定

インポートした各ファイルをEditor上で選択すると、Inspector上でDeploy Typeの設定が行えます。
Deploy Typeは、「アセットの実データをどこに配置するか」の設定です。
ビルド実行時を考慮してファイルのロード方法に応じた設定を行ってください。
addon4u_assetsupport_deploytype.png
Deploy Type の設定

Deploy Type毎の動作の違い
種別 実データの配置 設定を推奨するデータ
StreamingAssets
(デフォルト)
StreamingAssetsフォルダーにコピーされ、
ビルドバイナリに含まれます。
システム音のSE/BGM用ACB/AWBなど、
ビルドバイナリに含めるデータ。
OnMemory アセットそのものに含まれます。 ACF、追加ダウンロード用のACB。
Addressables Addressable Asset Systemで設定したパスに配置します。 Addressablesで管理するAWB、USM。
Addressables (Remote) Addressable Asset Systemで設定したRemoteBuildPathに配置します。 互換性維持のために残しているオプションです。Addressablesをご利用ください。
Addressables (Local) Addressable Asset Systemで設定したLocalBuildPathに配置します。 互換性維持のために残しているオプションです。Addressablesで管理するデータ。
注意
WebGLビルドの場合、ACFアセットのDeployTypeとして必ず"OnMemory"を指定する必要があります。
"StreaingAssets"や"Addressables"を指定した場合はランタイムでのACF登録ができません。
StreamingAssets
「StreamingAssets」を設定したCRIアセットは、ビルド時にCRIアセットに対応するNon-Asset CRIデータがStreamingAssetsフォルダー内にコピーされ、ビルドバイナリに含まれます。
StreamingAssetsに配置したデータはビルド後にクリーンアップされます。
サーバーレスなアプリの場合はすべてのアセットに対して本設定を行えば、ファイル種別に応じて適切にオンメモリロード/ストリーミング再生が動作します。
OnMemory
「OnMemory」を設定したアセットは、アセットそのものにバイト列として実データが含まれます。
このため、アセットをロードした瞬間にファイルの実データがメモリ上に展開されます。
Addressableと併用する場合でも本設定を利用できます。
ACFやACBについては、いずれにせよADXへの登録時にメモリ上に展開されるため、本設定を推奨します。
ストリーミング再生用の波形ファイルであるAWBについては、本設定は利用できません。
注意
Addressables を利用せずに直接 AssetBundle から 「OnMemory」 のアセットを複数回ロードすると、同じ内容のデータがメモリ上で複製されます。
Addressablese Asset Systemを併用しない場合は、ロード済みアセットのキャッシュ機構を用意して多重ロードを回避してください。
「OnMemory」 のアセットがアンロードされると同時にそのデータ領域もアンロードされます。
アセットを利用している期間は、アンロードされないよう参照を保持し続けることをおすすめします。
Addressables
「Addressables」を設定したCRIアセットは、Addressable Asset Systemのビルド時に、CRIアセットに対応するNon-Asset CRIデータが各グループごとのBuildPath に配置されます。
ロード時にはアセット本体と共にNon-Asset CRIデータをダウンロードします。
詳しくは「 CRI Addressables の利用方法 [0.7.00 未満] 」をご参照ください。

独自の Deploy Type の追加

ICriAssetImplCreator インターフェイスを実装したクラスを定義することで、DeployType を追加することができます。
これにより、独自のリソース管理の仕組みに CRI アセットを対応させることが可能です。
詳しくは「 [Asset Support] DeployType の拡張 」をご参照ください。