You can use Wwise Unreal Integration features to map Unreal Cultures to Wwise languages and ensure that your corresponding Unreal and Wwise projects support the same set of languages for asset localization. After the mapping is complete, you can change languages with certain Blueprint nodes or through the C++ AkAudioDevice API.

Mapping Unreal Cultures to Wwise Languages

For Unreal Cultures, you can use any ISO-639-1 language code and, optionally, an ISO 3166 country code (fr-CA, en-GB, and so on). For the Wwise Language, you can use any of the languages in your Wwise project. For more information on localization in Wwise, refer to Localizing Your Project.

To map an Unreal Culture to a Wwise language:

1. From the Unreal menu bar, click Edit > Project Settings.
2. In the Wwise section, click Integration Settings. The Localization section includes the mapping of Unreal Cultures to Wwise languages:
   
   
3. Click Add Element (+). A new row is added to the list.
4. In the text box on the left, type a valid Unreal Culture and in the text box on the right, type a corresponding Wwise language.

참고:

The Wwise language must match the specified language in the Wwise project exactly (capitalization, spacing, and any special characters such as parentheses).

Changing Languages with Blueprints

After you map the Unreal Cultures to the Wwise languages, you can use Blueprint nodes to change audio languages and cultures in Unreal. Two Blueprint nodes are available:

• Set Current Audio Culture
  
  
• Set Current Audio Culture Async
  
  

Changing Languages with the API

You can change the audio language or culture directly from code in the C++ AkAudioDevice API FAkAudioDevice::Get()->SetCurrentAudioCulture(). You can pass either a Wwise language or an Unreal Culture to the C++ function or Blueprint node.

When SetCurrentAudioCulture() is called:

1. The string passed to the function determines the Wwise language to set.
2. The Integration calls FWwiseResourceLoader::SetLanguage with the EWwiseReloadLanguage::Immediate parameter.
3. 그런 다음 통합은 새로운 언어로 IWwiseStreamMgrAPI::SetCurrentLanguage를 호출합니다.

The asynchronous variant immediately calls IWwiseStreamMgrAPI::SetCurrentLanguage, and FWwiseResourceLoader::SetLanguage (which does the heavy lifting of reloading Wwise resources) is called in an asynchronous task. FWwiseResourceLoader::SetLanguage가 완료되면 Completed Blueprint 이벤트가 시작됩니다.

Advanced users might want to use different values of EWwiseReloadLanguage. If this is the case, we recommend that you avoid using the supplied Blueprints and the AkAudioDevice API and to call the FWwiseResourceLoader::SetLanguage and IWwiseStreamMgrAPI::SetCurrentLanguage functions directly.

The three possible states of EWwiseReloadLanguage are:

• EWwiseReloadLanguage::Immediate
  • 이벤트 리소스를 로드할 때 사용되는 FWwiseResourceLoader의 CurrentLanguage 변수가 새로운 언어로 설정됩니다.
  • The resources of all Soundbanks, ShareSets, Aux Busses, and Events that were loaded in the previous language are reloaded.
• EWwiseReloadLanguage::Safe
  • Does the same things as Immediate, but also calls IWwiseSoundEngineAPI::StopAll() to stop all playing sounds before resources are reloaded.
• EWwiseReloadLanguage::Manual
  • Only the CurrentLanguage variable in the FWwiseResourceLoader is changed to the new language.
  • The user is responsible for unloading and reloading the Wwise resources that require the language change.

참고:

Due to limitations in the Wwise Sound Engine, we recommend that you change languages when no localized sounds are playing. If an event is playing, the Sound Engine does not unload the bank that contains it. A loaded bank cannot be replaced by a new bank with the same name, even if it is in a different language. The bank must be unloaded first.

Packaging Localized Assets

현지화된 Wwise 에셋이 쿠킹되면 각 언어의 리소스(.bnk와 .wem 파일)가 에셋과 함께 패키징됩니다. Refer to 쿠킹 및 패키징하기 on the 알려진 이슈 page.