バージョン

menu_open
Wwise Unreal Integration Documentation
プラグインのビルド

The WwiseSoundEngine.Build.cs file (located at …\Plugins\Wwise\Source\WwiseSoundEngine\WwiseSoundEngine.Build.cs) is responsible for setting up the build parameters for the plug-in for each supported platform. 具体的には、このファイルで:

  • リンクするスタティックライブラリを指定します。
  • ランタイムにロードするダイナミックライブラリを指定します。
  • 多くのインテグレーション機能を制御するときに使うプリプロセッサマクロを定義します。

プリプロセッサ定義

WwiseSoundEngine.Build.cs に、以下のプリプロセッサdefineが導入されます:

  • WWISE_CONFIGURATION_DIR
    この設定は、Wwiseのビルドコンフィギュレーション、つまりAkSoundEngineライブラリがある、適切なサブフォルダを指定します。
  • WWISE_DSP_DIR
    この設定は、Wwiseのビルドコンフィギュレーション、つまりスタティックライブラリやダイナミックライブラリがある、適切なサブフォルダを指定します。
  • AK_SUPPORT_OPUS
    この設定は、Wwise Opusライブラリが使える状態にあるということを指定します。
  • AK_SUPPORT_WAAPI
    この設定は、Wwise Authoring APIライブラリが使える状態にあるということを指定します。
  • AK_UNREAL_MAX_CONCURRENT_IO
    この設定は、一度に許容されるreadとwriteの最大数を指定します。

Wwise Unrealインテグレーションをソースからビルドする

以下のプラットフォームでは、 ThirdParty 内にある、それぞれの bin フォルダ内のすべてのWwiseプラグインが、最終実行ファイルにパッケージされます。

  • Android
  • iOS
  • tvOS
  • Switch

For Android, a UPL file is located at …\Plugins\Wwise\Source\WwiseSoundEngine_{WWISE_MAJOR}_{WWISE_MINOR}\Wwise_APL.xml which specifies that all shared libraries will be packaged into the final executable for the architecture of the binary being built.

For iOS and tvOS, plug-in registration is handled within the …\Plugins\Wwise\Source\WwiseSoundEngine\Public\Generated\AkiOSPlugins.h header. This file is generated upon bank generation, and is included within …\Plugins\Wwise\Source\WwiseSoundEngine_{WWISE_MAJOR}_{WWISE_MINOR}\Private\Wwise\API_{WWISE_MAJOR}_{WWISE_MINOR}\WwiseSoundEngineAPI_{WWISE_MAJOR}_{WWISE_MINOR}.cpp.

For Switch, plug-in registration is handled within the …\Plugins\Wwise\Source\WwiseSoundEngine\Public\Generated\AkSwitchPlugins.h header. This file is generated upon bank generation, and is included within …\Plugins\Wwise\Source\WwiseSoundEngine_{WWISE_MAJOR}_{WWISE_MINOR}\Private\Wwise\API_{WWISE_MAJOR}_{WWISE_MINOR}\WwiseSoundEngineAPI_{WWISE_MAJOR}_{WWISE_MINOR}.cpp.

注記: 出荷された実行ファイルのサイズを削減するために、使用しない共有ライブラリを …\Plugins\Wwise\ThirdParty 内の bin フォルダから削除するよう、ユーザーに推奨しています。

For the following platforms, shared (dynamic) libraries are added to the list of runtime dependencies in the generated …\Binaries\<UEPlatform>\<TargetName>.target file.

  • Linux
  • Mac
  • PS4
  • PS5
  • Windows(プラグイン向け)
  • XboxOne
  • XboxSeriesX

    インストール に記載のインストール手順を正しく行った場合、Unreal Wwiseインテグレーションの再構築をUnreal Engineの再構築と同じ方法で行うことができます。 For a more detailed description of this process, consult the Unreal Engine documentation.

For more information on plug-ins with source code, refer to the Unreal Engine documentation.

UnrealおよびWwise SoundEngineのコンフィギュレーション

Unrealで使用可能なコンフィギュレーションステートは、Debug、DebugGame、Development、Test、Shippingです(詳細については、ビルドコンフィギュレーションのリファレンスを参照してください)。

Wwise SoundEngineで使用可能なビルドコンフィギュレーションは、Debug、 Profile、Releaseです(詳細については、ビルド構成を参照してください)。

WwiseおよびUnrealのビルドコンフィギュレーションは、すべてのプラットフォームにおいて次のように関連付けられています。

  • Unreal DebugとDebugGameのコンフィギュレーションステートは、Wwise SoundEngine Debugのコンフィギュレーションに対応しています。
  • The Unreal Development configuration state corresponds to the Wwise SoundEngine Profile configuration.
  • Unreal TestとShippingのコンフィギュレーションステートは、Wwise SoundEngine Releaseのコンフィギュレーションに対応しています。

Windows版UnrealおよびWwise SoundEngineのコンフィギュレーション

Windows版のSDKでは、サウンドエンジンのDebug、Profile、Releaseコンフィギュレーション用に、Cランタイムライブラリのダイナミックバージョンとスタティックバージョンが用意されています。スタティックライブラリは、フォルダ名に (StaticCRT) を含むフォルダ内にあります。

Wwise Unrealインテグレーションでは、StaticCRT AkSoundEngineライブラリが使用されます。このライブラリを使用できない場合は、AkSoundEngineライブラリのダイナミックバージョンに戻されます。

ただし、Unrealプロジェクトが bDebugBuildsActuallyUseDebugCRT 設定を使用して完全にビルドされている場合は、WwiseのダイナミックライブラリではDebugビルドコンフィギュレーションのみを使用できます。ビルドの設定に関する詳細については、ビルドコンフィギュレーションのリファレンスページを参照してください。

WAAPIのAkAutobahnライブラリでは、Unrealと互換性のないC++設定が使用されるため、これが使用される際には常にダイナミックDLLのProfileバージョンに戻されます。


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

サポートは必要ですか?

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

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

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

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

Wwiseからはじめよう