Saltar al contenido principal

Configuración específica de la plataforma

Esta guía cubre los requisitos de configuración y configuraciones específicas de la plataforma para el plugin Runtime Text To Speech.

Fallos en Android e iOS​

En algunos casos en Android e iOS, pueden ocurrir fallos durante el tiempo de ejecución (como durante las pruebas de TestFlight). Esto es causado por los requisitos de asignación de memoria de la biblioteca subyacente ONNX Runtime que entran en conflicto con los asignadores predeterminados de Unreal Engine en estas plataformas.

Para resolver esto, necesitas forzar el asignador ANSI en el archivo Target.cs de tu proyecto:

Para Unreal Engine 5.5 y versiones anteriores:

  • Tu proyecto debe usar un motor construido desde el código fuente (no un binario precompilado)
  • Agrega la siguiente línea a tu archivo Target.cs:
GlobalDefinitions.Add("FORCE_ANSI_ALLOCATOR=1");

Para Unreal Engine 5.6 y versiones posteriores:

  • Funciona tanto con compilaciones del motor construidas desde el código fuente como con las precompiladas
  • Agrega las siguientes dos líneas a tu archivo Target.cs:
bOverrideBuildEnvironment = true;
StaticAllocator = StaticAllocatorType.Ansi;

Esto fuerza a Unreal Engine a usar el asignador ANSI en Android e iOS, coincidiendo con el asignador utilizado por ONNX Runtime.

Configuración para Mac / Linux (UE 5.6+)​

Conflicto del Plugin NNERuntimeORT

Si estás usando Unreal Engine 5.6 o posterior en plataformas Mac o Linux, encontrarás un conflicto de plugins que impide que los modelos realistas funcionen correctamente.

El Problema​

A partir de UE 5.6, el motor incluye el plugin NNERuntimeORT, que entra en conflicto con los modelos realistas del plugin Runtime MetaHuman Lip Sync en las plataformas Mac y Linux. Este conflicto impide que la funcionalidad de sincronización labial realista se inicialice correctamente.

Solución​

Para resolver este conflicto, necesitas modificar el archivo de configuración del plugin:

  1. Navega a la carpeta de instalación de tu Unreal Engine
  2. Ve a Engine/Plugins/Marketplace/
  3. Encuentra la carpeta del plugin RuntimeTextToSpeech
  4. Abre el archivo RuntimeTextToSpeech.uplugin en un editor de texto
  5. Elimina completamente la siguiente sección:
,
  "Plugins": [
    {
      "Name": "NNERuntimeORT",
      "Enabled": true
    }
  ]

Notas Importantes​

  • Esta modificación solo afecta a las plataformas Mac y Linux. Los usuarios de Windows no necesitan realizar este cambio.
  • Esta corrección solo es necesaria para UE 5.6 y versiones posteriores. Las versiones anteriores del motor no se ven afectadas.
  • Es posible que necesites repetir este proceso si actualizas el plugin, ya que las actualizaciones restaurarán el archivo de configuración original.