跳到主要内容

平台特定配置

本指南涵盖了 Runtime MetaHuman Lip Sync 插件的平台特定设置要求和配置。

Android / Meta Quest 配置​

如果您面向Android或Meta Quest平台开发并遇到此插件的构建错误，则需要在项目设置中禁用x86_64（x64）Android架构：

  1. 转到 编辑 > 项目设置
  2. 导航至 平台 > Android
  3. 在 平台 - Android 下的 构建 部分，找到 支持 x86_64 [即 x64] 并确保其禁用，如下所示

Disable x64 Android Architecture

这是因为该插件目前仅支持 arm64-v8a 和 armeabi-v7a 架构，适用于 Android / Meta Quest 平台。

Android 和 iOS 崩溃​

在某些情况下，在 Android 和 iOS 上，运行时可能会发生崩溃（例如在 TestFlight 测试期间）。这是由于底层 ONNX Runtime 库的内存分配要求与 Unreal Engine 在这些平台上的默认分配器发生冲突所致。

要解决此问题，你需要在项目的 Target.cs 文件中强制使用 ANSI 分配器：

适用于 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 在 Android 和 iOS 上使用 ANSI 分配器，与 ONNX Runtime 使用的分配器相匹配。

Mac / Linux 配置 (UE 5.6+)​

NNERuntimeORT 插件冲突

如果你在 Mac 或 Linux 平台上使用 Unreal Engine 5.6 或更高版本，并计划使用 逼真的唇形同步模型，你会遇到一个插件冲突，导致逼真的模型无法正常工作。

问题​

从 UE 5.6 起，引擎包含 NNERuntimeORT 插件，该插件与 Runtime MetaHuman Lip Sync 插件的逼真模型在 Mac 和 Linux 平台上冲突。这一冲突导致逼真口型同步功能无法正常初始化。

解决方案​

为解决此冲突，您需要修改插件配置文件：

  1. 导航到您的Unreal Engine安装文件夹
  2. 转到 Engine/Plugins/Marketplace/
  3. 找到 RuntimeMetaHumanLipSync 插件文件夹
  4. 在文本编辑器中打开 RuntimeMetaHumanLipSync.uplugin 文件
  5. 完全删除以下部分：
,
  "Plugins": [
    {
      "Name": "NNERuntimeORT",
      "Enabled": true
    }
  ]

重要说明​

  • 此修改仅影响 Mac 和 Linux 平台。 Windows 用户无需进行此更改。
  • 此修复仅适用于 UE 5.6 及更高版本。 更早的引擎版本不受影响。
  • 如果更新插件，您可能需要重复此过程， 因为更新会恢复原始配置文件。