Wwiseヘルプ

サンプルプロジェクトとして、以下のようなコンテンツがある場合を考えます:

SoundBank生成が正常に完了すると、Wwiseによって下図のファイル構造が作成されます:

	Windowsプラットフォーム用の出力フォルダ。
	ローカライズしたSoundBank用の出力フォルダ。プロジェクトのランゲージごとにフォルダが1つずつあります。詳細はManaging languagesを参照。
	SoundBankファイルsb_hello.bnk。ローカライズされたアセット（Voice hello.wav）がSoundBankに入っているため、SoundBankもローカライズされます。
	SoundBankファイルsb_beep.bnk。SoundBankにローカライズされたアセット（SFX beep.wav）が含まれないので、SoundBankはローカライズされません。
	メタデータファイルsb_beep.json。このファイルにSoundBank sb_beep.bnkの中身のメタデータが含まれます。
	SoundBankの設定に関わらず、全プロジェクトでWwiseがInit SoundBankを自動的に作成します。
	メタデータファイルSoundBankInfo.json。このファイルに、生成された全SoundBankのメタデータが含まれます。
	メタデータファイルPlatformInfo.json。このファイルに最後のSoundBank生成設定用のメタデータが含まれます。
	メタデータファイルProjectInfo.json。このファイルにプラットフォームのリストなど、最後のSoundBank生成中のProject設定のメタデータが含まれます。

	注釈
	メタデータファイルは任意であり、ユーザのSoundBank設定に従い生成されます。詳細は 「SoundBanksタブ」 を参照してください。

前のセクションではユーザ定義（User-defined）SoundBankのための出力フォルダ構造を説明しました。User-defined SoundBanksはProject ExplorerのSoundBanksタブのリストに表示されます。

プロジェクトはSoundBankを自動定義するように設定することができます。その場合は特定のプロジェクトオブジェクトのSoundBankをWwiseが生成します。詳細は 「自動定義SoundBank」 を参照してください。

理解を深めるために 「SoundBankファイル」 で説明したサンプルプロジェクトで、以下の変更点の場合を考えます:

自動定義のSoundBankの場合、Wwiseは上記のユーザ定義のSoundBankと同じ構造を使用して、オブジェクトタイプごとに新しいSoundBank階層を作成します。更新されたサンプルプロジェクトでは、WwiseがEventとBusの自動定義SoundBank用に新しいフォルダ階層を作成します。下図に更新されたフォルダ構造と生成されるファイルを示します。

	Eventオブジェクトから自動定義されたSoundBank用に、新しいフォルダ階層が作成されます。
	新フォルダ階層にもユーザ定義SoundBank用の階層と同じローカライズフォルダがあります。

	注釈
	簡略化のため、図では以下を省略しています: メタデータファイル。Auto-defined SoundBanksのメタデータファイルは、ユーザ定義SoundBankと同じSoundBank Settingsを使って作成されます。 Bus用のAuto-defined SoundBanks。

ProjectのSoundBankには必要なすべてのメディアファイルが含まれていないことがあります。SoundBankに含まれないメディアファイルは、例えば以下のような理由で入っていません:

詳細は 「自動定義SoundBank」 を参照してください。

SoundBank Settingsの設定で、不足するメディアファイルを出力フォルダにコピーすることができます。その場合はWwiseが、コピーしたメディアファイル用に新しいフォルダ階層を作成します。詳細は 「SoundBankメディアを管理する」 を参照してください。

「SoundBankファイル」 で説明したサンプルプロジェクトに従い、Wwiseは自動定義SoundBankが参照する以下のメディアファイルを含めません:

より分かりやすくするために、Wwiseが以下のようにMedia IDを割り当てたと仮定します:

下図は、コピーしたメディアファイルを含む更新されたフォルダ構造です。

	Mediaフォルダ階層のルートフォルダ。
	Mediaフォルダにも、そのローカライズ階層があります。
	メディアファイルfootstep.wavがコピーされ、割り当てられたMedia IDを使い名前が変更されています。

大規模なProjectでは出力フォルダに何千個ものファイルが入っていることが珍しくありません。これらのファイルの大部分は、Mediaフォルダや自動定義SoundBankのフォルダに入っています。フォルダ1つあたりのファイル数を制限しているプラットフォームでは問題が発生する可能性があります。Wwiseにはフォルダ内のファイルをさらにサブフォルダに分割するためにのSub-folders for Generated Files というSoundBank設定があります。詳細は 「SoundBanksタブ」 を参照してください。

この設定を有効にすると、Wwiseが以下のタイプのファイルを移動します:

どちらの場合もファイルID（10進数形式）の最初の2桁を使い、サブフォルダ名を決めます。メディアファイルの場合は単純に、ファイル名の最初の2文字を使います。SoundBankファイルの場合は、SoundBankのIDを使います。SoundBankのIDは、それに関連するメタデータファイルやグローバルメタデータファイルのSoundBankInfo.jsonから、またはAPI関数 AK::SoundEngine::GetIDFromString を呼び出しすことで取得できます。

下図はこの設定を有効にした時の出力フォルダの中身を表しています。この例ではSoundBank名が以下のIDに解決されたと仮定します:

ユーザ定義SoundBankはサブフォルダに移動されません。サブフォルダへ分割されるのは、自動定義SoundBankフォルダやMediaフォルダのみです。