Ana içeriğe geç

Platform'a Özel Yapılandırma

Bu kılavuz, Runtime Text To Speech eklentisi için platforma özel kurulum gereksinimlerini ve yapılandırmalarını kapsar.

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 kaynak koddan 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şen 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, gerçekçi modellerin düzgün çalışmasını engelleyen bir eklenti çakışmasıyla karşılaşacaksınız.

Sorun​

UE 5.6'dan başlayarak, motor Mac ve Linux platformlarında Runtime MetaHuman Lip Sync eklentisinin gerçekçi modelleriyle çakışan NNERuntimeORT eklentisini içerir. 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. RuntimeTextToSpeech eklenti klasörünü bulun
  4. RuntimeTextToSpeech.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.