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 gerekecektir.

1. Düzen > Proje Ayarları'na gidin
2. Platformlar > Android'e gidin
3. Platformlar - Android altında, Derleme bölümünde x86_64 [aka 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

Bazı durumlarda Android ve iOS üzerinde, çalışma zamanında (TestFlight testleri 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ısını zorlamanız gerekir:

Unreal Engine 5.5 ve öncesi için:

• Projeniz, kaynak koddan derlenmiş bir motor kullanmalıdır (önceden derlenmiş bir ikili dosya 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 kaynak kodlu 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'i Android ve iOS'ta ANSI ayırıcısını kullanmaya zorlar ve ONNX Runtime tarafından kullanılan ayırıcıyla eşleşir.

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

NNERuntimeORT Eklenti Çakışması

Eğer Mac veya Linux platformlarında Unreal Engine 5.6 veya sonraki bir sürümünü 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şacaksınız.

Sorun

UE 5.6 ile birlikte motor, NNERuntimeORT eklentisini içerir. 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 bir şekilde başlatılmasını engeller.

Çözüm

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

1. Unreal Engine kurulum klasörünüze gidin
2. Engine/Plugins/Marketplace/ konumuna 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ına gerek yoktur.
• Bu düzeltme yalnızca UE 5.6 ve sonraki sürümler için gereklidir. Daha eski motor sürümleri etkilenmez.
• Eklentiyi güncellerseniz bu işlemi tekrarlamanız gerekebilir, çünkü güncellemeler orijinal yapılandırma dosyasını geri yükleyecektir.