|
Wwise SDK 2023.1.3
|
Wwiseの性能を拡張するために、自分でプラグインをビルドすることができます。オーディオエフェクトのほか、シンセサイザーや物理的モデリングといったサウンドソースなど、様々な種類のプラグインを作成できます。
 | 注釈: For an example of the step-by-step creation of a plug-in, refer to Example: Developing a Lowpass Filter Plug-in. |
プラグインの概要
Wwiseのオーディオプラグインは、 Authoring と、 Sound Engine の、2つの部分で構成されます。
プラグインのAuthoring部分の概要
Wwise Authoringアプリケーション内で稼働するのが、この部分です。以下の場所にあります:
<Wwise>/Authoring/x64/<Config>/bin/Plugins
以下の2ファイルで構成されます:
- プラグインのプロパティである、モデルの、 XML definition 。
- SoundBank生成とグラフィカルインターフェースの実装を提供する、 dynamic library (.dll) 。
プラグインのこの部分の記述に関しては、 オーディオプラグインのAuthoring部分の記述 を参照してください。
| 注釈: 既存プラグインを更新する場合は、 2021.1 Authoring Plug-in APIへの移行 で調べてください。 |
プラグインのサウンドエンジン部分概要
Wwiseでユーザーが定義した設定内容に基づいて、入力サウンドを出したり変更したりするコードで、Sound Engineの中で稼働します。設定は、SoundBankのパラメータとして、サウンドエンジンに提供されます。
コードは、静的ライブラリとして、またプラットフォームが対応する場合は動的ライブラリとしても、提供されます。 Sound Engineプラグインライブラリのファイルは、Wwiseライブラリと共に、SDKの以下の場所にあります:
<Wwise>/SDK/<Platform>/<Config>/bin<Wwise>/SDK/<Platform>/<Config>/lib
また、ヘッダファイルが、Wwise includeディレクトリにあるはずです:
<Wwise>/SDK/include/AK/Plugin
静的ライブラリはAuthoring動的ライブラリにもリンクしているので、Wwise Authoringアプリケーション内で使えます。
プラグインのこの部分の記述に関しては、 オーディオプラグイン サウンドエンジン部分の記述 を参照してください。
プラグイン作成のリソース
プラグインを作成しやすくするためのリソースが複数あり、なかでも開発ツール wp.py （Wwise Plugin）が中心的です。
開発ツール: wp.py
A command-line tool written in Python is provided with the Wwise SDK installation. あなたのWwise実装の、以下の場所にあります:
<Wwise>/Scripts/Build/Plugins/wp.py
| 注釈: wp.pyは、インストールした場所でなく、以下の例のようにあなたが作業をするディレクトリで実行する必要があります。 C:\Workspace> python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" --help
|
ツールで、以下のようなことができます:
- テンプレートから、すぐに使えるプロジェクトを生成。
- あなたのターゲットプラットフォーム向けの、ソリューションを生成。
- そのようなソリューションを構築。
- Audiokinetic Launcherであなたのプラグインを使うためのパッケージング。
このSDKで提供するプラグイン開発ツールに関しては、 開発ツールを使う を参照してください。
簡単なLowpass Filterプラグインを作成してみよう
実際に機能するプラグインの開発例を、手順を追って見るには、 Example: Developing a Lowpass Filter Plug-in を参照してください。
サンプルコード
Wwise SDKに、すぐにビルドできるサンプルプラグインが入っているので、活用してください。以下の場所にあります:
<Wwise>/SDK/samples/Plugins
以下のサンプルプラグインを提供します:
- オーディオインプットソースプラグイン :
<Wwise>/samples/Plugins/AkAudioInput - ディレイサンプルエフェクトプラグイン :
<Wwise>/samples/Plugins/AkDelay - サインサンプルソースプラグイン :
<Wwise>/samples/Plugins/AkSineTone - サンブル オーディオ デバイス プラグイン :
<Wwise>/samples/Plugins/AkSink - トーンジェネレータサンプルソースプラグイン :
<Wwise>/samples/Plugins/AkToneGenerator
このSDKと一緒に提供されるサンプルエフェクトプラグインに関しては、 サンプルエフェクトプラグイン を参照してください。
関連ページ
更なる詳細は、以下のセクションをご覧ください：