إعداد خصائص المواد والقوالب لمواد التشطيب
أنشئ مواد تشطيب بقاعدة لون أو خامة، وأدر قوالب المواد، وارفع الخامات بحيث ترتبط بالمواد بشكل صحيح.
تتيح نافذة Material Properties (المستخدمة عند إنشاء/تعديل مواد التشطيب على SKUs) للمستخدم اختيار خاصية أساس من Color أو Texture. إذا اختير Texture، فيجب رفع صورة فعليًا - وإلا يمنع 'Please upload a texture file' الحفظ؛ والعودة إلى Color تمسح أي خريطة خامة مرفوعة عند الحفظ. تُخزَّن الخامات المرفوعة فورًا عند الاختيار (كل رفع ينشئ أصل خامة)، وتتحكم المنزلقات/الحقول في خصائص بنمط PBR (الخشونة، المعدنية، النفاذية وغيرها؛ بعض الحقول كالمعتمدة على النفاذية تعرض عناصر نائبة حتى تُضبط القيم الممكِّنة). من المفيد معرفة هذه الخصوصية: مفتاح 'lock aspect ratio' لعرض/ارتفاع الخامة يُحفظ في localStorage في المتصفح لكل مادة - ولا يتزامن بين الأجهزة أو المستخدمين، لذا قد تختلف حالة المفتاح بين الحواسيب. تُدار Material Templates (إعدادات مسبقة مسماة لهذه الخصائص) بشكل منفصل: اسم القالب إلزامي ('Material Template name cannot be empty')، ويمكن تحديث القوالب أو إضافتها، ويُعيد إجراء الاسترجاع القيم المعدَّلة إلى القيم المخزنة في القالب. تهم القوالب في الإنشاء الجماعي عبر CSV لـ Finish/panel-core SKUs، حيث يجب أن يشير material_template_id إلى قالب موجود من ورقة المرجع.
✓ تم التحقق منه في المنتج في 18 أكتوبر 2026عندما تكون الخاصية الأساس هي Texture، يوفّر محرر المواد أيضًا خانات اختيارية لخريطة النتوء وخريطة السطح الطبيعي إضافة إلى الخامة الأساس، بحيث يمكن إضافة العمق فوق الخامة المرفوعة.
✓ تم التحقق منه في المنتج في 18 أكتوبر 2026يحدد القالب خصائص العرض التي يستخدمها التشطيب.
✓ تم التحقق منه في المنتج في 18 أكتوبر 2026عند إنشاء مادة أو تحديثها (عبر الواجهة أو enterprise API)، يُتحقق من JSON خصائصها مقابل قالب المادة المرتبط: يحدد القالب المجموعة الدقيقة لأسماء الخصائص المسموح بها (اللون، العتامة، الخشونة، المعدنية، خانات خريطة الخامة، وغيرها). أي مفتاح غير معرَّف في القالب يجعل الحفظ يفشل بالخطأ PROPERTY_KEY_MISMATCH_WITH_MATERIAL_TEMPLATE_PROPERTY. المفاتيح الناقصة لا تُفحص — يمكن حفظ مادة بمجموعة جزئية من خصائص القالب دون أي تحذير. الفشل الكلاسيكي هو أن يعيد العميل استخدام حمولة خصائص كُتبت لقالب ما بينما يمرر material_template_id مختلفًا: فالمفاتيح الصالحة للقالب القديم تُرفض مقابل القالب الجديد. ومن آليات API التي تربك الناس أيضًا: يجب إرسال الخصائص ككائن JSON نصي — فالسلسلة غير القابلة للتحليل تفشل بالخطأ MATERIAL_CREATION_FAILURE (أو MATERIAL_UPDATE_FAILURE)، وإرسال مصفوفة بدل كائن يفشل بالخطأ INVALID_PARAMS. وإذا لم يكن material_template_id موجودًا أصلًا فالخطأ هو MATERIAL_TEMPLATE_NOT_FOUND. عندما يبلّغ العميل عن أحد هذه الأخطاء، اطلب منه جلب القالب وسرد تسميات خصائصه وتقليم حمولته إلى تلك المفاتيح بالضبط.
تُرفع الخامات كـ form-data بحقلين، file و name؛ والصيغ المدعومة هي jpeg وjpg وpng. ينشئ الرفع سجل صورة وسجل خامة يشير إليه، ويعيد الاستجابة الخامة مع صورتها مضمّنة. الأذونات: يتطلب الرفع حقوق مدير كتالوج على المتجر أو وحدة الأعمال، لكن يُسمح للمصممين صراحةً أيضًا — يمكن للمصمم إضافة خامات من تطبيق التصميم حتى دون حقوق إدارة الكتالوج. لاستخدام خامة في مادة، يوضع معرّفها في خاصية 'map' للمادة. تُتحقق فقط من خريطة الأساس هذه عند حفظ المادة: إذا لم يقابل معرّف الخريطة خامة موجودة، يفشل الحفظ (MATERIAL_CREATION_FAILURE / MATERIAL_UPDATE_FAILURE)، وعند النجاح تصبح صورة الخامة تلقائيًا عيّنة عرض المادة. أما خانات الخرائط الأخرى — خرائط normal وambient occlusion وbump وmetalness وroughness — فتقبل معرّفات خامات لكنها لا تُفحص من حيث الوجود عند الحفظ، لذا يُحفظ معرّف خاطئ فيها دون أي خطأ ويفشل ببساطة في الحل لاحقًا. إذا قال العميل إن خريطة normal أو roughness لديه 'does nothing'، فتحقق من أن المعرّف يشير إلى خامة حقيقية قبل تشخيص العرض.