目次

コマンドラインからのバンク生成

イントロダクション

SoundBank バンク生成を含め Wwise オペレーションの多くは、コマンドラインインターフェースから利用可能です。これは、オーディオアセットを使用したデイリーゲームのビルドなど、Wwise を自動化されたプロセスの一部として統合する場合などに便利です。

コマンドライン

Windows または Macのどちらを実行しているかによって、Wwise コマンドライン 実行可能ライン、WwiseCLI.exeを呼び出すには2つの方法があります。

Windows
コマンドライン Wwise 実行可能ファイルは、WwiseCLI.exe という名前で、"%WWISEROOT%\Authoring\Win32\Release\bin" の下(32ビット版の場合)、または "%WWISEROOT%\Authoring\x64\Release\bin" の下(64ビット版の場合)にあります。コマンドラインパラメータは、projectoperation が必須であるこの構造に従う必要があります:
WwiseCLI.exe project.wproj -operation [-option1 [parameters]] [-option2 [parameters]] ...
Mac
For Mac, WwiseCLI.exe is called indirectly via the WwiseCLI.sh shell script. Macで WwiseCLI.sh シェルスクリプトを無事に実行できるようにするには:
  1. まず、まだインストールしていなければ、Applications フォルダにある Wwise.app を解凍して、オーサリング アプリケーションをインストールします。
  2. 次に、WwiseCLI.sh シェルスクリプトを実行したい各ユーザーはそれぞれ次のことを行います:
    1. Wwise.app を起動して、MS VC++ redistributableをインストールします。
    2. Wwise.appを終了します。
これで、ターミナルに、UnixまたはWindows形式のパスを使った、Windows同等のコマンドライン引数を引き渡して、WwiseCLI.sh シェルスクリプトを起動することができます。
Unix のパスの例:
 MAC:~ username$ /Path/to/Authoring/Wwise.app/Contents/Tools/WwiseCLI.sh "/Volumes/Drive/Path/to/project.wproj" -operation [-option1 [parameters]] [-option2 [parameters]] 
Windows のパスの例:
 MAC:~ username$  /Path/to/Authoring/Wwise.app/Contents/Tools/WwiseCLI.sh "Z:\Volumes\Drive\Path\to\project.wproj" -operation [-option1 [parameters]] [-option2 [parameters]] 


スペースを含む文字列パラメータは、この で示されているように引用符でラップされる必要があります。 すべてのパスパラメータは、バックスラッシュのみを使用して指定される必要があります。ただし、末尾のバックスラッシュは使用しません。

オペレーション

これらのオペレーションのうち1つをコマンドライン上で指定する必要があります:

  • -GenerateSoundBanks: SoundBank 生成。 SoundBank 生成は、プロジェクトに保存された設定に従って実行されます:SoundBank 生成がコマンドラインから起動された場合には、カスタムユーザー設定は無視されます。ただし、これらの設定の一部はコマンドラインからオーバーライド可能です。
    Note.gif
    Note: :-Platform、-Bank および/または -Language フラグが省略された場合、アプリケーションは全てのプラットフォームおよび/または言語に対して SoundBank を生成します。
  • -ConvertExternalSources: External Source 変換。External Source は、-GenerateSoundBanks でもトリガーされますが、Wwise Project に含まれていないソースを処理するために -ConvertExternalSources を使用することができます。このオペレーションには、オプションのパラメータが2つあります: プラットフォームと wsources ファイルへのパス。プラットフォームを提供すると、そのプラットフォームのみを生成します。wsources ファイルを提供すると、特定のプラットフォーム(またはプラットフォームが指定されていない場合はすべてのプラットフォーム)の Project Settings 内の External Source Input ファイルパスをオーバーライドします。例:
    • -ConvertExternalSources: すべてのプラットフォームと Project Settings に提供されているソースリストを変換
    • -ConvertExternalSources Windows: Windows プラットフォーム用のソースのみを変換
    • -ConvertExternalSources Windows -ConvertExternalSources XBox360 :Windows と XBox のみ変換
    • -ConvertExternalSources MySources.wsources :すべてのプラットフォーム上の指定されたリストを変換
    • -ConvertExternalSources Windows MySources.wsources :Windows 上のすべてのファイルを変換し指定されたファイルリストを使用
  • -SoundFrameServer: Sound Frame ライブラリを使用するクライアントアプリケーションが接続可能なコマンドライン Sound Frame サーバーを起動。このオプションへのパラメータとして任意の数字による Process ID を指定し、このサーバーが特定のプロセスとの接続のみを受け入れるようにすることができます。サーバーは、CTRL-C 信号を受信するまで実行されます。
    Note.gif
    Note: Sound Engine Operations に関連する AK::SoundEngine::ISoundFrame のメソッドは Wwise Authoring を GUI として実行する時のみに機能します。

オプション

  • -Cache: プロジェクトのキャッシュフォルダをオーバーライドして、代わりにこのコマンドで指定したパスを使用します。
  • -ClearAudioFileCache: ソースファイル変換および SoundBank 生成の前に Wwise オーディオファイルキャッシュフォルダの内容を削除し、すべてのソースファイルが確実に再変換されるようにします。このオプションは、"-GenerateSoundBanks" フラグが指定されていないと無視されます。-Platform 引数に関わらず、すべてのプラットフォームでキャッシュ全体がクリアされることに注意してください。
  • -Language: どの言語向けに SoundBank が生成されるかを指定します。このオプションの後には、以下にリストされた言語識別子のいずれかを続ける必要があります。指定の各言語には、このフラグが先頭に付けられていなければなりません。このオプションは、"-GenerateSoundBanks" フラグが指定されていない場合は無視されます。
  • Arabic
    • Bulgarian
    • Chinese(HK)
    • Chinese(PRC)
    • Chinese(Taiwan)
    • Czech
    • Danish
    • Dutch
    • English(Australia)
    • English(India)
    • English(UK)
    • English(US)
    • Finnish
    • French(Canada)
    • French(France)
    • German
    • Greek
    • Hebrew
    • Hungarian
    • Indonesian
    • Italian
    • Japanese
    • Korean
    • Latin
    • Norwegian
    • Polish
    • Portuguese(Brazil)
    • Portuguese(Portugal)
    • Romanian
    • Russian
    • Slovenian
    • Spanish(Mexico)
    • Spanish(Spain)
    • Spanish(US)
    • Swedish
    • Turkish
    • Ukrainian
    • Vietnamese
  • -Platform: どのプラットフォーム向けに SoundBank が生成されるかを指定。このオプションの後には、プラットフォーム識別子を続ける必要があります(以下に掲載)。指定の各プラットフォームには、このフラグが先頭に付けられていなければなりません。
  • 3DS
    • Android
    • iOS
    • Mac
    • PS3
    • PS4
    • VitaSW
    • VitaHW
    • Wii
    • WiiUSW
    • Windows
    • WindowsPhone
    • Xbox360
    • XboxOne
  • -CustomGlobalOpeningCmd: Wwise で定義されたグローバルオープニングステップをオーバーライドします。このオプションには、新しいコマンドラインが続けられる必要があります(スペースがある場合は引用符を使用)。コマンドラインに指定された空の文字列("")は、グローバルオープニングステップが実行されないことを意味します。
  • -CustomPreGenCmd: Wwise で該当プラットフォーム向けに定義されたカスタムプレ生成ステップコマンドラインをオーバーライド。 このオプションには、(上記の)プラットフォーム識別子が続けられる必要があり、その後に新しいコマンドラインが続けられる必要があります(スペースがある場合は引用符を使用)。別のプラットフォームのカスタムプレ生成ステップコマンドラインをオーバーライドする場合は、 -CustomPreGenCmdフラグを繰り返し、その後に別のプラットフォーム識別子とそれの新しいコマンドラインを続けます。コマンドラインに指定された空の文字列("")は、ポスト生成ステップが実行されないことを意味します。
  • -CustomPostGenCmd: Wwise で該当プラットフォーム向けに定義されたカスタムポスト生成ステップコマンドラインをオーバーライド。 このオプションには、(上記の)プラットフォーム識別子が続けられる必要があり、その後に新しいコマンドラインが続けられる必要があります(スペースがある場合は引用符を使用)。別のプラットフォームのカスタムポスト生成ステップコマンドラインをオーバーライドする場合は、 -CustomPostGenCmd フラグを繰り返し、その後に別のプラットフォーム識別子とそれの新しいコマンドラインを続けます。コマンドラインに指定された空の文字列("")は、ポスト生成ステップが実行されないことを意味します。
  • -CustomGlobalClosingCmd: Wwise で定義されたグローバルクロージングステップをオーバーライド。このオプションには、新しいコマンドラインが続けられる必要があります(スペースがある場合は引用符を使用)。コマンドラインに指定された空の文字列("")は、グローバルクロージングステップが実行されないことを意味します。
  • -Bank: どのSoundBanksが生成されるかを指定します。 このオプションは、生成するバンクの名前に従ってください。複数バンクの指定が可能です。バンクを指定しないと、すべてのバンクが生成されます。または、SoundBank名のリストが入ったテキストファイルを指定するには、拡張子.txtを含むテキストファイルのフルパスを使用することもできる。
  • -HeaderFile: Project Settings でこのオプションが指定されていない場合でもヘッダファイル Wwise_IDs.h を生成。このオプションは、"-GenerateSoundBanks" フラグが指定されていない場合は無視されます。
  • -HeaderFilePath: Project Settings で指定されているヘッダファイルパスをオーバーライド。このオプションには、ヘッダファイル(Wwise_IDs.h)が記述される(絶対または相対)パスが続けられる必要があります。 これは、ヘッダファイルの作成が必要な場合にのみ有効です。
  • -SoundBankPath: 該当プラットフォーム用に指定された SoundBank パスをオーバーライド。このオプションには、(上記の)プラットフォーム識別子が続けられる必要があり、その後に新しいパスが続けられる必要があります(絶対または相対、スペースがある場合は引用符を使用)。別のプラットフォームのパスをオーバーライドする場合は、-SoundBankPath フラグを繰り返し、その後に別のプラットフォーム識別子とそれの新しいパスを続けます。
  • -ImportDefinitionFile: 定義ファイルをインポート。このオプションには、インポートされるバンク定義ファイルのフルパスが続けられる必要があります。複数ファイルの指定が可能です。 オプション "-Save" が指定されていない場合には、定義ファイルインポートの結果としてプロジェクトに加えられた変更は永続化されません。
  • -NoWwiseDat: オーディオファイル変換時の 'wwise.dat' 隠しファイルの使用を無効化。これは、Wwise の複数のインスタンスが競合することなく同時に同じディレクトリへ変換されることを可能にするため、ファイル依存関係を処理するビルドツールから WwiseCLI を呼び出す時に -ConvertExternalSources と組みあせて使用すると便利です。
  • -Save: Wwise プロジェクトの保存を有効化。"-ImportDefinitionFile"と一緒に使用すると、バンクインポートのプロセスより生じたプロジェクトへの変更がワークユニットへ保存されます。保存を有効にすると、コマンドラインからの展開のためのプロジェクト移行が可能になります。ユーザーはプロジェクトを保存する時にプロジェクトのファイルが "read only(読み取り専用)" ではないことを確認、つまり、コマンドラインリクエストの実行前に、ソース管理からの任意の "check-out" を実行する責任があることに注意してください。
  • -ContinueOnError: 定義ファイルのインポート中にエラーが発生してもエラー時継続をする場合はこのフラグを使用してください。
  • -ExternalSourcesOutput: 変換された外部ソースファイルに対して Project Settings で設定された出力パスをオーバーライド。このオプションには、プラットフォーム(オプション)と パスの2つのパラメータがあります。このオプションは、-ConvertExternalSources との組み合わせでのみ有効です。
  • -Verbose: 追加コンソールのテキストアウトプットを可能にする。
  • -Quiet: すべての non-error コンソールテキスト出力を無効にします。

コマンドラインからの SoundBank 生成例を以下に示します。例では、英語(米国)と フランス語(カナダ)の Windows プラットフォーム用 SoundBank が生成されます。また、特定のポスト生成コマンドも定義されており、これによりプロジェクト設定とユーザー設定で定義されているポスト生成ステップがオーバーライドされます。

"%WWISEROOT%\Authoring\Win32\Release\bin\WwiseCLI.exe" "C:\Project name.wproj" -GenerateSoundBanks -Language English(US) -Language French(Canada) -Platform Windows
-Bank BankLevel1 -Bank BankLevel2 -ImportDefinitionFile "C:\BankDefinitionFile\MyProjectDefinition.txt"
-CustomPostGenCmd Windows "\"$(WwiseExePath)\tools\AkFilePackager.exe\" -generate -info \"$(InfoFilePath)\" -output \"$(SoundBankPath)\$(WwiseProjectName).pck\" -blocksize 16 -hideprogressui true"

convert_external_src_example外部ソース変換例

以下、コマンドラインから外部ソースを変換する例です。変換は XBox360 に対してのみ行われます。

"%WWISEROOT%\Authoring\Win32\Release\bin\WwiseCLI.exe" "C:\Project name.wproj" -ConvertExternalSources XBox360

エラーコード

コマンドラインから操作すると、WwiseCLI.exe は以下の戻りコードのいずれかを返します:

  • WWISE_ERROR_CODE_SUCCESS 0
  • WWISE_ERROR_CODE_ERROR 1 (Fatal Error(致命的なエラー) または Error (エラー)が発生した場合)
  • WWISE_ERROR_CODE_WARNING 2 (Warnings (警告)が発生した場合)

警告が発生してもSoundBankは適切に生成される可能性がありますが、これらの警告をエラーとして考慮することを強くお勧めします。例えば、ソースファイルが欠落していると、WwiseCLI.exe はエラーコードを返します。欠落ソースファイルはSoundBankの生成を妨げませんが、生成される SoundBank が不完全である可能性があります。

Wwise の Project Settings > Logs で、Soundbank 生成中に発生するほとんどのメッセージの重大度を変更することができます。メッセージの重大度を変更すると、戻りコードに影響が与えられます。

エラー追跡

コマンドラインアプリケーションから作業する場合、すべてのエラーは stdout を使用してレポートされます。