WwiseSoundEngine.Build.cs file ( …\Plugins\Wwise\Source\WwiseSoundEngine\WwiseSoundEngine.Build.cs 에 있음)은 지원되는 각 플랫폼용 플러그인에 대해 빌드 매개 변수를 설정하는 역할을 합니다. 이 파일은 다음의 특정 작업을 수행합니다.

• 연결할 정적 라이브러리 지정
• 런타임 때 로드될 동적 라이브러리 지정
• 수많은 통합 기능을 제어하는 데에 사용되는 전(前)처리 장치 정의

전처리 장치 정의

다음은 WwiseSoundEngine.Build.cs 에 있는 전처리 장치 정의입니다.

• 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
  이 설정은 동시에 읽고 제작할 수 있는 최대 개수를 지정합니다.

소스 코드로부터 Wwise Unreal 통합 빌드하기

다음 플랫폼의 경우 ThirdParty 의 각 bin 폴더 안에 있는 모든 Wwise 플러그인이 최종 실행 파일 안으로 패키징됩니다.

• Android
• iOS
• tvOS
• Switch

Android의 경우 UPL 파일이 …\Plugins\Wwise\Source\AkAudio\Wwise_APL.xml 에 있습니다. 이 파일은 모든 공유 라이브러리가 빌드 중인 이진 파일의 아키텍처를 위한 최종 실행 파일 안으로 패키징됨을 지정합니다.

iOS와 tvOS의 경우 플러그인 등록이 …\Plugins\Wwise\Source\WwiseSoundEngine\Public\GeneratedAkiOSPlugins.h 헤더 안에서 처리됩니다. 이 파일은 뱅크 생성 시에 생성되며 …\Plugins\Wwise\Source\WwiseSoundEngine_{WWISE_MAJOR}_{WWISE_MINOR}\Private\Wwise\API_{WWISE_MAJOR}_{WWISE_MINOR}\WwiseSoundEngineAPI_{WWISE_MAJOR}_{WWISE_MINOR}.cpp 안에 들어 있습니다.

Switch의 경우 플러그인 등록이 …\Plugins\Wwise\Source\WwiseSoundEngine\Public\GeneratedAkSwitchPlugins.h 헤더 안에서 처리됩니다. 이 파일은 뱅크 생성 시에 생성되며 …\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 폴더에서 사용자가 사용하지 않는 공유 라이브러리를 삭제하는 것이 좋습니다.

다음 플랫폼의 경우 공유 (동적) 라이브러리가 …\Binaries\<UEPlatform>\<TargetName>.target 파일에서 생성되는 런타임 의존성의 목록에 추가됩니다.

• Linux
• Mac
• PS4
• PS5
• Windows (플러그인용)
• XboxOne

• XboxSeriesX

  설치 에 설명된 설치 단계를 올바르게 실행하면 Unreal Engine을 다시 빌드하는 것과 동일한 방식으로 Wwise 통합을 다시 빌드할 수 있습니다. 이 과정에 대한 더 자세한 설명은 Unreal Engine 문서를 참고하세요.

소스 코드가 있는 플러그인에 대한 더 많은 정보는 Unreal Engine 문서를 참고하세요.

Unreal과 Wwise SoundEngine 환경 설정

Unreal에서는 Debug, DebugGame, Development, Test, Shipping과 같은 구성 상태를 사용할 수 있습니다 (자세한 내용은 빌드 환경 설정 레퍼런스 참조).

Wwise SoundEngine에서는 Debug, Profile, Release 빌드 설정을 사용할 수 있습니다 (자세한 내용은 빌드 환경 설정 참조).

Wwise와 Unreal 빌드 환경 설정은 모든 플랫폼에서 다음과 같은 방식으로 관련돼있습니다.

• Unreal Debug와 DebugGame 환경 설정 상태는 Wwise SoundEngine Debug 환경 설정과 일치합니다.
• Unreal Develpment 환경 설정 상태는 Wwise SoundEngine Profile 환경 설정과 일치합니다.
• Unreal Test와 Shipping 환경 설정 상태는 Wwise SoundEngine Release 환경 설정과 일치합니다.

Windows에서의 Unreal과 Wwise SoundEngine 환경 설정

Windows에서 SDK는 사운드 엔진의 Debug, Profile 및 Release 버전에 대한 C 런타임 라이브러리의 동적 및 정적 버전을 제공합니다. 정적 라이브러리는 폴더 이름에 (StaticCRT)가 포함된 폴더에 들어있습니다.

Wwise Unreal 통합은 StaticCRT AkSoundEngine 라이브러리를 사용하며, 이를 사용할 수 없는 경우에는 AkSoundEngine 라이브러리의 동적 버전으로 되돌립니다.

그러나 Wwise 동적 라이브러리를 사용하면 Unreal 프로젝트가 bDebugBuildsActuallyUseDebugCRT 설정으로 완전히 빌드된 경우에만 Debug 빌드 설정을 사용할 수 있습니다. 빌드 설정에 대한 더 자세한 내용은 Unreal Engine 빌드 환경설정 페이지를 참고하세요.

WAAPI의 AkAutobahn 라이브러리는 Unreal과 호환되지 않는 C++ 설정을 사용하므로 사용될 때마다 동적 DLL의 Profile 버전으로 되돌아갑니다.