Platforma Özel Yapılandırma

Bu kılavuz, Runtime MetaHuman Lip Sync eklentisi için platforma özel kurulum gereksinimlerini ve yapılandırmalarını kapsar.

Android / Meta Quest Yapılandırması

Android veya Meta Quest platformlarını hedefliyorsanız ve bu eklentiyle derleme hatalarıyla karşılaşıyorsanız, proje ayarlarınızda x86_64 (x64) Android mimarisini devre dışı bırakmanız gerekir:

1. Düzenle > Proje Ayarları'na gidin
2. Platformlar > Android'e gidin
3. Platformlar - Android, Derleme bölümü altında, x86_64 [yani x64] Desteği'ni bulun ve aşağıda gösterildiği gibi devre dışı olduğundan emin olun

Bunun nedeni, eklentinin şu anda Android / Meta Quest platformları için yalnızca arm64-v8a ve armeabi-v7a mimarilerini desteklemesidir.

Android ve iOS Çökmeleri

Android ve iOS'ta bazı durumlarda, çalışma zamanında (TestFlight testi sırasında olduğu gibi) çökmeler meydana gelebilir. Bu, temeldeki ONNX Runtime kütüphanesinin bellek ayırma gereksinimlerinin, bu platformlarda Unreal Engine'in varsayılan ayırıcılarıyla çakışmasından kaynaklanır.

Bunu çözmek için, projenizin Target.cs dosyasında ANSI ayırıcıyı zorlamanız gerekir:

Unreal Engine 5.5 ve önceki sürümler için:

• Projeniz kaynak koddan derlenmiş bir motor kullanmalıdır (önceden derlenmiş bir ikili değil)
• Target.cs dosyanıza aşağıdaki satırı ekleyin:

GlobalDefinitions.Add("FORCE_ANSI_ALLOCATOR=1");

Unreal Engine 5.6 ve sonrası için:

• Hem kaynaktan derlenmiş hem de önceden derlenmiş motor yapılarıyla çalışır
• Target.cs dosyanıza aşağıdaki iki satırı ekleyin:

bOverrideBuildEnvironment = true;
StaticAllocator = StaticAllocatorType.Ansi;

Bu, Unreal Engine'ın Android ve iOS'ta ONNX Runtime tarafından kullanılan ayırıcıyla eşleşecek şekilde ANSI ayırıcısını kullanmasını zorlar.

Mac / Linux Yapılandırması (UE 5.6+)

NNERuntimeORT Eklenti Çakışması

Mac veya Linux platformlarında Unreal Engine 5.6 veya sonraki bir sürüm kullanıyorsanız ve Gerçekçi Dudak Senkronizasyonu Modellerini kullanmayı planlıyorsanız, gerçekçi modellerin doğru çalışmasını engelleyen bir eklenti çakışmasıyla karşılaşırsınız.

Sorun

UE 5.6'dan başlayarak, motor NNERuntimeORT eklentisini içerir ve bu eklenti, Mac ve Linux platformlarında Runtime MetaHuman Lip Sync eklentisinin gerçekçi modelleriyle çakışır. Bu çakışma, gerçekçi dudak senkronizasyonu işlevselliğinin düzgün şekilde başlatılmasını engeller.

Çözüm

Bu çakışmayı çözmek için eklenti yapılandırma dosyasını değiştirmeniz gerekir:

1. Unreal Engine kurulum klasörünüze gidin
2. Engine/Plugins/Marketplace/ yoluna gidin
3. RuntimeMetaHumanLipSync eklenti klasörünü bulun
4. RuntimeMetaHumanLipSync.uplugin dosyasını bir metin düzenleyicide açın
5. Aşağıdaki bölümü tamamen kaldırın:

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

Önemli Notlar

• Bu değişiklik yalnızca Mac ve Linux platformlarını etkiler. Windows kullanıcılarının bu değişikliği yapması gerekmez.
• Bu düzeltme yalnızca UE 5.6 ve sonrası için gereklidir. Önceki motor sürümleri etkilenmez.
• Eklentiyi güncellediğinizde bu işlemi tekrarlamanız gerekebilir, çünkü güncellemeler orijinal yapılandırma dosyasını geri yükleyecektir.