menu
버전
2022.1.18.8567
2024.1.4.8780
2023.1.12.8706
2022.1.18.8567
2021.1.14.8108
2019.2.15.7667
2019.1.11.7296
2018.1.11.6987
2017.2.10.6745
2017.1.9.6501
2016.2.6.6153
2015.1.9.5624
2024.1.4.8780
2023.1.12.8706
2022.1.18.8567
2021.1.14.8108
2019.2.15.7667
2019.1.11.7296
2018.1.11.6987
2017.2.10.6745
2017.1.9.6501
2016.2.6.6153
2015.1.9.5624
Wwise Unreal Integration Documentation
|
WwiseSoundEngine Module에는 Wwise Sound Engine API 인터페이스와 다양한 번들 플러그인이 들어 있습니다.
Wwise Sound Engine의 기능 대부분은 가장 하위 레벨에서 연결됩니다. Wwise Sound Engine API를 호출하려면 반드시 브리지를 통해야 합니다.
warning | 주의: AK:: 나 ak:: 함수를 직접 사용하지 마세요. 링커 오류, 불안정, 크래시가 발생할 수 있습니다. |
Wwise 2022.1 이전 버전에서는 AkAudio
모듈에서 AkAudioDevice
의 모든 AK::SoundEngine
호출을 만들어야 했습니다. 이러한 방식은 더 이상 필요하지 않지만 여전히 사용할 수는 있습니다. 이 방식은 Blueprint할 수 있는 작업과 함께 Unreal 클래스를 Wwise 네이티브 유형으로 변환하는 등 사용자 코드에 더 많은 기능을 제공하기 때문에 경우에 따라 이 방식을 선호할 수도 있습니다.
두 번째 모듈 WwiseSoundEngine_2022_1은 WwiseSoundEngine 인터페이스에서 실제 Wwise 2022.1 Sound Engine API로 연결하는 코드를 포함하고 있습니다.
통합에는 Global Callback 싱글톤(singleton) 기능이 포함되어 있습니다. 이 기능을 이용하면 게임과 도구가 Sound Engine의 AkGlobalCallback을 활용할 수 있습니다. 콜백에 대한 자세한 설명은 Wwise SDK 문서의 AkCallbackType 을 참고해 주세요.
각 콜백에 대해 다음 함수을 사용할 수 있습니다.
각 함수에 따라 알맞은 용도가 있습니다. 모든 상황에 완벽한 함수는 없습니다.
The Wwise Integration for Unreal connects the Wwise SoundEngine to the Unreal Engine. There are valid reasons to disable the SoundEngine at build time:
It is therefore impossible to link the actual Wwise SoundEngine to the final executable. In these cases, the build scripts use the null SoundEngine. The null SoundEngine is an empty implementor that sits on top of the SoundEngine abstraction provided in the WwiseSoundEngine bridging module. Most functions return AK_NotImplemented without any side effects.
Because the bridge requires the Wwise SoundEngine type definitions to be accurate for the platform, the ThirdParty/include folder must contain an interface for the platform, even if it is not activated in the current context. It is therefore impossible to guarantee that a build for an unsupported platform will work, even with the null SoundEngine.
There are also valid reasons to disable the SoundEngine at runtime:
Typically, the Wwise SoundEngine is disabled when the Wwise SoundEngine is linked inside the final executable package. Some of the issues can be fixed without restarting the Editor. Runtime issues do not use the null SoundEngine unless specified.
The logic for a supported target is executed during Unreal's project generation step in WwiseUEPlatform.IsWwiseTargetSupported. You can determine whether the null SoundEngine is used in UBT's logs: The "Wwise SoundEngine is disabled: Using the null SoundEngine instead." log will be displayed along with the reason. This message appears multiple times when building the Wwise SoundEngine as an Engine plug-in. The message is informative, not an error.
To help with debugging, a similar message is also repeated at runtime in the logs during the Wwise plug-in initialization: "Wwise SoundEngine is disabled: Using the null SoundEngine."
프로젝트를 등록하세요. 아무런 조건이나 의무 사항 없이 빠른 시작을 도와드리겠습니다.
Wwise를 시작해 보세요