플랫폼별 구성

이 가이드는 Runtime Text To Speech 플러그인에 대한 플랫폼별 설정 요구사항과 구성을 다룹니다.

Android 및 iOS 충돌

Android와 iOS에서는 경우에 따라 런타임 중(예: TestFlight 테스트 중) 충돌이 발생할 수 있습니다. 이는 기본 ONNX Runtime 라이브러리의 메모리 할당 요구사항이 이러한 플랫폼에서 Unreal Engine의 기본 할당자와 충돌하기 때문입니다.

이를 해결하려면 프로젝트의 Target.cs 파일에서 ANSI 할당자를 강제로 사용해야 합니다:

Unreal Engine 5.5 및 이전 버전의 경우:

• 프로젝트는 사전 컴파일된 바이너리가 아닌 소스 빌드 엔진을 사용해야 합니다.
• Target.cs 파일에 다음 줄을 추가하세요:

GlobalDefinitions.Add("FORCE_ANSI_ALLOCATOR=1");

언리얼 엔진 5.6 이상의 경우:

• 소스 빌드와 사전 컴파일된 엔진 빌드 모두에서 작동합니다.
• Target.cs 파일에 다음 두 줄을 추가하세요:

bOverrideBuildEnvironment = true;
StaticAllocator = StaticAllocatorType.Ansi;

이렇게 하면 Unreal Engine이 Android와 iOS에서 ANSI 할당자를 사용하도록 강제하여, ONNX Runtime이 사용하는 할당자와 일치시킵니다.

Mac / Linux 구성 (UE 5.6+)

NNERuntimeORT 플러그인 충돌

Mac 또는 Linux 플랫폼에서 Unreal Engine 5.6 이상을 사용하는 경우, 현실적인 모델이 올바르게 작동하지 못하게 하는 플러그인 충돌이 발생합니다.

문제점

UE 5.6부터 엔진에 NNERuntimeORT 플러그인이 포함되어 있으며, 이는 Mac 및 Linux 플랫폼에서 Runtime MetaHuman Lip Sync 플러그인의 현실적인 모델과 충돌합니다. 이 충돌은 현실적인 립싱크 기능이 제대로 초기화되는 것을 방지합니다.

해결 방법

이 충돌을 해결하려면 플러그인 구성 파일을 수정해야 합니다:

1. Unreal Engine 설치 폴더로 이동합니다.
2. Engine/Plugins/Marketplace/로 이동합니다.
3. RuntimeTextToSpeech 플러그인 폴더를 찾습니다.
4. 텍스트 편집기에서 RuntimeTextToSpeech.uplugin 파일을 엽니다.
5. 다음 섹션을 완전히 제거합니다:

,
  "Plugins": [
    {
      "Name": "NNERuntimeORT",
      "Enabled": true
    }
  ]

중요 참고사항

• 이 수정은 Mac 및 Linux 플랫폼에만 영향을 미칩니다. Windows 사용자는 이 변경을 할 필요가 없습니다.
• 이 수정은 UE 5.6 이상 버전에서만 필요합니다. 이전 엔진 버전은 영향을 받지 않습니다.
• 플러그인을 업데이트할 경우 이 과정을 반복해야 할 수 있습니다. 업데이트 시 원래 구성 파일이 복원되기 때문입니다.