Wwise SDK 2022.1.18

声音引擎初始化

info

备注: 在初始化声音引擎本身之前，必须首先初始化内存管理器和流管理器。请参阅初始化声音引擎模块一节了解有关全局初始化的更多信息。

初始化声音引擎本身通过调用 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

此结构包含用于对声音引擎初始化的各平台专用信息。

warning

注意: 两个参数均可选用。不过，建议最好根据游戏需要自定义这些值，因为有些默认值可能会导致内存用量过高。有关详细信息，请参阅固定大小分配章节。

自定义创建参数

AkInitSettings 和 AkPlatformInitSettings 结构必须使用 AK::SoundEngine::GetDefaultInitSettings 和 AK::SoundEngine::GetDefaultPlatformInitSettings 函数初始化。

使用这两个函数对结构进行初始化将在结构中填充默认参数。这一功能非常有用，原因如下：

一旦初始化后，就可以轻松地更改参数来满足游戏的需要。
使用默认参数可确保代码向下兼容，因为 SDK 的未来版本可能会在结构中添加更多的初始化参数。

以下示例代码展示了如何在自定义单个参数值的情况下使用默认的参数来初始化声音引擎。

#include <AK/SoundEngine/Common/AkSoundEngine.h>                // 声音引擎
 
(...)
 
bool InitSoundEngine()
{
    (...)
 
    //
    // Create the Sound Engine
    // Using modified initialization parameters
    //
    
    AkInitSettings          initSettings;
    AkPlatformInitSettings  platformInitSettings;
    
    AK::SoundEngine::GetDefaultInitSettings( initSettings );
    AK::SoundEngine::GetDefaultPlatformInitSettings( platformInitSettings );
    
    initSettings.uMaxNumPaths = 16;
    
    if ( AK::SoundEngine::Init( &initSettings, &platformInitSettings ) != AK_Success )
    {
        return false;
    }
 
    return true;
}