경고 : 이 페이지에서 보호된 일부 정보가 표시되지 않았습니다.
특정 플랫폼의 라이선스 사용자일 경우 로그인하셨는지 확인해 주세요.

Wwise SDK 2024.1.4

소개

Wwise 사운드 엔진 SDK에는 debug, profile, release 이 세 개의 빌드 환경 설정이 있습니다.

Wwise의 Debug 버전은 assert와 debug 출력 문자열과 같이 추가 디버깅 정보가 있으며, 최적화돼있지 않은 빌드 환경 설정입니다. 이 환경 설정은 성능에 미치는 영향이 크기 때문에 사용을 권하지 않습니다. 그렇지만 통합 과정의 초기 단계에 문제가 발생할 경우, 통합 작업을 검사하는 데 이 빌드가 유용할 수 있습니다.

Wwise의 Profile 버전은 Wwise와의 통신을 지원하는 최적화된 빌드입니다. 이 환경 설정은 매일 하는 개발 작업을 위해 만들어졌습니다. Wwise와의 대화 기능으로 인해 게임의 최종 상용 버전에는 사용할 수 없습니다.

마지막으로, Release 버전은 대화 지원 기능이 없는 최적화된 빌드입니다. 이 환경 설정을 이용하면 AK_OPTIMIZED 전처리기 정의가 컴파일 시간에 정의돼야 합니다. CommunicationCentral 라이브러리 또한 해당 링크 의존성에서 삭제돼야 합니다. Release 빌드 환경 설정은 세 가지 중에 가장 뛰어난 성능을 내며 최종 상용 빌드에 사용해야 합니다.

info 참고: Windows에서 프로젝트가 C 런타임 라이브러리의 정적 버전 (/MK나 /MTd)을 사용해야 하는 경우, 표준 환경 설정 대신 Debug(StaticCRT) 와 Profile(StaticCRT), Release(StaticCRT) 폴더에서 Wwise 라이브러리와 연결돼야 합니다.

라이브러리 의존성 요구 사항

다음은 각 빌드 환경 설정에 필요한 라이브러리 의존성입니다. 한 라이브러리에 대해 두 개 이상의 버전이 존재할 경우, 그 중 하나만 요구하도록 표시됩니다. Wwise SDK를 사용하는 애플리케이션이 어느 버전을 요구하도록 만드는지, 사운드 프로그래머의 결정에 따라 달라집니다.

사운드 엔진

다음은 사운드 엔진 통합에 필요한 입력 라이브러리 목록입니다.

라이브러리	설명
AkSoundEngine	사운드 엔진 코어
AkMemoryMgr	메모리 관리자
AkStreamMgr	I/O 관리자
AkMusicEngine	음악 엔진
AkSpatialAudio	내장된 공간 음향 기능
CommunicationCentral	Wwise 커뮤니케이션 *
* release 환경 설정에는 필요 없음.

info 참고: Microsoft 플랫폼의 라이브러리 파일은 .lib 파일명 확장자를 사용합니다. 한편 Nintendo 플랫폼 라이브러리는 .a 를 사용합니다. 기타 플랫폼들은 lib 접두어와 .a 확장자를 사용합니다.

info 참고: Interactive Music 기능을 사용하지 않는 애플리케이션은 AkMusicEngine 에 연결하지 않아도 됩니다. AkMemoryMgr 와 AkStreamMgr 는 각각 Audiokinetic의 메모리와 스트림 관리자의 기본 구현입니다. 이들을 오버라이드하려면 자신의 lib와 연결하세요 (오버라이딩 관리자 참고).

소스와 효과 플러그인

다음은 Wwise에서 제공하는 모든 소스 플러그인의 입력 라이브러리 목록입니다. Wwise를 지원하는 모든 플랫폼에서 사용 가능합니다.

Source Plug-in Libraries
Library	Description
AkAudioInputSource	Audio Input sample source plug-in (sources available under samples/Plugins/AkAudioInput)
AkSilenceSource	Silence Generator source plug-in
AkSineSource	Sine source plug-in (sources available under samples/Plugins/AkSineTone)
AkSoundSeedGrainSource	Soundseed Grain - Grain source plug-in *
AkSoundSeedWindSource	Soundseed Air Wind source plug-in *
AkSoundSeedWooshSource	Soundseed Air Woosh source plug-in *
AkSynthOneSource	Synth One source plug-in
AkToneSource	Tone Generator source plug-in (sources available under samples/Plugins/AkToneGenerator)
* Available with Wwise, but requires a separate license.

다음은 Wwise에서 제공하는 모든 효과 플러그인의 입력 라이브러리 목록입니다. Wwise를 지원하는 모든 플랫폼에서 사용 가능합니다.

Effect Plug-in Libraries
Library	Description
AkCompressorFX	Compressor effect plug-in
AkConvolutionReverbFX	AK Convolution Reverb effect plug-in *
AkDelayFX	Delay effect plug-in (sources available under samples/Plugins/AkDelay)
AkExpanderFX	Expander effect plug-in
AkFlangerFX	Flanger effect plug-in
AkGainFX	Gain effect plug-in
AkGuitarDistortionFX	Guitar Distortion effect plug-in
AkHarmonizerFX	Harmonizer effect plug-in
AkMatrixReverbFX	Matrix Reverb effect plug-in
AkMeterFX	Meter effect plug-in
AkParametricEQFX	Parametric EQ effect plug-in
AkPeakLimiterFX	Peak Limiter effect plug-in
AkPitchShifterFX	Pitch Shifter effect plug-in
AkRecorderFX	Recorder plug-in
AkReflectFX	Reflect plug-in
AkRoomVerbFX	RoomVerb, a high quality reverb effect plug-in
AkStereoDelayFX	Stereo Delay effect plug-in
AkTimeStretchFX	Time Stretch effect plug-in
AkTremoloFX	Tremolo effect plug-in
* Available with Wwise, but requires a separate license.

info

참고:
Wwise SoundBank에서 사용되는 경우를 제외하고는, 각 플러그인 라이브러리는 선택 사항입니다.

코덱 플러그인

다음은 Wwise에서 제공하는 모든 코덱 플러그인의 입력 라이브러리 목록입니다.

Codec Plug-in Libraries
Library	Description	Platform Availability
AkVorbisDecoder	Vorbis decoder library	Available for all Wwise-supported platforms.
AkOpusDecoder	Opus decoder library	Available for all Wwise-supported platforms.

Motion

다음은 동작 관련 입력 라이브러리 목록으로, Motion을 지원하는 모든 Wwise 지원 플랫폼에서 사용 가능합니다.

Motion-Related Libraries
Library	Description
AkMotionSink	Controller vibration device plug-in. Wwise 프로젝트에서 컨트롤러에 Motion을 사용할 경우에 한해 필요함. *
AkMotionSourceSource	Motion premium plug-in *
* Available with Wwise, but requires a separate license.

Waapi

다음은 WAAPI 관련 입력 라이브러리 목록으로, WAAPI를 통해 Authoring에 연결할 수 있는 모든 Wwise 지원 플랫폼에서 사용 가능합니다.

WAAPI 라이브러리
라이브러리	설명
AkAutobahn	WAMP_POCO 라이브러리, civetweb 라이브러리 및 필요한 클라이언트 클래스의 수정된 버전.

외부 라이브러리 의존성

다음은 사운드 엔진 통합에 필요한 플랫폼 별 외부 입력 라이브러리 목록입니다.

info

참고: 원하는 특정 플랫폼에 대한 테이블은 다음을 참고하세요.

해당 플랫폼별 Wwise SDK CHM, 또는
온라인 설명서(Help), 로그인하면 자신에게 등록된 모든 플랫폼 관련 정보를 참고할 수 있습니다.

Windows
라이브러리	설명
dinput8.lib	Microsoft DirectX DirectInput. DirectInput 장치를 지원하는 Motion에 필요함.
Winmm.lib	Microsoft Multimedia API. 내부 장치 대상 관리를 위한 Motion에 필요함.
dsound.lib	Microsoft DirectX DirectSound 라이브러리
dxguid.lib	Microsoft DirectX Audio GUID
ws2_32.lib *	Microsoft Winsock 2 라이브러리 (Wwise 프로파일링에 사용)
xinput.lib	Microsoft XInput. XInput 장치를 지원하는 Motion에 필요함 (Xbox 컨트롤러).
* release 환경 설정에는 필요 없음.

Mac
프레임워크	설명
AudioToolbox.framework	Audio Toolbox 프레임워크로,애플리케이션 수준의 서비스를 제공하는 API를 포함하고 있음.
AudioUnit.framework	Audio Unit 프레임워크로, 오디오 유닛과 오디오 코덱에 사용하는 API를 포함하고 있음.
CoreAudio.framework	This framework contains all the APIs that make up Hardware Abstraction Layer (HAL) Services.
AVFoundation.framework	This framework contains the AVAudioEngine API which is used for outputting audio on modern OSes.

Android
라이브러리	설명
android	Android의 기본 라이브러리
OpenSLES	Android의 네이티브 오디오 라이브러리
zip	zip 파일을 읽기 위한 라이브러리. Dieter Baron과 Thomas Klausner가 개발. 이 lib 는 SDK를 통해 배포됨.
z	Android z 라이브러리

OpenHarmony
Library	Description
hilog_ndk.z	OpenHarmony logging library
ohaudio	The native audio library for OpenHarmony
ace_napi.z	Library for interoperability between native and Javascript runtimes
ace_ndk.z	Utilities for native apps on OpenHarmony
rawfile.z	Library for reading files stored in the OpenHarmony app package format
ohvibrator.z	Library for using the Vibrator functionality of OpenHarmony. Required when using Wwise Motion only.

iOS/tvOS/visionOS
Framework	Description
AudioToolbox.framework	The Audio Toolbox framework contains the APIs that provide application-level services.
CoreAudio.framework	This framework contains all the APIs that make up Hardware Abstraction Layer (HAL) Services.
AVFoundation.framework	This framework contains the AVAudioEngine API which is used for outputting audio on modern OSes.

Android
Library	Description
libandroid.a	Base Android API
libOpenSLES.a	The native audio API

Linking Static iPhone Libraries in XCode

In order to be able to properly link with the correct libraries (device vs. simulator), you will have to follow these instructions:

In your XCode project create the following configurations: Debug, Profile, and Release.
Open the build settings page of your project and set the "library search path" to "/Developer/SDKs/Wwise/SDK/iOS_Xcode$(XCODE_VERSION_MAJOR)/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)/lib". Replace iOS in the previous string to tvOS or visionOS as necessary. This assumes that you have installed Wwise SDK to its default location.
Open the info page of your target application. "Other linker Flags" 아래에 연결하고자 하는 라이브러리 각각에 대한 -l[libraryName]를 추가하세요. 대부분의 기본적인 설정에서는 "-lAkMemoryMgr -lAkMusicEngine -lAkSoundEngine -lAkStreamMgr"를 추가해줘야 합니다.

info

참고: "$(CONFIGURATION)" will automatically be replaced by one of Debug, Profile, Release. Depending on your active configuration in XCode, "$(EFFECTIVE_PLATFORM_NAME)" will automatically be replaced by -iphoneos or -iphonesimulator.

The Integration Demo for iOS is set up in the same way. You can refer to it for further information:
SDK/samples/IntegrationDemo/iOS/IntegrationDemo.xcodeproj

check_circle

작은 정보: If you don't follow these instructions, you may have to use separate XCode targets for building the device and the simulator applications. Alternatively, you may get incremental build errors when switching between building the device and the simulator applications.

SDK 입력 라이브러리와 배포되는 바이너리 를 참고하세요.

이 페이지가 도움이 되었나요?

지원이 필요하신가요?

질문이 있으신가요? 문제를 겪고 계신가요? 더 많은 정보가 필요하신가요? 저희에게 문의해주시면 도와드리겠습니다!

지원 페이지를 방문해 주세요

작업하는 프로젝트에 대해 알려주세요. 언제든지 도와드릴 준비가 되어 있습니다.

프로젝트를 등록하세요. 아무런 조건이나 의무 사항 없이 빠른 시작을 도와드리겠습니다.

Wwise를 시작해 보세요