Wwise SDK 2023.1.8

プラグインメディアのシステムは、Wwiseアーキテクチャを利用して、プラグイン（エフェクト、ソース、シンク、ミキサーなど）からバイナリデータファイルをプロジェクトに保存できるようになっています。

プラグインでカスタムデータを使用する代わりにプラグインメディアを使用することには、幾つかの利点があります:

データの組み込み持続性
ソース管理の一元化 (ワークグループ機能を使用)
プラットフォーム別のデータコンバージョンが可能
エンドユーザーが、データを保持するSoundBankを選択することが可能

Wwise オーサリングプラグイン

ブラグインメディアの管理

Object Mediaサービスをリクエストするには、あなたのプラグインのバックエンドで AK::Wwise::Plugin::RequestObjectMedia を派生させます。これで、サービスのメソッドをアクセスするための、メンバー m_objectMedia が提供されます。オブジェクトメディアについてのノティフィケーションを、例えばユーザーがオブジェクトメディアを変更したときなどに受信するには、 AK::Wwise::Plugin::Notifications::ObjectMedia から派生させ、 AK::Wwise::Plugin::Notifications::ObjectMedia::NotifyPluginMediaChanged() メソッドをオーバーライドしてください。

AK::Wwise::Plugin::ObjectMedia::SetMediaSource() を呼び出して、メディアファイルをインポートします。メディアをインポートすると、それはプラグインの "Originals" ディレクトリにコピーされ、管理は完全にWwiseが行います。インデックス0でプラグインメディアファイルを追加するには:

プラグインデータが変更されたときにノティフィケーションを受け取るには、関数 NotifyPluginMediaChanged をオーバーライドします。NotifyPluginMediaChanged is triggered by any modifications to the media source.

詳細については AK::Wwise::Plugin::ObjectMedia の機能についての文書を参照してください。

ランタイムのためにメディアを変換する

If the plug-in definition file uses CanReferenceDataFile, you must convert your imported original WAV media at runtime to an appropriate format for the real-time component.

To implement conversion functions, inherit from AK::Wwise::Plugin::MediaConverter and implement the required functions:

以下は、 AK::Wwise::Plugin::MediaConverter 機能の実装例です:

プラグインの定義

In the plug-in definition file (the plug-in XML file), ensure that the CanReferenceDataFile element is set to true.

ランタイムプラグイン

ランタイムでプラグインを使用する

AK::IAkEffectPlugin を実装するときに、プラグインのSound Engine部分で、 Init(...) 関数の中に AK::IAkEffectPluginContext ポインタを受け取ります。AK::IAkEffectPluginContext から、 AK::IAkPluginContextBase::GetPluginMedia を呼び出して、変換したメディアを手に入れます。これはWwiseのSoundBankにパッケージされています.

注釈: これは、ランタイムに エフェクト プラグインメディアを使った例です。ただし、 source プラグインなど別のプラグインタイプの使い方の参考にもなります。例えばソースプラグインの場合は、 AK::IAkSourcePlugin を実装し、 AK::IAkSourcePluginContext ポインターを受領することになります。