UVoiceCacheManager 클래스 참조

TTS 오디오 데이터를 캐싱하여 네트워크 요청을 최소화하는 서브시스템입니다. 더 자세히 ...

#include <UAudioCacheManager.h>

UVoiceCacheManager에 대한 상속 다이어그램 :

UVoiceCacheManager에 대한 협력 다이어그램:

Public 멤버 함수
void	ClearCache ()
	전체 캐시를 초기화합니다 (메모리 + 디스크).
	DEFINE_SUBSYSTEM_GETTER_INLINE (UVoiceCacheManager)
virtual void	Deinitialize () override
	서브시스템 종료 시 메모리 캐시를 정리합니다.
virtual void	Initialize (FSubsystemCollectionBase &Collection) override
	서브시스템 초기화 시 캐시 디렉토리를 생성합니다.
void	SaveToCache (const FString &AudioText, const TArray< uint8 > &AudioData)
	오디오 데이터를 메모리와 디스크 캐시에 저장합니다.
bool	TryGetCachedAudio (const FString &AudioText, TArray< uint8 > &OutAudioData)
	캐시에서 오디오 데이터를 조회합니다.

정적 Private 멤버 함수
static FString	GenerateCacheFileName (const FString &AudioText)
	AudioText를 MD5 해시하여 파일명을 생성합니다.
static FString	GetCacheDirectory ()
	캐시 디렉토리 경로를 반환합니다.
static bool	LoadFromDisk (const FString &AudioText, TArray< uint8 > &OutAudioData)
	디스크에서 오디오 데이터를 로드합니다.
static bool	SaveToDisk (const FString &AudioText, const TArray< uint8 > &AudioData)
	디스크에 오디오 데이터를 저장합니다.

Private 속성
TMap< FString, TArray< uint8 > >	MemoryCache
	메모리 캐시 (Key: AudioText, Value: 오디오 데이터)

상세한 설명

TTS 오디오 데이터를 캐싱하여 네트워크 요청을 최소화하는 서브시스템입니다.

2단계 캐싱 전략:

• 1단계: 메모리 캐시 (TMap) - 빠른 접근
• 2단계: 디스크 캐시 (파일 시스템) - 영구 저장

AudioText를 키로 사용하며, 파일명은 MD5 해시로 생성됩니다.

UAudioCacheManager.h 파일의 24 번째 라인에서 정의되었습니다.

멤버 함수 문서화

ClearCache()

void UVoiceCacheManager::ClearCache

(

)

전체 캐시를 초기화합니다 (메모리 + 디스크).

UAudioCacheManager.cpp 파일의 82 번째 라인에서 정의되었습니다.

{
    // [1] 메모리 캐시 초기화
    MemoryCache.Empty();
 
    // [2] 디스크 캐시 초기화
    FString CacheDir = GetCacheDirectory();
    IPlatformFile& PlatformFile = FPlatformFileManager::Get().GetPlatformFile();
 
    TArray<FString> Files;
    PlatformFile.FindFiles(Files, *CacheDir, TEXT(".wav"));
 
    int32 DeletedCount = 0;
    for (const FString& File : Files)
    {
        FString FullPath = CacheDir / File;
        if (PlatformFile.DeleteFile(*FullPath))
        {
            DeletedCount++;
        }
    }
}

다음을 참조함 : GetCacheDirectory(), MemoryCache.

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

DEFINE_SUBSYSTEM_GETTER_INLINE()

UVoiceCacheManager::DEFINE_SUBSYSTEM_GETTER_INLINE

(

UVoiceCacheManager

)

Deinitialize()

void UVoiceCacheManager::Deinitialize ( )

overridevirtual

서브시스템 종료 시 메모리 캐시를 정리합니다.

UAudioCacheManager.cpp 파일의 35 번째 라인에서 정의되었습니다.

{
    // 메모리 캐시 정리
    MemoryCache.Empty();
    Super::Deinitialize();
}

다음을 참조함 : MemoryCache.

GenerateCacheFileName()

FString UVoiceCacheManager::GenerateCacheFileName ( const FString &  AudioText )

staticprivate

AudioText를 MD5 해시하여 파일명을 생성합니다.

매개변수

AudioText

[in] TTS 텍스트

반환값

MD5 해시 기반 파일명 (예: "5d41402abc4b2a76b9719d911017c592.wav")

UAudioCacheManager.cpp 파일의 106 번째 라인에서 정의되었습니다.

{
    return UCommonFunctionLibrary::GererateMD5(AudioText) + TEXT(".wav");
}

다음을 참조함 : UCommonFunctionLibrary::GererateMD5().

다음에 의해서 참조됨 : LoadFromDisk(), SaveToDisk().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

GetCacheDirectory()

FString UVoiceCacheManager::GetCacheDirectory ( )

staticprivate

캐시 디렉토리 경로를 반환합니다.

반환값

캐시 디렉토리 절대 경로 (예: "[ProjectSavedDir]/AudioCache")

UAudioCacheManager.cpp 파일의 111 번째 라인에서 정의되었습니다.

{
    return FPaths::ProjectSavedDir() / TEXT("VoiceCache");
}

다음에 의해서 참조됨 : ClearCache(), Initialize(), LoadFromDisk(), SaveToDisk().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

Initialize()

void UVoiceCacheManager::Initialize ( FSubsystemCollectionBase &  Collection )

overridevirtual

서브시스템 초기화 시 캐시 디렉토리를 생성합니다.

UAudioCacheManager.cpp 파일의 18 번째 라인에서 정의되었습니다.

{
    Super::Initialize(Collection);
 
    // 캐시 디렉토리 생성
    FString CacheDir = GetCacheDirectory();
    IPlatformFile& PlatformFile = FPlatformFileManager::Get().GetPlatformFile();
 
    if (!PlatformFile.DirectoryExists(*CacheDir))
    {
        if (PlatformFile.CreateDirectory(*CacheDir))
        {
            PRINTLOG(TEXT("[AudioCache] Cache directory created: %s"), *CacheDir);
        }
    }
}

다음을 참조함 : GetCacheDirectory(), PRINTLOG.

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

LoadFromDisk()

bool UVoiceCacheManager::LoadFromDisk ( const FString &  AudioText, TArray< uint8 > &  OutAudioData  )

staticprivate

디스크에서 오디오 데이터를 로드합니다.

매개변수

AudioText	[in] TTS 텍스트
OutAudioData	[out] 로드된 오디오 데이터

반환값

로드 성공 여부

UAudioCacheManager.cpp 파일의 116 번째 라인에서 정의되었습니다.

{
    FString CacheFilePath = GetCacheDirectory() / GenerateCacheFileName(AudioText);
    return FFileHelper::LoadFileToArray(OutAudioData, *CacheFilePath);
}

다음을 참조함 : GenerateCacheFileName(), GetCacheDirectory().

다음에 의해서 참조됨 : TryGetCachedAudio().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

SaveToCache()

void UVoiceCacheManager::SaveToCache	(	const FString &	AudioText,
		const TArray< uint8 > &	AudioData
	)

오디오 데이터를 메모리와 디스크 캐시에 저장합니다.

매개변수

AudioText	[in] TTS 텍스트 (캐시 키)
AudioData	[in] TTS 오디오 데이터 (WAV 형식)

UAudioCacheManager.cpp 파일의 64 번째 라인에서 정의되었습니다.

{
    if (AudioData.Num() == 0)
    {
        PRINTLOG(TEXT("[AudioCache] Cannot save empty audio data: %s"), *AudioText);
        return;
    }
 
    // 메모리 캐시 저장
    if (MemoryCache.Contains(AudioText))
        // 기존 항목 제거 후 다시 추가
        MemoryCache.Remove(AudioText);
    MemoryCache.Add(AudioText, AudioData);
 
    // [2] 디스크 캐시 저장
    SaveToDisk(AudioText, AudioData);
}

다음을 참조함 : MemoryCache, PRINTLOG, SaveToDisk().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

SaveToDisk()

bool UVoiceCacheManager::SaveToDisk ( const FString &  AudioText, const TArray< uint8 > &  AudioData  )

staticprivate

디스크에 오디오 데이터를 저장합니다.

매개변수

AudioText	[in] TTS 텍스트
AudioData	[in] 저장할 오디오 데이터

반환값

저장 성공 여부

UAudioCacheManager.cpp 파일의 122 번째 라인에서 정의되었습니다.

{
    FString CacheDir = GetCacheDirectory();
    IPlatformFile& PlatformFile = FPlatformFileManager::Get().GetPlatformFile();
 
    if (!PlatformFile.DirectoryExists(*CacheDir))
    {
        if (!PlatformFile.CreateDirectory(*CacheDir))
        {
            return false;
        }
    }
 
    // 파일 저장
    FString CacheFilePath = CacheDir / GenerateCacheFileName(AudioText);
    return FFileHelper::SaveArrayToFile(AudioData, *CacheFilePath);
}

다음을 참조함 : GenerateCacheFileName(), GetCacheDirectory().

다음에 의해서 참조됨 : SaveToCache().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

TryGetCachedAudio()

bool UVoiceCacheManager::TryGetCachedAudio	(	const FString &	AudioText,
		TArray< uint8 > &	OutAudioData
	)

캐시에서 오디오 데이터를 조회합니다.

매개변수

AudioText	[in] TTS 텍스트 (캐시 키)
OutAudioData	[out] 캐시된 오디오 데이터 (WAV 형식)

반환값

캐시 히트 여부 (true: 히트, false: 미스)

UAudioCacheManager.cpp 파일의 42 번째 라인에서 정의되었습니다.

{
    // 메모리 캐시 확인
    if (TArray<uint8>* Found = MemoryCache.Find(AudioText))
    {
        OutAudioData = *Found;
        return true;
    }
 
    // 디스크 캐시 확인
    if (LoadFromDisk(AudioText, OutAudioData))
    {
        // 메모리 캐시에도 저장 (다음번 빠른 접근)
        if (!MemoryCache.Contains(AudioText))
            MemoryCache.Add(AudioText, OutAudioData);
 
        return true;
    }
 
    return false;
}

다음을 참조함 : LoadFromDisk(), MemoryCache.

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

MemoryCache

TMap<FString, TArray<uint8> > UVoiceCacheManager::MemoryCache

private

메모리 캐시 (Key: AudioText, Value: 오디오 데이터)

UAudioCacheManager.h 파일의 90 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ClearCache(), Deinitialize(), SaveToCache(), TryGetCachedAudio().

---

이 클래스에 대한 문서화 페이지는 다음의 파일들로부터 생성되었습니다.:

• Source/Onepiece/Voice/Public/UAudioCacheManager.h
• Source/Onepiece/Voice/Private/UAudioCacheManager.cpp