目次

Wwise SDK 2018.1.11
Wwise ソースプラグインおよびエフェクトプラグインのトラブルシューティングガイド

問題:Wwise 起動時に、2つのプラグインが同一の Company ID と Plug-in ID を持っていますというエラーメッセージが表示されます。

  • 各プラグインは、固有の Company ID / Plug-in ID の組み合わせを持っている必要があります。これらの ID を定義する方法に関する詳細は、EffectPlugin タグと SourcePlugin 要素 を参照してください。

問題:ユーザーがプラグインを Wwise で使用できません。

プラグインがMacで利用できないが、PCでは動作します。

  • プラグインは 64ビット DLLである必要があります。Mac OS Xでは、Wwise Authoring ツールは 64 ビットでのみ実行できます。

問題:プラグインのユーザーインターフェースのコントロールの1つが空または無効になっています。

  • リソースのコントロールのテキストで指定されているプロパティ名(たとえば Prop=SineFrequency)がプラグイン記述ファイルで指定されている名前(たとえば Property Name="SineFrequency")と同じであることを確認してください。詳細は、"Prop" コントロール属性 および Properties 要素 を参照してください。
  • コントロールクラス(たとえば Class=SuperRange)がプロパティの型に適しているかどうかを確認してください。詳細は、"Class" コントロール属性 および Properties 要素 を参照してください。

問題:プラグインのユーザーインターフェースで Wwise コントロールの1つが正しく表示されません。

問題:プラグインがUIでのプロパティ変更を認識しません。

  • プラグイン定義ファイルで指定されている AudioEnginePropertyID が0~32767の範囲にあること、またはwcustompropertiesファイルの場合は0~150の範囲であることを確認してください。AudioEnginePropertyID タグに関する詳細は、Properties 要素 を参照してください。
  • プラグイン定義ファイルで指定されている AudioEnginePropertyID が AK::IAkEffectParam::SetParam() の実装で使用するIDと一致していることを確認してください。AudioEnginePropertyID タグに関する更なる詳細は Properties 要素 、 AK::IAkEffectParam::SetParam() の実装に関する詳細は AK::IAkPluginParam::SetParam() を参照してください。

問題:プラグインが Wwise では動作しますが、ゲームでは動作しません。

2つの可能性があります:

  • ゲームが静的にエフェクトにリンクしている場合には、プラグインライブラリをリンクし、CPP ファイルの1つにある対応するファクトリヘッダー含めるようにしてください。
  • ゲームが動的ライブラリ (DLL、SO、PRXなど) を使用する場合には、お使いのエフェクト DLL が実行ファイルと同じフォルダーにコピーされているようにしてください。または、それらが同じフォルダーにない場合には、DLLを探すパスを追加するため AkInitSettings::szPluginDLLPath を設定します。

問題:プラグインをプロジェクトに追加できるのですが、そのエフェクトが、Wwiseで音を再生しても聞こえません。

この問題は、音をプラグインで再生する前に"Start Capture" を開始すればデバグできます。キャプチャログに "Plugin not registered" と表示された場合は、オーサリング側のDLLコードのcppファイル1つにAK_STATIC_LINK_PLUGIN(YourPlugin) を追加すれば、修正できます。

問題: プラグインがUnityで動作しません。

Unityで新しいプラグインを認証するためのポイントをいくつか紹介します。

  • Wwise で Unity にプラグインを読み込みには、必ず \Assets\Wwise\Deployment\Plugins\[プラットフォーム]\DSP にコピーします。通常これがリリースバージョンです。
  • プラグインには、Windows\x86、Windows\x86_64 、および Mac バージョンがあり、Unity Editorでプラグインが動作します。
  • 標準の Unity 統合では、バンクを生成するときに作成された PluginInfo.xml からプラグインを検知します。PluginInfo.xmlの "DLL" タグは、 Wwise オーサリングフォルダーでプラグインを説明するXMLファイルに書かれた "EngineDllName" タグから直接得ることができます。DLL が同じ名前であることを確認してください。

詳細は、Plug-in 静的登録 を参照してください。