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ı

Eğer Android veya Meta Quest platformlarını hedefliyorsanız ve bu eklenti ile derleme hatalarıyla karşılaşıyorsanız, proje ayarlarınızdan x86_64 (x64) Android mimarisini devre dışı bırakmanız gerekecek:

1. Düzenle > Proje Ayarları'na gidin
2. Platformlar > Android bölümüne gidin
3. Platformlar - Android, Derleme bölümü altında, x86_64 [diğer adıyla x64] Desteği'ni bulun ve aşağıda gösterildiği gibi devre dışı bırakıldığından 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

Bazı durumlarda Android ve iOS'ta, ç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 platformlardaki 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 satırı ekleyin:

StaticAllocator = StaticAllocatorType.Ansi;

Bu, Unreal Engine'ı Android ve iOS'ta ONNX Runtime tarafından kullanılan ayırıcıyla eşleşecek şekilde ANSI ayırıcısını kullanmaya 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/ dizinine 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.