イントロダクション
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プラットフォームのライブラリファイルは、ファイル名に |
|
注釈: 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サポートプラットフォームで利用できる、モーション関連の入力ライブラリのリストです。
|
モーション関連ライブラリ |
|
ライブラリ |
デスクリプション |
| 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が含まれています。 |
|
Android |
|
ライブラリ |
デスクリプション |
| libandroid.a |
ベースAndroid API |
| libOpenSLES.a |
ネイティブのオーディオAPI |
XCodeで静的 iPhoneライブラリをリンクする
適切に正しいライブラリとリンクできるようにするためには（デバイス対シミュレータ）、以下の手順に従う必要があります：
- XCodeプロジェクトに次の構成を作成：Debug、Profile と Release。
- プロジェクトのビルド設定ページを開き、"library search path" を
"/Developer/SDKs/Wwise/SDK/iOS/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)/lib" または "/Developer/SDKs/Wwise/SDK/tvOS/$(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 に置き換えられます。
Integration Demoも同様の設定です。詳細は:
SDK/samples/IntegrationDemo/iOS/IntegrationDemo.xcodeproj または SDK/samples/IntegrationDemo/tvOS/IntegrationDemo.xcodeproj を参照してください。
|
 |
Tip: この手順に従わないと、デバイスとシミュレータのアプリケーションをビルドするのに、別々のXCodeターゲットを使用する必要が出る可能性があります。また、デバイスとシミュレータのアプリケーションのビルドを切り替えるときに、インクリメンタルビルドのエラーが発生する可能性があります。 |
入力ライブラリと分散バイナリ 参照してください。