스트리밍 사운드 웨이브

음성 활동 감지(VAD)에 대해서는 이 페이지를 참조하세요.

스트리밍 사운드 웨이브는 재생 중에도 오디오 데이터를 동적으로 추가할 수 있는 형식의 가져온 사운드 웨이브입니다. 가져온 사운드 웨이브와 동일한 기능을 제공하며, 예를 들어 되감기, SoundCues 등에서 사용할 수 있습니다.

스트리밍 사운드 웨이브 생성

먼저 스트리밍 사운드 웨이브를 생성해야 합니다. 조기 파괴를 방지하기 위해 강한 참조로 처리해야 한다는 점에 유의하세요. (예: Blueprint에서 별도의 변수에 할당하거나 C++에서 UPROPERTY() 사용)

Blueprint

C++

UStreamingSoundWave* StreamingSoundWave = UStreamingSoundWave::CreateStreamingSoundWave();

소리 파형 재생하기

그 소리 파형을 재생할 수 있습니다. 하지만 지금 할 필요는 없으며, 나중에 소리 파형 재생을 시작할 수 있습니다.

오디오 데이터 사전 할당

필요에 따라, 오디오 데이터(바이트)를 사전 할당하여 새로운 오디오 데이터가 추가될 때마다 전체 PCM 버퍼를 재할당하는 것을 피할 수 있습니다.

Blueprint

C++

// Assuming StreamingSoundWave is a UE reference to a UStreamingSoundWave object (or its derived type, such as UCapturableSoundWave)
StreamingSoundWave->PreAllocateAudioData(12582912, FOnPreAllocateAudioDataResultNative::CreateWeakLambda(this, [StreamingSoundWave](bool bSucceeded)
{
	// Handle the result
}));

오디오 데이터 추가

기존 버퍼의 끝에 오디오 데이터를 추가하려면, 오디오 데이터를 동적으로 추가할 수 있는 적절한 함수들을 사용하세요. 재생은 이러한 추가의 큐 순서를 따릅니다.

Blueprint

C++

// Assuming StreamingSoundWave is a UE reference to a UStreamingSoundWave object (or its derived type, such as UCapturableSoundWave)

// Example of appending encoded audio data
TArray<uint8> AudioData = ...; // Fill with audio data
StreamingSoundWave->AppendAudioDataFromEncoded(AudioData, ERuntimeAudioFormat::Auto);

// Or, if you have raw audio data
TArray<uint8> RawAudioData = ...; // Fill with raw audio data
StreamingSoundWave->AppendAudioDataFromRAW(RawAudioData, ERuntimeRAWAudioFormat::Float32, 44100, 2);

가속된 오디오 재생 방지

종종 오디오 데이터를 스트리밍하고 동시에 재생해야 할 때, 버퍼가 너무 빠르게 채워지는 것에 의한 가속된 오디오를 방지하기 위해 재생 전에 약간의 지연을 추가해야 합니다. 일반적으로 약 0.5초의 지연이 권장됩니다.

사용 예제

마지막으로, 여러분의 구현은 다음과 같을 수 있습니다:

Blueprint

C++

다음은 스트리밍 사운드 웨이브에 오디오 데이터를 추가하는 기본 코드 예제입니다.

이 예제는 EXAMPLEMODULE 모듈 내의 UAppendAudioClassExample 클래스에 있는 AppendAudioExample 함수를 사용합니다.

참고: 예제를 성공적으로 실행하려면 RuntimeAudioImporter 모듈을 .Build.cs 파일의 PublicDependencyModuleNames 또는 PrivateDependencyModuleNames에 추가하고, 프로젝트의 .uproject 파일에도 추가하세요.

Header file (.h)

#pragma once

#include "CoreMinimal.h"
#include "UObject/Object.h"
#include "AppendAudioClassExample.generated.h"

UCLASS(BlueprintType)
class EXAMPLEMODULE_API UAppendAudioClassExample : public UObject
{
	GENERATED_BODY()

public:
	UFUNCTION(BlueprintCallable)
	void AppendAudioExample();

private:
	// Please pay attention to making the StreamingSoundWave a hard reference, such as using UPROPERTY(), to prevent it from being prematurely garbage collected
	UPROPERTY()
	class UStreamingSoundWave* StreamingSoundWave;
};

Source file (.cpp)

#include "AppendAudioClassExample.h"
#include "Sound/StreamingSoundWave.h"

void UAppendAudioClassExample::AppendAudioExample()
{
    // Create a streaming sound wave
	StreamingSoundWave = UStreamingSoundWave::CreateStreamingSoundWave();

	// Append audio data
	TArray<uint8> StreamedAudioDataToAdd = ...; // Fill with audio data
	StreamingSoundWave->AppendAudioDataFromEncoded(StreamedAudioDataToAdd, ERuntimeAudioFormat::Auto);

	// Play the sound wave
	UGameplayStatics::PlaySound2D(GetWorld(), StreamingSoundWave);
}

오디오 상태 채우기

OnPopulateAudioState 대리자는 OnPopulateAudioData와 유사하게 작동하지만 채워진 오디오 데이터를 방송하지 않습니다. 이는 채워진 오디오 데이터를 배열로 전달하지 않고도 오디오 데이터가 채워졌을 때를 추적하려는 경우 성능을 향상시킬 수 있어 유용할 수 있습니다.

Blueprint

C++

// Assuming StreamingSoundWave is a UE reference to a UStreamingSoundWave object (or its derived type, such as UCapturableSoundWave)

StreamingSoundWave->OnPopulateAudioStateNative.AddWeakLambda(this, [this]()
{
    // Handle the result
});

PCM 데이터 처리

재생 중 PCM 데이터에 실시간으로 액세스하려면 PCM 데이터 처리를 참조하십시오.