Passa al contenuto principale

Configurazione specifica per piattaforma

Questa guida copre i requisiti di configurazione e setup specifici per piattaforma del plugin Runtime MetaHuman Lip Sync.

Configurazione Android / Meta Quest​

Se stai sviluppando per le piattaforme Android o Meta Quest e incontri errori di compilazione con questo plugin, dovrai disabilitare l'architettura Android x86_64 (x64) nelle impostazioni del tuo progetto:

  1. Vai su Modifica > Impostazioni Progetto
  2. Naviga su Piattaforme > Android
  3. Nella sezione Compilazione di Piattaforme - Android, trova Supporta x86_64 [alias x64] e assicurati che sia disabilitata, come mostrato di seguito

Disabilita Architettura Android x64

Questo perché il plugin attualmente supporta solo le architetture arm64-v8a e armeabi-v7a per le piattaforme Android / Meta Quest.

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, devi 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 su piattaforme Mac o Linux e prevedi di utilizzare i Modelli di Lip Sync Realistici, 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 RuntimeMetaHumanLipSync
  4. Apri il file RuntimeMetaHumanLipSync.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 questa procedura se si aggiorna il plugin, poiché gli aggiornamenti ripristineranno il file di configurazione originale.