|
Wwise SDK 2023.1.8
|
あなたのプラグインのバックエンドを作成するには、 AK::Wwise::Plugin::AudioPlugin から派生したクラスを作成する必要があります。 この基底クラスが、SoundBankに書き込むための関数など、Wwise Authoringプラグインの最も基本的なメソッドを提供します。
あなたのプラグインのメインモデルは Property Set ですが、 Custom Data も、プラグインのバックエンドによって管理することができます。
サウンドバンクの生成
要求があるとプラグインをコーディングして、現行の設定をバンクに保存する必要があります。 これは、 AK::Wwise::Plugin::AudioPlugin::GetBankParameters() メソッドを実装することにより実行可能です。
パラメータは、データブロックとしてサウンドバンクに書き込まれます。続いて、ブロックはサウンドバンクから直接サウンドエンジンプラグインのパラメータ構造体にロードされます。従って、サウンドエンジンプラグインのパラメータ構造体で宣言されているのと同じ順序でパラメータを記述する必要があります。詳細は、パラメータ ノード インターフェースの実装 をご覧ください。
例えば、次のパラメータ構造体を見てみましょう：
以下の AK::Wwise::Plugin::AudioPlugin::GetBankParameters() の実装では、各プロパティの現在の値を取得し、適切なメソッドを使用して、パラメータとして受け取った AK::Wwise::Plugin::DataWriter オブジェクトで値を記述します。これらのアクションは、メンバがパラメータ構造体で定義された順序と同じ順序で実行されます。
 | 注釈: プロパティの現在値を取得するには、 AK::Wwise::Plugin::PropertySet の提供するゲッター関数を利用します。 リクエストするタイプが、XMLで指定されているタイプと完全に一致する必要があります。 |
異なるタイプのデータ記述に利用可能なメソッドに関する詳細については、 AK::Wwise::Plugin::DataWriter を参照してください。
ライセンス管理
SoundBank生成中に、Wwiseがプラグインに対し、プラグインが AK::Wwise::Plugin::License インターフェースで実装するライセンスステータスについてクエリします。プラグインは、 AK::Wwise::Plugin::LicenseStatus の列挙値の1つを返すために、 AK::Wwise::Plugin::License::GetLicenseStatus を実装できます。さらにプラグインは、その重大度を示すメッセージを、SoundBank生成ログに表示するために返すことができます。
LicenseStatus_Unlicensed や、LicenseStatus_Expired を返すと、プラグインがSoundBankに含まれることが、阻止されます。
ライセンスバリデーションのために、プラグインが自身のスキームを実装することができます。このファンクションで、絶対にサーバを同期的にクエリしてはならないので、注意してください。このファンクションは、すぐに返答を返す必要があります。
あなたのプラグインがAudiokineticに登録されていれば、Wwiseのライセンスシステムを活用できます。 以下の実装を使用すると、Wwise Project Licenseの中のライセンスステータスを確認します。