오디오 가져오기

런타임에 오디오를 가져오는 프로세스는 여러 단계로 나눌 수 있습니다:

1. Runtime Audio Importer 생성.
2. 필요한 대리자들(OnProgress 및 OnResult)에 바인딩.
3. 파일이나 버퍼에서 오디오 가져오기.
4. OnResult 대리자에서 얻은 가져온 사운드 웨이브를 재생 (여기서 더 많은 정보).

Runtime Audio Importer와 Sound Wave 인스턴스가 조기에 garbage collected되지 않도록 하드 참조를 유지하여 별도의 변수에 할당하는 방식으로 할당하세요. 이는 UPROPERTY(), TStrongObjectPtr, 또는 객체가 파괴되지 않도록 하는 다른 방법을 사용할 수 있습니다.

Blueprints 예제

먼저, Runtime Audio Importer 객체를 생성해야 합니다. 이를 Blueprints에서 별도의 변수로 설정하여 garbage collector가 강한 참조로 처리하도록 보장해야 합니다. 이는 객체의 조기 파괴를 방지합니다.

Blueprint

C++

Header, in the UCLASS declaration (.h)

// UPROPERTY() is used here to prevent the object from being prematurely garbage collected
UPROPERTY()
class URuntimeAudioImporterLibrary* Importer;

Source file, in the function where you want to create the importer (.cpp)

Importer = URuntimeAudioImporterLibrary::CreateRuntimeAudioImporter();

---

오디오 데이터 가져오기 진행 상황을 추적하려면 OnProgress (Blueprints) / OnProgressNative (C++) 대리자에 바인딩할 수 있습니다. 이렇게 하면 진행 상황을 모니터링하고, 예를 들어 로딩 화면을 구현할 수 있습니다. 이 대리자에 바인딩하려면 바인드 이벤트 노드에서 이벤트 핀을 당기기만 하면 됩니다.

Blueprint

C++

// Assuming Importer is a UE reference to a URuntimeAudioImporterLibrary object
// AddWeakLambda is used just as an example. You can use any other method to bind the delegate, such as AddUObject, AddUFunction, etc.
Importer->OnProgressNative.AddWeakLambda(this, [](int32 Percentage)
{
	UE_LOG(LogTemp, Log, TEXT("Import progress: %d"), Percentage);
});

---

오디오 데이터 가져오기 프로세스가 완료되면 알림을 받고, 결과로 얻어진 사운드 웨이브의 참조에 접근하려면, OnResult (Blueprints) / OnResultNative (C++) 델리게이트에 바인딩해야 합니다. 또한, 가져온 사운드 웨이브가 가비지 컬렉터가 강한 참조로 처리하도록 하여 원치 않는 조기 가비지 컬렉션을 방지해야 합니다. 이는 Blueprints에서 별도의 변수로 설정함으로써 수행할 수 있습니다.

Blueprint

C++

// Assuming Importer is a UE reference to a URuntimeAudioImporterLibrary object
// AddWeakLambda is used just as an example. You can use any other method to bind the delegate, such as AddUObject, AddUFunction, etc.
Importer->OnResultNative.AddWeakLambda(this, [](URuntimeAudioImporterLibrary* Importer, UImportedSoundWave* ImportedSoundWave, ERuntimeImportStatus Status)
{
	UE_LOG(LogTemp, Log, TEXT("Import result: %s"), *UEnum::GetValueAsString(Status));
});

---

관련 함수를 호출하여 오디오 가져오기 프로세스를 시작합니다. 이 함수는 압축 및 비압축 오디오 데이터 형식을 모두 처리할 수 있습니다.

Blueprint

C++

// Assuming Importer is a UE reference to a URuntimeAudioImporterLibrary object

// Import audio from a file
Importer->ImportAudioFromFile(TEXT("C:/Folder/AudioFile.mp3"), ERuntimeAudioFormat::Auto);

// Import audio from a buffer
TArray<uint8> AudioData = ...; // Fill the array with your audio data
Importer->ImportAudioFromBuffer(MoveTemp(AudioData), ERuntimeAudioFormat::OggVorbis);

// Import audio from a RAW file
Importer->ImportAudioFromRAWFile(TEXT("C:/Folder/AudioFile.raw"), ERuntimeRAWAudioFormat::Int8, 44100, 2);

// Import audio from a RAW buffer
TArray<uint8> RAWBuffer = ...; // Fill the array with your PCM int 16-bit audio data
Importer->ImportAudioFromRAWBuffer(MoveTemp(RAWBuffer), ERuntimeRAWAudioFormat::Int16, 44100, 2);

---

가져오기 과정이 완료되면, 결과적으로 가져온 소리 파형을 OnResult 델리게이트를 통해 얻을 수 있습니다.

전체 예제

Blueprint

C++

이것은 파일에서 오디오를 가져오는 기본 코드 예제입니다.

예제는 EXAMPLEMODULE 모듈 내 UImportAudioClassExample 클래스에 위치한 ImportAudioExample 함수를 사용합니다.

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

Header file (.h)

#pragma once

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

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

public:
	UFUNCTION(BlueprintCallable)
	void ImportAudioExample();

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

Source file (.cpp)

#include "ImportAudioClassExample.h"
#include "RuntimeAudioImporterLibrary.h"

void UImportAudioClassExample::ImportAudioExample()
{
	RuntimeAudioImporter = URuntimeAudioImporterLibrary::CreateRuntimeAudioImporter();

	if (!IsValid(RuntimeAudioImporter))
	{
		UE_LOG(LogTemp, Error, TEXT("Failed to create audio importer"));
		return;
	}

	RuntimeAudioImporter->OnProgressNative.AddWeakLambda(this, [](int32 Percentage)
	{
		UE_LOG(LogTemp, Log, TEXT("Audio importing percentage: %d"), Percentage);
	});

	RuntimeAudioImporter->OnResultNative.AddWeakLambda(this, [this](URuntimeAudioImporterLibrary* Importer, UImportedSoundWave* ImportedSoundWave, ERuntimeImportStatus Status)
	{
		if (Status == ERuntimeImportStatus::SuccessfulImport)
		{
			UE_LOG(LogTemp, Warning, TEXT("Successfully imported audio with sound wave %s"), *ImportedSoundWave->GetName());
			// Here you can handle ImportedSoundWave playback, like "UGameplayStatics::PlaySound2D(GetWorld(), ImportedSoundWave);"
		}
		else
		{
			UE_LOG(LogTemp, Error, TEXT("Failed to import audio"));
		}

		RuntimeAudioImporter = nullptr;
	});

	RuntimeAudioImporter->ImportAudioFromFile(TEXT("C:/Folder/Example.mp3"), ERuntimeAudioFormat::Auto);
}