تحتوي حاويات واجهة المستخدم داخل التجربة على GuiObjects التي ترغب في عرضها داخل عالم تجربتك ثلاثي الأبعاد.
- توفر SurfaceGui إمكانية عرض عناصر واجهة المستخدم على سطح جزء في العالم ثلاثي الأبعاد مع السماح بإجراء تفاعلات أساسية من المستخدم.
- BillboardGui هي حاوية لعناصر واجهة المستخدم لتظهر في الفضاء ثلاثي الأبعاد ولكن دائماً تتجه نحو الكاميرا.
واجهة مستخدم السطح
مماثلة لـ Decals و Textures، تظهر عناصر واجهة المستخدم مثل TextLabels و ImageLabels المتصلة بـ SurfaceGui في نفس اتجاه السطح الذي توجد عليه، ويمكن تعديلها عبر خاصية SurfaceGui.Face.
لتطبيق SurfaceGui على BasePart داخل التجربة، ببساطة قم بربطها بذلك الجزء وضبط خاصية SurfaceGui.Face. ستظهر عناصر واجهة المستخدم الفرعية بعد ذلك على ذلك الوجه من الجزء الأب.
بدلاً من ذلك، يمكنك وضع SurfaceGui داخل حاوية مثل StarterGui ثم ضبط خاصية Adornee إلى أي BasePart، بالإضافة إلى الوجه المستهدف Face. يوفر ضبط Adornee مرونة أكبر في الموضع، حيث يمكن ضبطه من برنامج نصي أثناء وقت التشغيل.
ستتلقى عناصر واجهة المستخدم التفاعلية مثل ImageButtons و TextButtons داخل SurfaceGui إدخال المستخدم فقط إذا كانت متصلة بـ PlayerGui للاعب، عادةً عن طريق وضع SurfaceGui داخل StarterGui كما هو ملاحظ أعلاه. بالإضافة إلى ذلك، يجب أن تكون خاصية CanQuery للجزء true حتى تتلقى عناصر واجهة المستخدم التفاعلية إدخال.
لمساعدتك في اختيار الوجه الصحيح لـ SurfaceGui، انقر بزر الماوس الأيمن على الجزء الهدف واختر عرض مؤشر الاتجاه. سيظهر ذلك دائرة زرقاء تحتوي على F وخط متصل بوجه الكائن Front، وسهم أخضر يشير في اتجاه وجه الكائن Top.
الحجم والموقع
يشغل "القماش" الخاص بـ SurfaceGui الوجه بأكمله من Face للجزء الأب أو Adornee. كأفضل ممارسة، يُوصى باستخدام قيم نسبة لـ الحجم و الموقع لعناصر واجهة المستخدم الفرعية مثل ImageLabels. يمكنك أيضًا تطبيق UIAspectRatioConstraint على الأطفال من SurfaceGui للحفاظ على نسبة العرض إلى الارتفاع المرغوبة بغض النظر عن حجم الوجه.
وضع التعتيم
تتحكم خاصية AlwaysOnTop فيما إذا كانت SurfaceGui ستظهر فوق محتوى ثلاثي الأبعاد أو يتم حجبها عنه. عند تعيينها إلى false (الإعداد الافتراضي)، تظهر SurfaceGui مثل بقية المحتويات ثلاثية الأبعاد وتتم حجبها بواسطة الأجسام ثلاثية الأبعاد الأخرى. عند تعيينها إلى true، تظهر دائماً فوق محتوى ثلاثي الأبعاد ولا تتأثر بـ السطوع/الضوء في البيئة ثلاثية الأبعاد.
تأثير السطوع والضوء
يعمل كل من Brightness و LightInfluence معًا لتحديد كيفية تأثير الضوء البيئي على محتوى واجهة المستخدم في SurfaceGui.
تحدد Brightness العامل الذي يتم من خلاله توسيع الضوء المنبعث في نطاق من 0 إلى 1000، مما يسمح لك بضبط SurfaceGui وفقًا لبيئتها. على سبيل المثال، يمكن Brightening لافتة فيديو داخل غرفة مظلمة عن طريق زيادة Brightness إلى 10.
تتحكم LightInfluence في مدى تأثير الإضاءة في المكان على SurfaceGui، في نطاق من 0 إلى 1. تعيين ذلك إلى 1 يعني أن الإضاءة المحيطة تتحكم تمامًا في المظهر، بينما تعيينه إلى 0 يعني أن الإضاءة ليس لها تأثير.
يرجى ملاحظة أن Brightness غير متاحة في الاستوديو وليس لها تأثير عندما تكون either LightInfluence تساوي 1 أو AlwaysOnTop تساوي true.
رؤية المسافة
تتحكم MaxDistance في مدى بُعد الكاميرا قبل أن يتوقف عرض SurfaceGui. قيمة 0 تعني عدم وجود حد وستظهر indefinitely بعيدًا. القيمة الافتراضية 1000 تعمل بشكل جيد في معظم الحالات.
بالنسبة لـ SurfaceGuis التي تظهر في الهواء الطلق، يُوصى بأن تكون MaxDistance مرتفعة بما يكفي لضمان أن واجهة المستخدم للحاوية صغيرة بما فيه الكفاية على الشاشة عند الظهور أو الاختفاء، مما يقلل من تأثير البروز المفاجئ.
ترتيب العرض
إذا كانت هناك عدة حاويات SurfaceGui موجودة على نفس الوجه، يمكنك تكديسها حسب ترتيب Z من خلال خاصية ZOffset (تغيير ذلك لا يظهر بصريًا "يرتفع" أو "ينحدر" الحاوية من السطح).
واجهة مستخدم الإعلانات
تعرض حاوية BillboardGui عناصر واجهة المستخدم في الفضاء ثلاثي الأبعاد ولكن، على عكس SurfaceGui، دائمًا ما تتجه أطفال BillboardGui نحو الكاميرا. هذه الحاوية مفيدة لعرض المعلومات الأمامية فوق الكائنات داخل التجربة مثل مقاييس الصحة أو الأسماء فوق شخصيات اللاعبين، وعلامات لإرشاد اللاعبين إلى كائن في العالم ثلاثي الأبعاد، وأكثر من ذلك.
لربط BillboardGui بـ BasePart داخل التجربة أو بـ Attachment، ببساطة قم بربطها لذلك الجزء أو المرفق وإذا رغبت، قم بتعديل الحجم/الموقع.
بدلاً من ذلك، يمكنك وضع BillboardGui داخل حاوية مثل StarterGui ثم ضبط خاصية Adornee إلى أي BasePart أو Attachment. توفر هذه الطريقة المزيد من المرونة في الموضع نظرًا لأنه يمكن ضبط Adornee من برنامج نصي أثناء وقت التشغيل، على سبيل المثال لوضع BillboardGui فوق رأس شخصيات اللاعب خلال وقت التشغيل.
ستتلقى عناصر واجهة المستخدم التفاعلية مثل ImageButtons و TextButtons داخل BillboardGui إدخال المستخدم فقط إذا كانت متصلة بـ PlayerGui للاعب، عادةً عن طريق وضع BillboardGui داخل StarterGui كما هو ملاحظ أعلاه.
الحجم والموقع
للحجم في الإعلانات، تحدد مكونات النسبة الخاصية Size حجم الإعلانات في الفضاء ثلاثي الأبعاد. على سبيل المثال، تؤدي إعداد {10, 0},{2, 0} (UDim2.fromScale(10, 2)) إلى تشكيل علامة إعلانات بنسبة عرض إلى ارتفاع تبلغ 10:2 التي تتوسع أو تتقلص اعتمادًا على مسافتها من الكاميرا.
للموقع، تعمل خاصية StudsOffset على تحريك اللوحة الإعلانات على المحور X (يسار/يمين)، والمحور Y (أعلى/أسفل)، والمحور Z (أمام/خلف) بالنسبة للكاميرا.
عند إنشاء BillboardGui مع مقاس مضاعف يحتوي على TextLabel، من المفيد تمكين خاصية TextScaled للعلامة بحيث يتسق نصها مع اللوحة الإعلانات مع تغير مسافة الكاميرا.
وضع التعتيم
تتحكم خاصية AlwaysOnTop فيما إذا كانت BillboardGui ستظهر فوق محتوى ثلاثي الأبعاد أو يتم حجبها عنه. عند تعيينها إلى false (الإعداد الافتراضي)، تظهر BillboardGui مثل بقية المحتويات ثلاثية الأبعاد وتتم حجبها بواسطة الأجسام ثلاثية الأبعاد الأخرى. عند تعيينها إلى true، تظهر دائماً فوق محتوى ثلاثي الأبعاد ولا تتأثر بـ السطوع/الضوء في البيئة ثلاثية الأبعاد.
تأثير السطوع والضوء
يعمل كل من Brightness و LightInfluence معًا لتحديد كيفية تأثير الضوء البيئي على محتوى واجهة المستخدم في BillboardGui.
تحدد Brightness العامل الذي يتم من خلاله توسيع الضوء المنبعث في نطاق من 0 إلى 1000، مما يسمح لك بضبط BillboardGui وفقًا لبيئتها. على سبيل المثال، يمكن Brightening للافتة فيديو داخل غرفة مظلمة عن طريق زيادة Brightness إلى 10.
تتحكم LightInfluence في مدى تأثير الإضاءة في المكان على BillboardGui، في نطاق من 0 إلى 1. تعيين ذلك إلى 1 يعني أن الإضاءة المحيطة تتحكم تمامًا في المظهر، بينما تعيينه إلى 0 يعني أن الإضاءة ليس لها تأثير.
يرجى ملاحظة أن Brightness غير متاحة في الاستوديو وليس لها تأثير عندما تكون either LightInfluence تساوي 1 أو AlwaysOnTop تساوي true.
رؤية المسافة
تتحكم MaxDistance في مدى بُعد الكاميرا قبل أن يتوقف عرض BillboardGui. قيمة 0 أو inf (الإعداد الافتراضي) تعني عدم وجود حد وستظهر indefinitely بعيدًا.