Wwise SDK 2019.1.11

사운드 엔진 초기화

참고: 사운드 엔진 자체를 초기화하기 전에 메모리 매니저와 스트리밍 매니저가 초기화되어야 합니다. 전체 초기화에 대한 더 많은 정보는 사운드 엔진 모듈 초기화하기 부분을 참고하세요.

사운드 엔진 자체의 초기화는 AK::SoundEngine::Init 함수 호출로 완료됩니다. 사운드 엔진의 초기화 에 나오는 기본 초기화 코드를 편의상 여기에 복사합니다.

#include <AK/SoundEngine/Common/AkSoundEngine.h>                // 사운드 엔진
 
(...)
 

bool InitSoundEngine()
{
    (...)
 
    //
    // 기본 초기화 매개 변수를 사용해
    // 사운드 엔진을 초기화합니다.
    //
    
    if ( AK::SoundEngine::Init( NULL, NULL ) != AK_Success )
    {
        assert( ! "Could not initialize the Sound Engine." );
        return false;
    }
 
    return true;
}

AK::SoundEngine::Init 함수는 2개의 매개 변수를 받습니다.

첫 번째 매개 변수: AkInitSettings * in_pSettings

이 구조체는 사운드 엔진을 초기화하도록 플랫폼에 독립적인 정보를 포함합니다.

두 번째 매개 변수: AkPlatformInitSettings * in_pPlatformSettings

이 구조체는 사운드 엔진을 초기화하도록 각 플랫폼에 특화된 정보를 포함합니다.

경고: 두 매개 변수 모두 선택사항이지만, 게임에서 필요에 따라 이 값들을 변경하길 강력하게 추천합니다. 기본값의 사용은 종종 높은 메모리 사용량이 요구되기 때문입니다. 게임에 따라 메모리 설정은 주의해서 적용되어야 합니다. 더 많은 정보는 자신의 메모리 풀에 적합한 크기 정하기 부분을 참고하세요.

생성 매개 변수를 커스텀하기

AkInitSettings와 AkPlatformInitSettings 구조체는 AK::SoundEngine::GetDefaultInitSettings과 AK::SoundEngine::GetDefaultPlatformInitSettings 함수를 사용해 초기화되어야 합니다.

이 두 개의 함수를 사용한 구조체를 초기화하면, 해당 구조체가 기본 매개 변수로 채워집니다. 다음과 같은 이유로 유용합니다.

초기화될 때 게임의 필요에 따라 수정이 필요한 매개 변수가 손쉽게 변경될 수 있습니다.
SDK의 최근 버전은 구조체에 더 많은 초기화 매개 변수가 추가되어, 기본 매개 변수의 사용은 하위 호환성의 코드를 보장합니다.

다음 예제 코드는 사운드 엔진의 두 개의 메인 풀을 초기화하는 방법을 시연합니다.

#include <AK/SoundEngine/Common/AkSoundEngine.h>                // 사운드 엔진
 
(...)
 

bool InitSoundEngine()
{
    (...)
 
    //
    // 기본 초기화 매개 변수를 사용해
    // 사운드 엔진을 생성합니다.
    //
    
    AkInitSettings          initSettings;
    AkPlatformInitSettings  platformInitSettings;
    
    AK::SoundEngine::GetDefaultInitSettings( initSettings );
    AK::SoundEngine::GetDefaultPlatformInitSettings( platformInitSettings );
    
    initSettings.uDefaultPoolSize           = 4 * 1024 * 1024;  // 4 MB
    initSettings.uMaxNumPaths               = 16;
    
    platformInitSettings.uLEngineDefaultPoolSize    = 4 * 1024 * 1024;  // 4 MB
    
    if ( AK::SoundEngine::Init( &initSettings, &platformInitSettings ) != AK_Success )
    {
        return false;
    }
 
    return true;
}