Zum Hauptinhalt springen

Plattformspezifische Konfiguration

Diese Anleitung behandelt plattformspezifische Einrichtungsanforderungen und Konfigurationen für das Runtime Text To Speech Plugin.

Android- und iOS-Abstürze​

In einigen Fällen kann es auf Android und iOS während der Laufzeit zu Abstürzen kommen (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 aus dem Quellcode erstellte 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 selbst kompilierten als auch mit vorkompilierten Engine-Builds
  • Fügen Sie die folgenden zwei Zeilen zu Ihrer Target.cs-Datei hinzu:
bOverrideBuildEnvironment = true;
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, 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 mit den realistischen Modellen des Runtime MetaHuman Lip Sync-Plugins auf Mac- und Linux-Plattformen in Konflikt steht. Dieser Konflikt verhindert, dass die realistische Lippen-Synchronisierungsfunktionalität korrekt 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 RuntimeTextToSpeech-Plugin-Ordner
  4. Öffnen Sie die Datei RuntimeTextToSpeech.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.