Authoring ツールにプラグインを統合
イントロダクション
プラグインは、Wwise ユーザーとゲーム開発者に様々なタイプのソースやエフェクトを提供するために Wwise で使用されます。 ソースプラグインは、サウンドを 生成 するために使用され、エフェクトプラグインはサウンドを 変更 するために使用されます。
利用可能なプラグインの完全なリストは、ソースプラグインとエフェクトプラグイン を参照してください。
インストール
Wwiseオーディオプラグインは、2つのファイルで構成されています：
- DLL：Wwise プラグイン DLL の作成方法 参照
- XML ファイル：Wwiseプラグイン XML 記述ファイル 参照
起動時に、WwiseはこれらのプラグインファイルをWwiseインストールフォルダの plugins フォルダで検索します。Wwise は、ファイル名に基づいて、DLL ファイルとXMLファイルを一致させます。 これはつまり、各プラグインDLLは同じベース名の組となるXMLファイルがある必要があります。たとえば、MyPlugin.dllという名前のプラグインDLLは、 XML ファイルを MyPlugin.xmlという名前にする必要があります。
Windowsへのインストール
プラグインをインストールするには:
- 32ビットアプリケーション-: DLL ならびに XML ファイルを、メインのWwiseフォルダにある
Authoring\Win32\Release\bin\pluginsフォルダにコピーします。 - 64ビットアプリケーション: DLL ならびに XML ファイルを、メインのWwiseフォルダにある
Authoring\x64\Release\bin\pluginsにコピーします。
|
Caution: Wwise のデフォルトインスールフォルダは、 <ProgramFiles>\Audiokinetic\Wwise <VERSION> <BUILD>ですが、 Wwise ユーザーによる他の場所へのインストールも可能です。プラグイン用にインストーラーを作成する場合は、これがデフォルトの場所へ Wwise がインストールされていると仮定しないようにしてください。 |
プラグインインストール方法の例は、プラグイン統合例 を参照してください。
macOSへのインストール
macOS Xでは、Wwise Authoring ツールは 64 ビットでのみ実行できます。従って、まず64ビットのDLLを実装してから、プラグインをインストールします。
- Wwise.app を右クリックして、Show Package Content (パッケージ内容の表示) を選択します。
- DLL ならびに XML ファイルを
/Contents/SharedSupport/Wwise2017/support/wwise/drive_c/Program Files/Audiokinetic/Wwise/Authoring/x64/Release/bin/pluginsフォルダにコピーします。
さらに、Mac 用の Wwise は Codeweavers Crossoverを介して実行されるので、XML ならびに DLL ファイルをインデックス化する必要があります。Codeweavers Crossover は Windows ファイルの階層リストを維持します。XML ならびに DLL ファイルがこのリストに含まれていないと、アプリケーションはこれらを見つけることができません。
新しいファイルを Codeweavers Crossover リストに追加するには、次の手順に従ってください:
- ターミナルを開きます。
- 更新したい Wwise.app へ移動します。たとえば、
cd /Applications/Audiokinetic/WWISE_VERSION/Wwise.app/Contents/SharedSupport/Wwise2017と移動します。 -
files というファイルを更新するコマンドを入力します(このコマンドは1行です):
CX_ROOT=/Applications/Audiokinetic/WWISE_VERSION/Wwise.app/Contents/SharedSupport/Wwise2017 WINEPREFIX==/Applications/Audiokinetic/WWISEVERSION/Wwise.app/Contents/SharedSupport/Wwise2017/support/wwise ./bin/wineprefixcreate --snapshot。
もちろん、公開配布をするプラグインを書いている場合には、これらのステップをエンドユーザーにわかるよう、インストーラに組み込む必要があります。
トラブルシューティング
問題が発生した場合は、Wwise ソースプラグインおよびエフェクトプラグインのトラブルシューティングガイド を参照してください。