Passa al contenuto principale

Configurazione specifica della 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 puntando alle piattaforme Android o Meta Quest e incontri errori di build 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. Sotto Piattaforme - Android, sezione Build, trova Supporta x86_64 [alias x64] e assicurati che sia disabilitato, come mostrato sotto

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 (come durante i test TestFlight). Questo è causato dai requisiti di allocazione della memoria della libreria ONNX Runtime sottostante che confliggono 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 precedenti:

  • Il tuo progetto deve utilizzare un motore costruito dal sorgente (non un binario pre-compilato)
  • 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 pre-compilate che compilate dai sorgenti
  • Aggiungi la seguente riga al tuo file Target.cs:
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 Sincronizzazione Labiale 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 sincronizzazione labiale realistica.

Soluzione​

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

  1. Naviga nella cartella di installazione di Unreal Engine
  2. Vai su 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 è richiesta 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.