Wwise Unreal Integration Documentation

AkAudio.Build.cs ファイルが、サポートされる各プラットフォーム向けのプラグインのビルドパラメータ設定を行います。（場所は …\Plugins\Wwise\Source\AkAudio\AkAudio.Build.cs ）具体的には、このファイルで以下を行います:

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

プリプロセッサ定義

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

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

ソースからUnreal Wwiseプラグインをビルドする

バンク生成中に …\Content\Wwise\EditorOnly\ActivatedPlugins.uasset アセットが修正され、プラットフォーム名と、各プラットフォームに必要なプラグインの名前のマッピングが、入れられます。

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

Android
iOS
tvOS
Switch

Androidでは、ビルド中のバイナリのアーキテクチャの最終実行ファイルにすべての共有ライブラリがパッケージされることを指定するUPLファイルが、 …\Plugins\Wwise\Source\AkAudio\Wwise_APL.xml にあります

iOSとtvOSでは、プラグイン登録の対応を …\Plugins\Wwise\Source\AkAudio\Private\Generated\AkiOSPlugins.h ヘッダ内で行います。このファイルはバンク生成時に生成され、 …\Plugins\Wwise\Source\AkAudio\Private\AkAudioDevice.cpp 内に含まれます。

Switchでは、プラグイン登録の対応を …\Plugins\Wwise\Source\AkAudio\Private\Generated\AkSwitchPlugins.h ヘッダ内で行います。このファイルはバンク生成時に生成され、 …\Plugins\Wwise\Source\AkAudio\Private\AkAudioDevice.cpp 内に含まれます。

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

以下のプラットフォームでは、生成される …\Binaries\<UEPlatform>\<TargetName>.target ファイル内の、ランタイムの依存性のリストに、共有（ダイナミック）ライブラリが追加されます。

Linux
Mac
PS4
Windows
XboxOne

上記プラットフォームでは、ビルド後の手順としてコマンドレットを実行してビルドにWwiseオーディオプラグインを追加します。

Unreal Engine 4の場合:

<UE4Editor-cmd.exe> <path_to_uproject> -run=AkPluginActivator [-platform=<target_platform>] [-configuration=<wwise_configuration>]

Unreal Engine 5の場合:

<UnrealEditor-cmd.exe> <path_to_uproject> -run=AkPluginActivator [-platform=<target_platform>] [-configuration=<wwise_configuration>]

info 注記： WindowsでデバグCRTを使うUEデバグコンフィギュレーションにUnreal Wwiseプラグインを使うには、 AkAudio.Build.cs 内の bIsDebugBuild 変数をtrueに設定します。なお、この変数設定では、AkOpusDecoderライブラリとAkAutobahnライブラリは、デバグCRTを現在サポートしていないため、無効になります。

インストールのインストール手順に正しく従っていれば、Unreal Wwise プラグインの再構築はUnreal Engine の再構築と同様に行えます。この手順のさらに詳しい説明については Unreal Engineドキュメンテーションを確認してください。

ソースコードのあるプラグインについて詳しく知るには、 Unreal Engineドキュメンテーションを参照してください。

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

サポートは必要ですか？

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

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

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

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

Wwiseからはじめよう

Wwise Unreal インテグレーション

プラグインのビルド

プリプロセッサ定義

ソースからUnreal Wwiseプラグインをビルドする

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

サポートは必要ですか？

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