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

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

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

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

プラグイン記述ファイルが正しいタイプのプラグインを指定していることを確認してください。このファイルは、ソースプラグインには SourcePlugin タグ、およびエフェクトプラグインには EffectPlugin を使用します。詳細は、 WwiseObject 要素を参照してください。このカテゴリは、エンジンサイドのコードの XML ファイルおよび PluginRegistration クラスの両方に一致する必要があります。
プラグイン記述ファイルが適切なサポート対象プラットフォームを指定していることを確認してください。詳細については、PluginInfo 要素を参照してください。
プラグインの XML ファイルで指定されている Company ID と Plug-in ID が DLL の AkCreatePlugin() 関数によって使用されているものと一致しているかどうかを確認してください。PluginRegistrationの例については、 Wwiseサウンドエンジンプラグインの概要を参照して下さい。詳細は、Wwiseプラグイン XML 記述ファイルおよびエクスポート関数を参照してください。
起動時に2つのプラグインが同一の ID を持っているというエラーメッセージを Wwise が表示する場合は、問題：Wwise 起動時に、2つのプラグインが同一の Company ID と Plug-in ID を持っていますというエラーメッセージが表示されます。を参照してください。
XML と DLL が同じ名前であることを確認してください。
XMLとDLLがPluginsフォルダーにあり、共にx86とx64用であることを確認してください。

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

プラグインは 64ビット DLLである必要があります。Mac OS Xでは、Wwise Authoring ツールは 64 ビットでのみ実行できます。
プラグイン XML ならびに DLL が、Codeweavers Crossover リストに含まれていません。対応の詳細は、 macOSへのインストールを参照してください。

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

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

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

Class 属性が、ダイアログリソースで正しく設定されていることを確認してください。詳細は、"Class" コントロール属性を参照してください。
ダイアログが完全に作成される前にコードがコントロールのテキストを変更しないことを確認してください。変更された場合には、必要時にWwise が Class 属性へアクセスできません。プロパティにバインドされたコントロールのテキストを 決して 変更しないように注意してください。詳細は、"Prop" コントロール属性を参照してください。
その他のコントロール属性を参照し、各種コントロールの属性が適切に設定されていることを確認してください。
プラグインダイアログで使用可能な2種類のコントロールに関しては、レギュラーコントロールをダイアログに追加する方法およびダイアログに Wwise プロパティコントロールを追加する方法を参照してください。

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

プラグイン定義ファイルで指定されている AudioEnginePropertyID が0～32767の範囲にあることを確認してください。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 を設定します。

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

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

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

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

このページはお役に立ちましたか？

サポートは必要ですか？

ご質問や問題、ご不明点はございますか？お気軽にお問い合わせください。

サポートページをご確認ください

あなたのプロジェクトについて教えてください。ご不明な点はありませんか。

プロジェクトを登録していただくことで、ご利用開始のサポートをいたします。

Wwiseからはじめよう

Wwise SDK 2017.1.9

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

このページはお役に立ちましたか？

サポートは必要ですか？

あなたのプロジェクトについて教えてください。ご不明な点はありませんか。