دليل استيراد محتوى Datasmith وتحديثه في Unreal Engine

ما الذي ستتعلمه في هذا الدليل؟

يُستخدم Datasmith لنقل المحتوى من تطبيقات تصميم ثلاثية الأبعاد أو تنسيقات ملفات مدعومة إلى Unreal Engine. يشرح هذا الدليل كيفية إضافة محتوى Datasmith إلى مشروع، وتحديثه عبر إعادة الاستيراد عند تغيّر الملف المصدر، وتطبيق هذه التحديثات على العناصر الموجودة في Level الحالي. كما يتناول طريقة تحديث أصول Static Mesh وMaterial وTexture كلٌّ على حدة، بدلًا من تحديث المشهد بأكمله.

من المهم في سير العمل فهم العلاقة بين أصل Datasmith Scene المُنشأ من الملف المصدر وDatasmith Scene Actor الموجود في Level. قد تؤدي إعادة الاستيراد إلى تحديث أصول المشروع، أما تطبيق التغييرات على العناصر الموجودة في المشهد فيعتمد على إعدادات المزامنة المختارة أثناء إعادة الاستيراد. ويساعد التعامل مع هذين الأمرين كلٌّ على حدة في التحكم بنطاق التحديث.

المتطلبات

قبل البدء، افتح المشروع المطلوب استخدامه في Unreal Editor وتأكد من تفعيل إضافة Datasmith Importer. إذا لم تكن الإضافة مفعّلة، فلن تظهر خيارات استيراد Datasmith. وقد تكون بعض إضافات Datasmith مفعّلة افتراضيًا إذا أُنشئ المشروع باستخدام أحد القوالب Architecture أو Automotive, Product Design, and Manufacturing. ومع ذلك، تحقّق من توفر الخيار المطلوب.

قد تتطلب بعض تنسيقات الملفات المصدرية إضافات أو برامج إضافية. ومن الأمثلة الواردة في وثائق Epic Games ملفات .wire، التي تتطلب تثبيت إصدار من Autodesk Alias AutoStudio متوافق مع الملف المصدر. كما تختلف المتطلبات الخاصة بالتنسيقات والتطبيقات الأخرى بحسب نوع المصدر. ولأن الأدلة المصدرية لا تحدد متطلبات إصدار معيّن من Unreal Engine أو متطلبات حساب، لا تُضاف هنا أي شروط للإصدار أو الحساب.

إذا كنت ستضيف المحتوى إلى Level موجود، فافتحه مسبقًا. ويمكنك إنشاء Level جديد لمشهد منفصل أو استخدام Level الافتراضي.

استيراد محتوى Datasmith

1. افتح المشروع المستهدف في Unreal Editor. افتح Level الموجود الذي سيُضاف إليه المحتوى؛ وإن لم يكن موجودًا، فأنشئ Level جديدًا أو استخدم Level الافتراضي.

2. افتح قائمة Create في شريط الأدوات الرئيسي، ثم اختر Datasmith > File Import. حدّد الملف المصدر في نافذة الملفات واضغط على Open.

3. اختر الموقع الذي سيُخزَّن فيه المحتوى داخل المشروع، ثم انقر على OK. لإنشاء مجلد رئيسي جديد، انقر بزر الفأرة الأيمن على مساحة فارغة في نافذة الملفات. ولإنشاء مجلد فرعي داخل مجلد موجود، انقر بزر الفأرة الأيمن على المجلد المعني.

4. في نافذة Datasmith Import Options، حدّد أنواع المحتوى المطلوب استيرادها من الملف المصدر، وراجع إعدادات الاستيراد الأخرى. قد تختلف الخيارات بحسب تنسيق الملف، لذا لا تفترض أن الإعدادات نفسها متاحة لكل مصدر.

5. بعد ضبط الإعدادات، اضغط على Import. يعالج Datasmith الملف المصدر، وينشئ أصولًا جديدة في المشروع، ويضع Datasmith Scene في Level المفتوح.

إذا دعت الحاجة إلى تخصيص عملية الاستيراد، يمكن استخدام البرمجة المرئية عبر Blueprints أو نصوص Python. كما يتيح Dataprep تطبيق عمليات إضافية أثناء الاستيراد، ويمكن حفظ الوصفات وإعادة استخدامها. هذه خيارات لتخصيص العملية وليست خطوات إلزامية لنقل الملفات الأساسي.

تحديث المشهد عند تغيّر الملف المصدر

إذا حفظت التغييرات التي أجريتها على المشهد المصدر في الملف نفسه الموجود على القرص، فانقر بزر الفأرة الأيمن على أصل Datasmith Scene في Content Browser واختر Reimport. أما إذا كانت التغييرات محفوظة في ملف مختلف، فاختر Reimport With New File وحدّد الملف الجديد.

تظهر أثناء إعادة الاستيراد خيارات مشابهة لتلك المستخدمة في الاستيراد الأول. ويحدد قسم Sync Current Level Actors، إضافةً إلى ذلك، ما إذا كانت التغييرات التي أُدخلت على أصل Datasmith Scene المحدّث ستُطبّق على عناصر Datasmith Scene Actor المقابلة في Level المفتوح. اضبط الخيارات ثم اضغط على Import.

قد تغيّر إعادة الاستيراد هندسة Static Mesh وأصول Parent Materials وTexture في Content Browser. لذلك، لا تتعامل معها باعتبارها مجرد تحديث لمظهر المشهد؛ فقد تتأثر الأصول الموجودة في المشروع أيضًا. راجع نطاق التغييرات المصدرية وخيارات المزامنة قبل البدء.

لمزامنة العناصر أثناء إعادة الاستيراد، افتح Level المعني، وأعِد استيراد أصل Datasmith Scene، ثم حدّد مربع Datasmith Scene Actors في قسم Sync Current Level Actors ضمن نافذة Import Options. وإذا كان يلزم أيضًا إعادة العناصر التي سبق حذفها إلى Level، فعّل خيار Re-Spawn Deleted Actors.

يمكن إجراء المزامنة لاحقًا أيضًا. افتح Level المعني، ثم حدّد Datasmith Scene Actor من Outliner. في قسم Datasmith ضمن لوحة Details، اضغط على زر Update actors from Scene. إذا أردت استعادة العناصر المحذوفة، فعّل خيار Respawn deleted actors قبل تنفيذ العملية.

تحديث الأصول واحدًا تلو الآخر

يمكنك تحديث الأصول الفردية بدلًا من إعادة استيراد Datasmith Scene بالكامل. انقر بزر الفأرة الأيمن على أصل Static Mesh أو Material أو Texture المعني في Content Browser، ثم اختر Reimport. يظهر خيار Datasmith > Reimport Material لأصول Material التي أنشأها Datasmith من الصفر بما يتوافق مع تعريف المادة في الملف المصدر. ووفقًا للدليل المصدر، ينطبق ذلك عادةً على Parent Materials المستوردة من 3ds Max؛ وقد لا يتوفر الخيار في Material instances المستندة إلى مواد Datasmith المضمّنة.

عند إعادة استيراد أصل فردي، تظهر نافذة للإعدادات، لكن العملية لا توفر خيارًا لمزامنة عناصر Level. ومع ذلك، تستخدم مراجع الأصول في المشروع الإصدار الجديد من الأصل المحدّث تلقائيًا. وهذا يعني أن إعادة استيراد أصل فردي لا توفر خيار مزامنة العناصر، لا أن تحديث مراجع الأصول يتطلب خطوة مزامنة إضافية.

أخطاء شائعة وخطوات تالية

• إذا لم تظهر خيارات Datasmith، فتحقق أولًا من تفعيل إضافة Datasmith Importer في المشروع.

• إذا كان التحديث سيُجرى من ملف مصدر مختلف، فاستخدم Reimport With New File بدلًا من Reimport.

• لا تخلط بين إعادة الاستيراد ومزامنة عناصر Level؛ تحقّق من خيار Sync Current Level Actors.

• تذكّر أن إعادة استيراد أصل فردي لا تتيح خيار مزامنة عناصر Level، بينما تستخدم مراجع الأصول الإصدار المحدّث تلقائيًا.

• ضع في الحسبان أن إعادة الاستيراد قد تؤثر في هندسة Static Mesh وأصول Parent Materials وTexture.

في سير عمل الهندسة المعمارية والتصميم الداخلي والتصور المعماري، يمكن استخدام Datasmith لاستيراد المحتوى من مصدر تصميم مدعوم إلى مشروع Unreal Engine ونقل التغييرات التي تطرأ على المشهد المصدر إلى المشروع. ومن المهم تحديد ما إذا كانت التغييرات ستُطبّق على المشهد كله أم على أصول محددة فقط. ويمكن للفرق الاتفاق على توقيت مزامنة عناصر المشهد وما إذا كان ينبغي استعادة العناصر المحذوفة.

بما أن الوثائق المصدرية لا تتضمن معلومات عن متطلبات الأجهزة أو رسوم الترخيص، فلا ينبغي افتراض أي شيء بشأن هذه المسائل. تحقّق قبل البدء من دعم تنسيق الملف المصدر، ومن تثبيت أي برنامج إضافي مطلوب، ومن تفعيل إضافات المشروع. ويمكنك بعد ذلك مراجعة الشروحات الخاصة بخيارات Datasmith Import Options لتنسيق الملف المستخدم، أو استكشاف تخصيصات Blueprints أو Python أو Dataprep للعمليات المتكررة.

المصدر والترخيص

أُعدّ هذا الدليل بالاستناد إلى دليلي Epic Games: “Importing Datasmith Content into Unreal Engine” و“Reimporting Datasmith Content into Unreal Engine”. وقد أُشير إلى أن الترخيص في كلا المصدرين متاح مجانًا.