Zum Hauptinhalt springen

Plattformspezifische Konfiguration

Dieser Leitfaden behandelt plattformspezifische Einrichtungsanforderungen und Konfigurationen für das Runtime MetaHuman Lip Sync Plugin.

Android / Meta Quest Konfiguration​

Wenn Sie auf Android- oder Meta Quest-Plattformen abzielen und Build-Fehler mit diesem Plugin auftreten, müssen Sie die x86_64 (x64) Android-Architektur in Ihren Projekteinstellungen deaktivieren:

  1. Gehen Sie zu Bearbeiten > Projekteinstellungen
  2. Navigieren Sie zu Plattformen > Android
  3. Unter Plattformen - Android, Abschnitt Erstellen, finden Sie x86_64 [auch x64] unterstützen und stellen Sie sicher, dass es deaktiviert ist, wie unten gezeigt

x64 Android-Architektur deaktivieren

Dies liegt daran, dass das Plugin derzeit nur die arm64-v8a- und armeabi-v7a-Architekturen für Android- / Meta Quest-Plattformen unterstützt.

Android- und iOS-Abstürze​

In einigen Fällen auf Android und iOS können Abstürze während der Laufzeit auftreten (z. B. während TestFlight-Tests). Dies wird durch die Speicherzuweisungsanforderungen der zugrunde liegenden ONNX Runtime-Bibliothek verursacht, die mit den Standard-Zuweisern der Unreal Engine auf diesen Plattformen in Konflikt stehen.

Um dies zu beheben, müssen Sie den ANSI-Zuweiser in der Target.cs-Datei Ihres Projekts erzwingen:

Für Unreal Engine 5.5 und früher:

  • Ihr Projekt muss eine quellcodebasierte Engine verwenden (keine vorkompilierte Binärdatei)
  • Fügen Sie die folgende Zeile zu Ihrer Target.cs-Datei hinzu:
GlobalDefinitions.Add("FORCE_ANSI_ALLOCATOR=1");

Für Unreal Engine 5.6 und höher:

  • Funktioniert sowohl mit quellgebauten als auch mit vorkompilierten Engine-Builds
  • Fügen Sie die folgende Zeile zu Ihrer Target.cs-Datei hinzu:
StaticAllocator = StaticAllocatorType.Ansi;

Dies zwingt Unreal Engine dazu, den ANSI-Allokator auf Android und iOS zu verwenden, was dem von ONNX Runtime verwendeten Allokator entspricht.

Mac / Linux Konfiguration (UE 5.6+)​

NNERuntimeORT Plugin-Konflikt

Wenn Sie Unreal Engine 5.6 oder höher auf Mac- oder Linux-Plattformen verwenden und planen, die Realistic Lip Sync Models zu nutzen, werden Sie auf einen Plugin-Konflikt stoßen, der verhindert, dass die realistischen Modelle korrekt funktionieren.

Das Problem​

Ab UE 5.6 enthält die Engine das NNERuntimeORT-Plugin, das auf Mac- und Linux-Plattformen mit den realistischen Modellen des Runtime MetaHuman Lip Sync-Plugins in Konflikt steht. Dieser Konflikt verhindert, dass die realistische Lippen-Sync-Funktionalität ordnungsgemäß initialisiert wird.

Lösung​

Um diesen Konflikt zu beheben, müssen Sie die Plugin-Konfigurationsdatei ändern:

  1. Navigieren Sie zu Ihrem Unreal Engine-Installationsordner
  2. Gehen Sie zu Engine/Plugins/Marketplace/
  3. Suchen Sie den RuntimeMetaHumanLipSync-Plugin-Ordner
  4. Öffnen Sie die Datei RuntimeMetaHumanLipSync.uplugin in einem Texteditor
  5. Entfernen Sie den folgenden Abschnitt vollständig:
,
  "Plugins": [
    {
      "Name": "NNERuntimeORT",
      "Enabled": true
    }
  ]

Wichtige Hinweise​

  • Diese Änderung betrifft nur Mac- und Linux-Plattformen. Windows-Benutzer müssen diese Änderung nicht vornehmen.
  • Diese Korrektur ist nur für UE 5.6 und höher erforderlich. Frühere Engine-Versionen sind nicht betroffen.
  • Möglicherweise müssen Sie diesen Vorgang wiederholen, wenn Sie das Plugin aktualisieren, da Updates die ursprüngliche Konfigurationsdatei wiederherstellen.