انتقل إلى المحتوى الرئيسي

التكوين الخاص بالمنصة

يغطي هذا الدليل متطلبات الإعداد والتكوينات الخاصة بالمنصة لإضافة Runtime MetaHuman Lip Sync.

تكوين Android / Meta Quest​

إذا كنت تستهدف منصات Android أو Meta Quest وواجهت أخطاء في بناء هذه الإضافة، فستحتاج إلى تعطيل بنية Android x86_64 (x64) في إعدادات مشروعك:

  1. انتقل إلى Edit > Project Settings
  2. انتقل إلى Platforms > Android
  3. ضمن Platforms - Android، قسم Build، ابحث عن Support x86_64 [aka x64] وتأكد من تعطيله، كما هو موضح أدناه

تعطيل بنية Android x64

هذا لأن الإضافة تدعم حاليًا فقط بنى arm64-v8a و armeabi-v7a لمنصات Android / Meta Quest.

أعطال Android و iOS​

في بعض الحالات على Android و iOS، قد تحدث أعطال أثناء وقت التشغيل (مثل أثناء اختبار TestFlight). يحدث هذا بسبب تعارض متطلبات تخصيص الذاكرة لمكتبة ONNX Runtime الأساسية مع المخصصات الافتراضية لمحرك Unreal Engine على هذه المنصات.

لحل هذه المشكلة، تحتاج إلى فرض المخصص ANSI في ملف Target.cs الخاص بمشروعك:

لـ Unreal Engine 5.5 والإصدارات السابقة:

  • يجب أن يستخدم مشروعك محركًا مبنيًا من المصدر (وليس ثنائيًا مسبق التجميع)
  • أضف السطر التالي إلى ملف Target.cs الخاص بك:
GlobalDefinitions.Add("FORCE_ANSI_ALLOCATOR=1");

لـ Unreal Engine 5.6 والإصدارات الأحدث:

  • يعمل مع كل من إصدارات المحرك المبنية من المصدر والمترجمة مسبقًا
  • أضف السطر التالي إلى ملف Target.cs الخاص بك:
StaticAllocator = StaticAllocatorType.Ansi;

هذا يجبر محرك Unreal Engine على استخدام المخصص ANSI على Android و iOS، ليطابق المخصص المستخدم من قبل ONNX Runtime.

تكوين Mac / Linux (UE 5.6+)​

NNERuntimeORT Plugin Conflict

إذا كنت تستخدم Unreal Engine 5.6 أو أحدث على منصات Mac أو Linux وتخطط لاستخدام Realistic Lip Sync Models، فستواجه تعارضًا في الإضافات يمنع النماذج الواقعية من العمل بشكل صحيح.

المشكلة​

بدءًا من UE 5.6، يتضمن المحرك إضافة NNERuntimeORT، التي تتعارض مع النماذج الواقعية لإضافة Runtime MetaHuman Lip Sync على منصات Mac و Linux. يمنع هذا التعارض وظيفة مزامنة الشفاه الواقعية من التهيئة بشكل صحيح.

الحل​

لحل هذا التعارض، تحتاج إلى تعديل ملف تكوين الإضافة:

  1. انتقل إلى مجلد تثبيت Unreal Engine الخاص بك
  2. اذهب إلى Engine/Plugins/Marketplace/
  3. ابحث عن مجلد إضافة RuntimeMetaHumanLipSync
  4. افتح ملف RuntimeMetaHumanLipSync.uplugin في محرر نصوص
  5. احذف القسم التالي بالكامل:
,
  "Plugins": [
    {
      "Name": "NNERuntimeORT",
      "Enabled": true
    }
  ]

ملاحظات هامة​

  • هذا التعديل يؤثر فقط على منصات Mac و Linux. مستخدمي Windows لا يحتاجون إلى إجراء هذا التغيير.
  • هذا الإصلاح مطلوب فقط لمحرك UE 5.6 والإصدارات اللاحقة. إصدارات المحرك السابقة لا تتأثر.
  • قد تحتاج إلى تكرار هذه العملية إذا قمت بتحديث البرنامج المساعد، حيث أن التحديثات ستعيد ملف التكوين الأصلي.