ビルド構成
Wwise サウンドエンジンには、次の3つのビルド構成が用意されています:debug(デバッグ)、profile(プロファイル) および release(リリース)。
サウンドエンジンの Debug
版は、アサートやデバッグ出力文字列などの追加のデバッグ情報を持つ最適化されていないビルド構成です。パフォーマンスヒットが大きいため、この構成の使用はお勧めしません。しかし、統合プロセスの初期に問題が発生した場合に、統合作業を検証するのにはこのビルドが便利です。
サウンドエンジンの Profile
版は、Wwiseに通信サポートを提供する最適化されたビルドです。この構成は、日常的な開発プロセスでの使用向けです。通信機能があるため、ゲームの最終製品版に使用することはできません。
最後に、サウンドエンジンの Release
版は、コミュニケーションサポートのない最適化されたビルドです。この構成を使用する場合は、コンパイル時にプリプロセッサ定義 AK_OPTIMIZED
を定義する必要があります。CommunicationCentral ライブラリもリンク依存関係から削除される必要があります。このビルド構成は、3つの構成の中で最良のパフォーマンスを提供するため、最終リテールビルドで使用してください。
 |
注釈: Windows 上で、プロジェクトが C ランタイムライブラリの静的バージョン (/MT または /MTd)の使用を要求する場合、このプロジェクトは標準構成の代わりに Debug(StaticCRT)、Profile(StaticCRT) および Release(StaticCRT) フォルダ内の Wwise ライブラリとリンクする必要があります。 |
ライブラリ依存関係の要件
以下は、各ビルド構成に要求されるライブラリ依存関係です。同じライブラリの複数のバージョンが利用可能な場合、そのうちの1つのみが必要であるとしてラベルされます。Wwise SDKを使用するアプリケーションに必要とされるバージョンを特定するのはサウンドプログラマーの仕事です。
サウンドエンジン
以下は、サウンドエンジン統合に必要とされる入力ライブラリのリストです。
ライブラリ |
ディスクリプション |
AkSoundEngine |
サウンドエンジン |
AkMemoryMgr |
メモリマネージャ |
AkStreamMgr |
I/Oマネージャ |
AkMusicEngine |
ミュージックエンジン |
AkSpatialAudio |
ビルトインのスペーシャルオーディオ機能 |
CommunicationCentral |
Wwiseコミュニケーション * |
* リリースコンフィギュレーションにおいて、必須ではない。 |
 |
注釈: Microsoftプラットフォームのライブラリファイルは、ファイル名に .lib という拡張子を使用します。Nintendo プラットフォームのライブラリは、代わりに .a 拡張子を使用します。Mac® および iOS ライブラリは、lib を前置し、 .a 拡張子を使用します。 |
 |
注釈: Interactive Music 機能を使用しないアプリケーションは、AkMusicEngine とリンクする必要がありません。AkMemoryMgr と AkStreamMgr は、それぞれ Memory Manager と Stream Manager の Audiokinetic デフォルト実装です。これらをオーバーライドする場合は、独自 libs とリンクしてください( マネージャのオーバーライド 参照)。 |
ソースプラグインとエフェクトプラグイン
以下は、Wwise付属のすべてのソースプラグイン用入力ライブラリのリストです。これらはWwiseがサポートする全てのプラットフォームで利用可能です。
Sourceプラグインライブラリ |
ライブラリ |
ディスクリプション |
AkAudioInputSource |
Audio Inputサンプルソースプラグイン(ソースは samples/Plugins/AkAudioInput 下で提供) |
AkSilenceSource |
Silence Generatorソースプラグイン |
AkSineSource |
Sineソースプラグイン(ソースは samples/Plugins/AkSineTone 下で提供) |
AkSoundSeedGrainSource |
SoundSeed Grain - Grainソースプラグイン * |
AkSoundSeedWindSource |
SoundSeed Air - Windソースプラグイン * |
AkSoundSeedWooshSource |
SoundSeed Air - Wooshソースプラグイン *
|
AkSynthOneSource |
Synth Oneソースプラグイン |
AkToneSource |
Tone Generatorソースプラグイン(ソースは samples/Plugins/AkToneGenerator 下で提供)
|
* Wwiseで利用できますが、別のライセンスが必要です。 |
以下は、Wwise付属のすべてのエフェクトプラグイン用入力ライブラリのリストです。これらはWwiseがサポートする全てのプラットフォームで利用可能です。
Effectプラグインライブラリ |
ライブラリ |
デスクリプション |
AkCompressorFX |
Wwise Compressorエフェクトプラグイン |
AkConvolutionReverbFX |
Wwise Convolution Reverbエフェクトプラグイン* |
AkDelayFX |
Delayエフェクトプラグイン(ソースは、samples/Plugins/AkDelayの下に提供。 |
AkExpanderFX |
Wwise Expanderエフェクトプラグイン |
AkFlangerFX |
Wwise Flangerエフェクトプラグイン
|
AkGainFX |
Wwise Gainエフェクトプラグイン |
AkGuitarDistortionFX |
Wwise Guitar Distortionエフェクトプラグイン |
AkHarmonizerFX |
Wwise Harmonizerエフェクトプラグイン
|
AkMatrixReverbFX |
Wwise Matrix Reverbエフェクトプラグイン |
AkMeterFX |
SoundSeed Meterエフェクトプラグイン
|
AkParametricEQFX |
Wwise Parametric EQエフェクトプラグイン |
AkPeakLimiterFX |
Wwise Peak Limiterエフェクトプラグイン |
AkPitchShifterFX |
Wwise Pitch Shifterエフェクトプラグイン |
AkRecorderFX |
Wwise Recorderプラグイン |
AkReflectFX |
Wwise Reflectプラグイン |
AkRoomVerbFX |
Wwise RoomVerb、高品質のリバーブエフェクトプラグイン |
AkSoundSeedImpactFX |
SoundSeed Impactエフェクトプラグイン *
|
AkStereoDelayFX |
Wwise Stereo Delayエフェクトプラグイン |
AkTimeStretchFX |
Wwise Time Stretchエフェクトプラグイン |
AkTremoloFX |
Wwise Tremoloエフェクトプラグイン |
* Wwiseで利用できますが、別のライセンスが必要です。 |
 |
注釈: 各プラグインライブラリは、Wwise SoundBank で使用されていない限りオプションです。 |
コーデックプラグイン
以下は、Wwise 付属のすべてのコーデックプラグイン用入力ライブラリのリストです。
Codecプラグインライブラリ |
ライブラリ |
デスクリプション |
対応プラットフォーム |
AkAACDecoder |
AACデコーダライブラリ |
Mac、iOS、、tvOSなどのAppleプラットフォームに対応。 |
AkVorbisDecoder |
Vorbisデコーダライブラリ |
Wwiseが対応するすべてのプラットフォームに対応。 |
AkOpusDecoder |
Opusデコーダライブラリ |
Wwiseが対応するすべてのプラットフォームに対応。 |
Motion(モーション)
以下は、モーションに対応するすべてのWwiseサポートプラットフォームで利用できる、モーション関連の入力ライブラリのリストです。
モーション関連ライブラリ |
Library |
Description |
AkMotionGeneratorSource |
Controller vibration source plug-in. Wwise プロジェクトでコントローラ Motion Generationソースプラグインを使用する場合のみ(非推奨です)。 |
AkMotionSink |
コントローラ バイブレーション デバイス プラグイン。Wwise プロジェクトでコントローラに対してMotionを使用する場合にのみ必要。 |
AkMotionSourceSource |
Wwise Motion Sourceプレミアプラグイン * |
* Wwiseで利用できますが、別のライセンスが必要です。 |
Waapi
以下は、WAAPI関連のインプットライブラリのリストで、WAAPI経由のオーサリングツールへの接続に対応する、すべてのWwise対応プラットフォームで利用できます。
WAAPIライブラリ |
ライブラリ |
デスクリプション |
AkAutobahn |
WAMP_POCOライブラリの改修版、civetwebライブラリ、そして必要となるクライアントクラス。 |
外部ライブラリの依存関係
以下は、サウンドエンジンのインテグレーションに必要な外部インプットライブラリの、プラットフォーム別の表です。
 |
注釈: なお、特定のプラットフォームの専用の表を見るには、以下をいずれかを参照してください。
- 該当するプラットフォームの、専用のWwise SDKのCHM
- あなたが、事前に登録したアクセス権を使いログインした、特定プラットフォームの全情報がある、オンラインヘルプ。
|
Windows |
ライブラリ |
デスクリプション |
dinput8.lib |
Microsoft DirectX DirectInput. DirectInput のデバイスをサポートするために Motion により必要とされる。 |
Winmm.lib |
Microsoft Multimedia API. 管理を目的とする内部デバイス用に、Motion側が必要としています。 |
dsound.lib |
Microsoft DirectX DirectSound library |
dxguid.lib |
Microsoft DirectX Audio GUIDs |
ws2_32.lib * |
Microsoft Winsock 2 ライブラリ (Wwise プロファイリングに使用) |
xinput.lib |
Microsoft XInput. XInput のデバイスをサポートするために Motion により必要とされる。 |
* リリースのコンフィギュレーションには必要なし。 |
Mac |
フレームワーク |
デスクリプション |
AudioToolbox.framework |
Audio Toolboxフレームワークはアプリケーションレベルのサービスを提供するAPIを含みます。 |
AudioUnit.framework |
Audio Unit フレームワークには、オーディオユニットとオーディオコーデックのために特別に使用されるAPIが含まれています。 |
CoreAudio.framework |
このフレームワークには、ハードウェアアブストラクションレイヤ(HAL)サービスを構成するすべてのAPIが含まれています。 |
Android |
ライブラリ |
デスクリプション |
android |
Androidの基本ライブラリ |
OpenSLES |
Androidのネイティブオーディオライブラリ |
zip |
zipファイルを読むためのライブラリ。開発者 Dieter Baron、Thomas Klausner。この lib は、SDKと共に配布されています。 |
z |
Android z ライブラリ |
iOS/tvOS |
フレームワーク |
デスクリプション |
AudioToolbox.framework |
Audio Toolbox フレームワークには、アプリケーションレベルのサービスを提供する API が含まれています。 |
CoreAudio.framework |
このフレームワークには、ハードウェアアブストラクションレイヤ(HAL)サービスを構成するすべてのAPIが含まれています。 |
XCodeで iphone の静的ライブラリをリンク
適切に正しいライブラリとリンクできるようにするためには(デバイス対シミュレータ)、以下の手順に従う必要があります:
- XCodeプロジェクトに次の構成を作成:Debug、Profile と Release。
- プロジェクトのビルド設定ページを開き、「library search path (ライブラリを検索するパス)」を "/Developer/SDKs/Wwise/SDK/iOS/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)/lib" に設定。(Wwise SDKをデフォルトロケーションにインストール済みであることを想定)
- ターゲットアプリケーションの情報ページを開く。"Other linker Flags"下に、-l[libraryName] をリンクしたいライブラリごとに追加。最も基本的な設定では、"-lAkMemoryMgr -lAkMusicEngine -lAkSoundEngine -lAkStreamMgr" を追加する必要があります。
 |
注釈: "$(CONFIGURATION)" は、 Debug、Profile、Release のうちのいずれかに置き換えられます;XCode でのアクティブな構成に応じて、
"$(EFFECTIVE_PLATFORM_NAME)" は自動的に -iphoneos または -iphonesimulator に置き換えられます。
統合デモは、このように設定されているので詳細についてはそちらを参照してください: SDK/samples/IntegrationDemo/iOS/IntegrationDemo.xcodeproj または SDK/samples/IntegrationDemo/tvOS/IntegrationDemo.xcodeproj
|
 |
Tip: これらの手順に従わない場合は、個別の XCode ターゲットをビルドデバイスとシミュレータアプリケーションに使用する必要があるかもしれません。あるいは、ビルドデバイスからシミュレータアプリケーションに切り替えた後(またはその逆の場合)、インクリメンタルビルドエラーが発生する場合があります。 |
Wwise SDK ライブラリは、Android NDKにある基本ライブラリに依存しています。
Android |
ライブラリ |
デスクリプション |
libandroid.a |
ベース Android API |
libOpenSLES.a |
ネイティブのオーディオAPI |
入力ライブラリと分散バイナリ 参照してください。