Skip to main content

Platform-specific configuration

This guide covers platform-specific setup requirements and configurations for the Runtime MetaHuman Lip Sync plugin.

Android / Meta Quest Configuration

If you're targeting Android or Meta Quest platforms and encounter build errors with this plugin, you'll need to disable the x86_64 (x64) Android architecture in your project settings:

  1. Go to Edit > Project Settings
  2. Navigate to Platforms > Android
  3. Under Platforms - Android, Build section, find Support x86_64 [aka x64] and ensure it's disabled, as shown below

Disable x64 Android Architecture

This is because the plugin currently only supports arm64-v8a and armeabi-v7a architectures for Android / Meta Quest platforms.

Mac / Linux Configuration (UE 5.6+)

NNERuntimeORT Plugin Conflict

If you're using Unreal Engine 5.6 or later on Mac or Linux platforms and plan to use the Realistic Lip Sync Models, you'll encounter a plugin conflict that prevents the realistic models from working correctly.

The Issue

Starting with UE 5.6, the engine includes the NNERuntimeORT plugin, which conflicts with the Runtime MetaHuman Lip Sync plugin's realistic models on Mac and Linux platforms. This conflict prevents the realistic lip sync functionality from initializing properly.

Solution

To resolve this conflict, you need to modify the plugin configuration file:

  1. Navigate to your Unreal Engine installation folder
  2. Go to Engine/Plugins/Marketplace/
  3. Find the RuntimeMetaHumanLipSync plugin folder
  4. Open the RuntimeMetaHumanLipSync.uplugin file in a text editor
  5. Remove the following section entirely:
,
"Plugins": [
{
"Name": "NNERuntimeORT",
"Enabled": true
}
]

Important Notes

  • This modification only affects Mac and Linux platforms. Windows users do not need to make this change.
  • This fix is only required for UE 5.6 and later. Earlier engine versions are not affected.
  • You may need to repeat this process if you update the plugin, as updates will restore the original configuration file.