Wwise SDK 2022.1.19

오프라인 렌더링

Wwise 사운드 엔진은 실시간이 아닌 컴퓨팅 집약적 오디오 생성 및 오디오 처리와 컴퓨팅 집약적 비디오 생성을 동ㄱㅣ화할 수 있는 오프라인 렌더링을 제공합니다.

warning 경고: 동기식 AK::SoundEngine::LoadBank 및 AK::SoundEngine::UnloadBank API를 사용하는 애플리케이션에서 오프라인 렌더링을 활성화할 때는 주의를 기울여야 합니다. 자세한 내용은 오디오 렌더링 스레드 를 참조하세요.

오디오 캡처 콜백은 AK::SoundEngine::RegisterCaptureCallback 을 사용하여 등록할 수 있으며, 이는 렌더링된 오디오 버퍼에 접근하기 위한 메커니즘을 제공합니다.

다음은 오프라인 렌더링으로 구현할 수 있는 것들 중 하나를 보여주는 예입니다.

/// 게임 코드에서 접근할 수 있는 동영상 캡처 서비스
namespace VideoCaptureServices
{
    /// 동영상 캡처를 위한 버퍼를 할당할 수 있습니다.
    void Initialize();
    
    /// 캡처한 영상과 오디오를 동영상 파일로 출력할 수 있습니다.
    void Finalize();
 
    /// 단일 비디오 프레임 버퍼를 파일에 캡처할 수 있습니다.
    void CaptureSingleFrame();
}
 
/// 게임 코드에서 접근할 수 있는 오디오 캡처 서비스
namespace AudioCaptureServices
{
    /// 오디오 샘플의 최종 캡처를 위해 버퍼를 할당하거나 파일을 엽니다.
    void Initialize(unsigned in_uSampleRate, unsigned in_uChannels);
 
    /// 오디오 샘플 캡처가 완료되면 버퍼나 파일 핸들을 해제합니다.
    void Finalize();
 
    /// 할당된 버퍼에 오디오 샘플을 추가합니다.
    void CaptureInterleavedSamples(float* in_pfSamples, unsigned in_uSampleCount);
}
 
class GameInterface
{
    // ...
 
public:
    /// 게임 프레임당 한 번씩 호출되는 함수
    virtual void UpdateCallback(float deltaTime //< elapsed wall clock time in real-time, inverse of the desired frame rate in offline mode
        ) = 0;
};
 
class Game : public GameInterface
{
    // ...
 
private:
    /// 오프라인 렌더링이 활성화된 경우 True.
    bool m_bIsOfflineRendering{ false };
 
    /// 캡처 콜백 등록/등록 해제를 위한 출력 장치 ID.
    AkOutputDeviceID m_defaultOutputDeviceId{ AK_INVALID_OUTPUT_DEVICE_ID };
 
    /// Wwise 오디오 캡처 콜백.
    static void CaptureCallback(AkAudioBuffer& in_CaptureBuffer, AkOutputDeviceID /*in_idOutput*/, void* /*in_pCookie*/)
    {
        const unsigned uSampleCount = static_cast<unsigned>(in_CaptureBuffer.uValidFrames) * in_CaptureBuffer.NumChannels();
        if (!uSampleCount)
            return;
 
        AudioCaptureServices::CaptureInterleavedSamples(in_CaptureBuffer.GetInterleavedData(), uSampleCount);
    }
 
public:
    /// 오프라인 렌더링을 활성화/비활성화하기 위해 호출되는 함수
    void SetOfflineRendering(bool bIsOfflineRendering //< 오프라인 렌더링의 경우 true, 실시간 렌더링의 경우 false
        )
    {
        const bool bWasOfflineRendering{ m_bIsOfflineRendering };
        m_bIsOfflineRendering = bIsOfflineRendering;
 
        // 오프라인 렌더링을 활성화/비활성화하기 위해 메시지 큐에 메시지를 전송합니다.
        AK::SoundEngine::SetOfflineRendering(m_bIsOfflineRendering);
 
        if (m_bIsOfflineRendering == bWasOfflineRendering)
            return;
 
        // 오프라인 렌더링 프레임 시간을 0으로 설정하는 메시지를 메시지 큐에 전송하여 이후 RenderAudio() 호출이 더 이상 오디오 샘플을 생성하지 않도록 합니다.
        AK::SoundEngine::SetOfflineRenderingFrameTime(0.0f);
 
        // RenderAudio()를 호출하여 메시지 큐를 지웁니다. 이 호출 후 오프라인 렌더링이 활성화/비활성화됩니다.
        AK::SoundEngine::RenderAudio();
 
        if (m_bIsOfflineRendering)
        {
            VideoCaptureServices::Initialize();
 
            // Cache the output device ID for unregistration.
            m_defaultOutputDeviceId = AK::SoundEngine::GetOutputID(AK_INVALID_UNIQUE_ID, 0);
 
            AkChannelConfig channelConfig{};
            Ak3DAudioSinkCapabilities audioSinkCapabilities{};
 
            // Obtain the number of channels.
            AK::SoundEngine::GetOutputDeviceConfiguration(m_defaultOutputDeviceId, channelConfig, audioSinkCapabilities);
 
            const AkUInt32 uSampleRate{ AK::SoundEngine::GetSampleRate() };
 
            // 적절한 버퍼를 할당하기 위해 샘플 속도와 채널 수를 제공합니다.
            AudioCaptureServices::Initialize(uSampleRate, channelConfig.uNumChannels);
 
            AK::SoundEngine::RegisterCaptureCallback(&CaptureCallback, m_defaultOutputDeviceId, this);
        }
        else
        {
            AK::SoundEngine::UnregisterCaptureCallback(&CaptureCallback, m_defaultOutputDeviceId, this);
 
            AudioCaptureServices::Finalize();
            VideoCaptureServices::Finalize();
        }
    }
 
    void UpdateCallback(float deltaTime) override
    {
        if (m_bIsOfflineRendering)
            AK::SoundEngine::SetOfflineRenderingFrameTime(deltaTime);
 
        AK::SoundEngine::RenderAudio();
 
        if (m_bIsOfflineRendering)
            VideoCaptureServices::CaptureSingleFrame();
    }
};

AK::SoundEngine::GetSampleRate

AKSOUNDENGINE_API AkUInt32 GetSampleRate()

Ak3DAudioSinkCapabilities

Definition: AkCommonDefs.h:419

AkAudioBuffer::NumChannels

AkForceInline AkUInt32 NumChannels() const

Get the number of channels.

Definition: AkCommonDefs.h:481

AkChannelConfig

Definition: AkSpeakerConfig.h:497

AK::SoundEngine::SetOfflineRenderingFrameTime

AKSOUNDENGINE_API AKRESULT SetOfflineRenderingFrameTime(AkReal32 in_fFrameTimeInSeconds)

AkAudioBuffer::uValidFrames

AkUInt16 uValidFrames

Number of valid sample frames in the audio buffer

Definition: AkCommonDefs.h:646

AK::SoundEngine::GetOutputID

AKSOUNDENGINE_API AkOutputDeviceID GetOutputID(AkUniqueID in_idShareset, AkUInt32 in_idDevice)

AK::SoundEngine::GetOutputDeviceConfiguration

AKSOUNDENGINE_API AKRESULT GetOutputDeviceConfiguration(AkOutputDeviceID in_idOutput, AkChannelConfig &io_channelConfig, Ak3DAudioSinkCapabilities &io_capabilities)

AK::SoundEngine::RegisterCaptureCallback

AKSOUNDENGINE_API AKRESULT RegisterCaptureCallback(AkCaptureCallbackFunc in_pfnCallback, AkOutputDeviceID in_idOutput=AK_INVALID_OUTPUT_DEVICE_ID, void *in_pCookie=NULL)

AK::SoundEngine::RenderAudio

AKSOUNDENGINE_API AKRESULT RenderAudio(bool in_bAllowSyncRender=true)

AK::SoundEngine::UnregisterCaptureCallback

AKSOUNDENGINE_API AKRESULT UnregisterCaptureCallback(AkCaptureCallbackFunc in_pfnCallback, AkOutputDeviceID in_idOutput=AK_INVALID_OUTPUT_DEVICE_ID, void *in_pCookie=NULL)

AK_INVALID_OUTPUT_DEVICE_ID

static const AkUInt32 AK_INVALID_OUTPUT_DEVICE_ID

Invalid Device ID

Definition: AkTypes.h:175

AK_INVALID_UNIQUE_ID

static const AkUniqueID AK_INVALID_UNIQUE_ID

Invalid unique 32-bit ID

Definition: AkTypes.h:163

AK::SoundEngine::SetOfflineRendering

AKSOUNDENGINE_API AKRESULT SetOfflineRendering(bool in_bEnableOfflineRendering)

AkUInt32

uint32_t AkUInt32