Skip to main content

Platform-specific Configuration

This guide covers platform-specific setup requirements and configurations for the Runtime Text To Speech plugin.

Android and iOS Crashes​

In some cases on Android and iOS, crashes may occur during runtime (such as during TestFlight testing). This is caused by the underlying ONNX Runtime library's memory allocation requirements conflicting with Unreal Engine's default allocators on these platforms.

To resolve this, you need to force the ANSI allocator in your project's Target.cs file:

For Unreal Engine 5.5 and earlier:

  • Your project must use a source-built engine (not a pre-compiled binary)
  • Add the following line to your Target.cs file:
GlobalDefinitions.Add("FORCE_ANSI_ALLOCATOR=1");

For Unreal Engine 5.6 and later:

  • Works with both source-built and pre-compiled engine builds
  • Add the following two lines to your Target.cs file:
bOverrideBuildEnvironment = true;
StaticAllocator = StaticAllocatorType.Ansi;

This forces Unreal Engine to use the ANSI allocator on Android and iOS, matching the allocator used by ONNX Runtime.