حاويات واجهة المستخدم على الشاشة | المراجع

تحتوي حاوية ScreenGui على GuiObjects لعرضها على شاشة اللاعب، بما في ذلك الإطارات، التسميات، الأزرار، والمزيد. يتم تخزين جميع كائنات واجهة المستخدم على الشاشة وتغييرها على العميل.

مثال على ScreenGui مع أطفال GuiObject مختلفين، بما في ذلك إطار، نص، مربع نص، وزر صورة.

لعرض ScreenGui وأطفاله GuiObjects لكل لاعب ينضم إلى اللعبة، ضعها داخل حاوية StarterGui. عندما ينضم لاعب إلى اللعبة وتظهر شخصيته لأول مرة، يتم استنساخ ScreenGui ومحتوياته إلى حاوية PlayerGui لذلك اللاعب، الموجودة داخل حاوية Players.

مخطط يوضح كيفية استنساخ ScreenGui من StarterGui إلى PlayerGui للاعب

بشكل افتراضي، تظهر GuiObjects داخل ScreenGui ضمن StarterGui كطبقة فوق عرض ثلاثي الأبعاد، مما يحاكي مظهرها وموقعها في لعبة قيد التشغيل. لإخفاء جميع هذه الطبقات على الشاشة، قم بإيقاف تشغيل GUI overlay من أداة خيارات التصور في الزاوية العلوية اليمنى من عرض ثلاثي الأبعاد.

إذا تم تعطيل Players.CharacterAutoLoads، فلن يتم استنساخ محتويات StarterGui حتى يتم استدعاء Player:LoadCharacterAsync().

مع نمو اللعبة في النطاق، قد تحتاج إلى واجهات شاشة متعددة مثل شاشة العنوان، قائمة الإعدادات، واجهة المتجر، والمزيد. في مثل هذه الحالات، يمكنك وضع حاويات ScreenGui فريدة متعددة داخل StarterGui وتبديل خاصية Enabled لكل حاوية حسب ما إذا كان يجب أن تكون مرئية ونشطة (عندما تكون false، لن يتم عرض المحتويات، أو معالجة إدخال المستخدم، أو تحديثها استجابةً للتغييرات).

هيكل مستكشف يظهر عدة حاويات ScreenGui، واحدة مفعلة والأخرى معطلة، من أجل التحكم في أي منها مرئي في وقت معين.

يمكن تبديل خاصية Enabled في البداية من خلال نافذة الخصائص و/أو يمكنك تعيينها أثناء وقت اللعب من خلال نص برمجي على جانب العميل عن طريق الوصول إلى PlayerGui للاعب وتعيينها إلى true أو false للحاوية (الحاويات) المطلوبة.

عند استخدام واجهات ScreenGui متعددة، يمكنك تكديسها حسب ترتيب Z من خلال خاصية DisplayOrder. انظر ترتيب العرض لمزيد من المعلومات.

خصائص الحاوية

تتيح لك الخصائص التالية تخصيص حواف الشاشة عبر أجهزة متعددة، وترتيب العرض عند استخدام حاويات شاشة متعددة، والمزيد.

حواف الشاشة

تستفيد الهواتف الحديثة من الشاشة بأكملها، لكنها غالبًا ما تتضمن نتوءات وفتحات وعناصر أخرى تشغل مساحة الشاشة. تتضمن كل لعبة Roblox أيضًا عناصر تحكم شريط الأعلى للوصول السريع إلى القائمة الرئيسية، الدردشة، لوحة الصدارة، والمزيد.

جهاز محمول يظهر أزرار شريط Roblox العلوية وفتحة الجهاز.

لضمان قدرة اللاعبين على رؤية والوصول إلى جميع واجهات المستخدم بسهولة ودون عوائق، توفر Roblox خاصية ScreenInsets التي تتحكم في مساحات منطقة الأمان لمحتويات ScreenGui.

تضمن القيمة الافتراضية لـ CoreUISafeInsets أن تبقى جميع عناصر GuiObjects الفرعية داخل منطقة الأمان للواجهة الأساسية، بعيدًا عن أزرار شريط الأعلى وغيرها من فتحات الشاشة. يُوصى بهذا الإعداد إذا كانت ScreenGui تحتوي على عناصر واجهة مستخدم تفاعلية.

جهاز محمول يظهر منطقة الأمان للواجهة الأساسية.

ترتيب العرض

عند استخدام واجهات ScreenGui متعددة، يمكنك تكديسها حسب ترتيب Z من خلال خاصية DisplayOrder. على سبيل المثال، لعرض قائمة إعدادات نموذجية على ScreenGui واحدة أمام واجهة المستخدم الرئيسية للعبة على ScreenGui أخرى، قم بتعيين DisplayOrder أعلى للنموذج مقارنةً بواجهة المستخدم الأساسية.

إعادة التعيين عند الظهور

تحدد خاصية ResetOnSpawn البوليانية ما إذا كانت ScreenGui تعيد تعيين نفسها (تحذف نفسها وتستنسخ مرة أخرى إلى PlayerGui للاعب) في كل مرة تعيد فيها شخصية اللاعب الظهور.

الحالة	إعادة التعيين
ResetOnSpawn هو true (افتراضي).	نعم
تكون ScreenGui سليل غير مباشر لـ StarterGui؛ على سبيل المثال، تم وضعها داخل Folder الموجودة داخل StarterGui.	نعم
ResetOnSpawn هو false و ScreenGui هو سليل مباشر لـ StarterGui.	لا

الوصول إلى واجهة المستخدم للاعب

كما هو مذكور، فإن ربط ScreenGui بـ StarterGui يستنسخها وأطفالها GuiObjects إلى حاوية PlayerGui للاعب عندما ينضمون إلى اللعبة وتظهر شخصيتهم لأول مرة.

إذا كنت بحاجة إلى التحكم في حاوية واجهة المستخدم للاعب أثناء وقت اللعب، على سبيل المثال لإظهار/إخفاء ScreenGui معينة أو أي من أطفالها، يمكنك الوصول إليها كما يلي من LocalScript:

LocalScript - الوصول إلى واجهة مستخدم اللاعب

local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui

local titleScreen = playerGui:WaitForChild("TitleScreen")
local settingsMenu = playerGui:WaitForChild("SettingsMenu")

titleScreen.Enabled = false  -- إخفاء شاشة العنوان
settingsMenu.Enabled = true  -- عرض قائمة الإعدادات

تعطيل واجهة المستخدم الافتراضية

تتضمن جميع ألعاب Roblox عدة عناصر واجهة مستخدم مفعلة بشكل افتراضي. إذا كنت لا تحتاج إلى أي من هذه العناصر أو إذا كنت ترغب في استبدالها بإبداعاتك الخاصة، يمكنك استخدام الطريقة SetCoreGuiEnabled() في نص برمجي على جانب العميل مع الخيار المرتبط Enum.CoreGuiType.

واجهة المستخدم الافتراضية	التعداد المرتبط
قائمة Players التي يتم تحديثها ديناميكيًا، تُستخدم عادةً كـ لوحة زعماء.	Enum.CoreGuiType.PlayerList
شريط Health الخاص بالشخصية. لا يظهر إذا كانت Humanoid الخاصة بالشخصية بصحة كاملة.	Enum.CoreGuiType.Health
حقيبة Backpack الخاصة بالشخصية والتي تحتوي على أدوات داخل اللعبة. لا يظهر إذا لم يكن هناك أي Tools في الحقيبة.	Enum.CoreGuiType.Backpack
نافذة الدردشة النصية.	Enum.CoreGuiType.Chat
قائمة منبثقة للشخصية المؤثرات الصوتية.	Enum.CoreGuiType.EmotesMenu
نافذة تعرض منظور اللاعب أو رؤية شخصيته الخاصة. لا تظهر إلا إذا كان اللاعب قد قام بتمكين الرؤية الذاتية من قائمة Roblox.	Enum.CoreGuiType.SelfView
زر التقاط لقطة شاشة على الجانب الأيمن من الشاشة. لا يظهر إلا إذا كان اللاعب قد قام بتمكين التقاطات من قائمة Roblox.	Enum.CoreGuiType.Captures
يمكن لمبدل الصورة الرمزية أن يسمح للمستخدمين بتغيير صورة شخصيتهم على المنصة.	Enum.CoreGuiType.AvatarSwitcher

عناصر واجهة المستخدم الأساسية في كل لعبة Roblox.

نص برمجي عميل - تعطيل عناصر واجهة المستخدم الافتراضية

local StarterGui = game:GetService("StarterGui")

-- تعطيل شريط الصحة الافتراضي والحقيبة
StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.Health, false)
StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.Backpack, false)

بالإضافة إلى ذلك، تتضمن الأجهزة التي تحتوي على قدرات لمسية مفتاح تحكم افتراضي وزر قفز بشكل افتراضي. إذا رغبت في ذلك، يمكنك إخفاء هذه العناصر من خلال تعيين GuiService.TouchControlsEnabled إلى false في نص برمجي على جانب العميل.

عناصر واجهة المستخدم للأجهزة التي تدعم اللمس في كل لعبة Roblox.

نص برمجي عميل - تعطيل عناصر التحكم باللمس

local GuiService = game:GetService("GuiService")

GuiService.TouchControlsEnabled = false