Configurazione specifica per piattaforma

Questa guida copre i requisiti di configurazione specifici per piattaforma e le impostazioni per il plugin Runtime Text To Speech.

Crash su Android e iOS

In alcuni casi su Android e iOS, possono verificarsi crash durante il runtime (ad esempio durante i test TestFlight). Ciò è causato dai requisiti di allocazione della memoria della libreria ONNX Runtime sottostante che entrano in conflitto con gli allocatori predefiniti di Unreal Engine su queste piattaforme.

Per risolvere questo problema, è necessario forzare l'allocatore ANSI nel file Target.cs del tuo progetto:

Per Unreal Engine 5.5 e versioni precedenti:

• Il tuo progetto deve utilizzare un motore compilato da sorgente (non un binario precompilato)
• Aggiungi la seguente riga al tuo file Target.cs:

GlobalDefinitions.Add("FORCE_ANSI_ALLOCATOR=1");

Per Unreal Engine 5.6 e versioni successive:

• Funziona sia con build del motore compilate da sorgente che precompilate
• Aggiungi le seguenti due righe al tuo file Target.cs:

bOverrideBuildEnvironment = true;
StaticAllocator = StaticAllocatorType.Ansi;

Questo forza Unreal Engine a utilizzare l'allocatore ANSI su Android e iOS, corrispondendo all'allocatore utilizzato da ONNX Runtime.

Configurazione Mac / Linux (UE 5.6+)

Conflitto Plugin NNERuntimeORT

Se stai utilizzando Unreal Engine 5.6 o versioni successive sulle piattaforme Mac o Linux, incontrerai un conflitto di plugin che impedisce il corretto funzionamento dei modelli realistici.

Il Problema

A partire da UE 5.6, il motore include il plugin NNERuntimeORT, che entra in conflitto con i modelli realistici del plugin Runtime MetaHuman Lip Sync sulle piattaforme Mac e Linux. Questo conflitto impedisce l'inizializzazione corretta della funzionalità di lip sync realistico.

Soluzione

Per risolvere questo conflitto, è necessario modificare il file di configurazione del plugin:

1. Naviga nella cartella di installazione di Unreal Engine
2. Vai in Engine/Plugins/Marketplace/
3. Trova la cartella del plugin RuntimeTextToSpeech
4. Apri il file RuntimeTextToSpeech.uplugin in un editor di testo
5. Rimuovi completamente la seguente sezione:

,
  "Plugins": [
    {
      "Name": "NNERuntimeORT",
      "Enabled": true
    }
  ]

Note importanti

• Questa modifica interessa solo le piattaforme Mac e Linux. Gli utenti Windows non devono apportare questa modifica.
• Questa correzione è necessaria solo per UE 5.6 e versioni successive. Le versioni precedenti del motore non sono interessate.
• Potrebbe essere necessario ripetere questo processo se si aggiorna il plugin, poiché gli aggiornamenti ripristineranno il file di configurazione originale.