Перейти к основному содержимому

Конфигурация для конкретных платформ

Это руководство охватывает требования к настройке и конфигурации для конкретных платформ для плагина Runtime Text To Speech.

Сбои на Android и iOS

В некоторых случаях на Android и iOS могут возникать сбои во время выполнения (например, во время тестирования TestFlight). Это вызвано конфликтом требований к выделению памяти базовой библиотеки ONNX Runtime с аллокаторами по умолчанию Unreal Engine на этих платформах.

Для решения этой проблемы необходимо принудительно использовать ANSI аллокатор в файле Target.cs вашего проекта:

Для Unreal Engine 5.5 и более ранних версий:

  • Ваш проект должен использовать движок, собранный из исходного кода (не предварительно скомпилированный бинарный файл)
  • Добавьте следующую строку в ваш файл Target.cs:
GlobalDefinitions.Add("FORCE_ANSI_ALLOCATOR=1");

Для Unreal Engine 5.6 и новее:

  • Работает как с собранными из исходников, так и с предварительно скомпилированными сборками движка
  • Добавьте следующие две строки в ваш файл Target.cs:
bOverrideBuildEnvironment = true;
StaticAllocator = StaticAllocatorType.Ansi;

Это заставляет Unreal Engine использовать аллокатор ANSI на Android и iOS, соответствуя аллокатору, используемому ONNX Runtime.

Конфигурация для Mac / Linux (UE 5.6+)

Конфликт плагина NNERuntimeORT

Если вы используете Unreal Engine 5.6 или новее на платформах Mac или Linux, вы столкнетесь с конфликтом плагинов, который мешает корректной работе реалистичных моделей.

Проблема

Начиная с UE 5.6, движок включает плагин NNERuntimeORT, который конфликтует с реалистичными моделями плагина Runtime MetaHuman Lip Sync на платформах Mac и Linux. Этот конфликт мешает правильной инициализации функционала реалистичной синхронизации губ.

Решение

Чтобы разрешить этот конфликт, вам нужно изменить файл конфигурации плагина:

  1. Перейдите в папку установки вашего Unreal Engine
  2. Перейдите в Engine/Plugins/Marketplace/
  3. Найдите папку плагина RuntimeTextToSpeech
  4. Откройте файл RuntimeTextToSpeech.uplugin в текстовом редакторе
  5. Удалите следующий раздел полностью:
,
"Plugins": [
{
"Name": "NNERuntimeORT",
"Enabled": true
}
]

Важные примечания

  • Это изменение затрагивает только платформы Mac и Linux. Пользователям Windows не нужно вносить это изменение.
  • Это исправление требуется только для UE 5.6 и более поздних версий. Более ранние версии движка не затронуты.
  • Возможно, вам потребуется повторить этот процесс, если вы обновите плагин, так как обновления восстановят исходный файл конфигурации.