ตัวเก็บ ScreenGui จะเก็บ GuiObjects เพื่อแสดงบนหน้าจอของผู้เล่น รวมถึง กรอบ, ป้าย, ปุ่ม และอื่นๆ วัตถุ UI บนหน้าจอทั้งหมดและโค้ดจะถูกเก็บและเปลี่ยนแปลงที่ฝั่งลูกค้า
สำหรับตัวเก็บ UI ที่เก็บ GuiObjects ที่คุณต้องการแสดง ภายใน โลก 3D เช่น บนหน้าของชิ้นส่วน ให้ดูที่ ตัวเก็บ UI ในเกม.
เพื่อแสดง ScreenGui และลูกของ GuiObjects ให้กับผู้เล่นทุกคนที่เข้าร่วมเกม ให้วางมันไว้ภายในตัวเก็บ StarterGui เมื่อผู้เล่นเข้าร่วมเกมและตัวละครของพวกเขาเกิดขึ้นครั้งแรก ScreenGui และเนื้อหาของมันจะถูกโคลนไปยังตัวเก็บ PlayerGui สำหรับผู้เล่นนั้น ซึ่งตั้งอยู่ภายในตัวเก็บ Players
ตามค่าเริ่มต้น GuiObjects ภายใน ScreenGui ใน StarterGui จะปรากฏเป็นการซ้อนทับของ มุมมอง 3D โดยจำลองลักษณะและตำแหน่งของพวกเขาในเกมที่กำลังทำงานอยู่ เพื่อซ่อนการซ้อนทับบนหน้าจอทั้งหมด ให้ปิด GUI overlay จาก ตัวเลือกการแสดงผล ในมุมขวาบนของมุมมอง 3D
หาก Players.CharacterAutoLoads ถูกปิด เนื้อหาของ StarterGui จะไม่ถูกโคลนจนกว่า Player:LoadCharacterAsync() จะถูกเรียก
เมื่อเกมขยายขอบเขต คุณอาจต้องการอินเทอร์เฟซหน้าจอหลายแบบ เช่น หน้าจอชื่อ, เมนูการตั้งค่า, อินเทอร์เฟซร้านค้า และอื่นๆ ในกรณีเช่นนี้ คุณสามารถวางตัวเก็บ ScreenGui ที่ไม่ซ้ำกันหลายตัวภายใน StarterGui และเปิด/ปิดคุณสมบัติ Enabled ของแต่ละตัวเก็บขึ้นอยู่กับว่ามันควรจะแสดงและทำงานหรือไม่ (เมื่อ false เนื้อหาจะไม่เรนเดอร์, ประมวลผลการป้อนข้อมูลของผู้ใช้, หรืออัปเดตตามการเปลี่ยนแปลง)
คุณสมบัติ Enabled สามารถเปิดหรือปิดได้ในตอนเริ่มต้นผ่านหน้าต่าง คุณสมบัติ และ/หรือคุณสามารถตั้งค่าในระหว่างเวลาเล่นจากสคริปต์ฝั่งลูกค้าโดย เข้าถึง PlayerGui ของผู้เล่นและตั้งค่าเป็น true หรือ false สำหรับตัวเก็บที่ต้องการ
เมื่อใช้หลายอินเทอร์เฟซ ScreenGui คุณสามารถจัดเรียงพวกเขาโดย Z‑index ผ่านคุณสมบัติ DisplayOrder ดูที่ ลำดับการแสดงผล สำหรับข้อมูลเพิ่มเติม
คุณสมบัติของตัวเก็บ
คุณสมบัติต่อไปนี้ช่วยให้คุณปรับแต่ง ขอบหน้าจอ ข้ามอุปกรณ์หลายเครื่อง, ลำดับการแสดงผล เมื่อใช้ตัวเก็บหน้าจอหลายตัว, และอื่นๆ
ขอบหน้าจอ
Modern phones take advantage of the entire screen but typically include notches, cutouts, and other elements that occupy screen space. Every Roblox game also includes the top bar controls for quick access to the main menu, chat, leaderboard, and more.
To ensure players can see and access all UI easily and without obstruction, Roblox provides the ScreenInsets property which controls the safe area insets for the contents of a ScreenGui.
The default of CoreUISafeInsets keeps all descendant GuiObjects inside the core UI safe area, clear of the top bar buttons and other screen cutouts. This setting is recommended if the ScreenGui contains interactive UI elements.
ลำดับการแสดงผล
เมื่อใช้หลายอินเทอร์เฟซ ScreenGui คุณสามารถจัดเรียงพวกเขาโดย Z‑index ผ่านคุณสมบัติ DisplayOrder ตัวอย่างเช่น เพื่อแสดงเมนูการตั้งค่าที่เป็นโมดัลบน ScreenGui หนึ่งตัวข้างหน้าของอินเทอร์เฟซผู้ใช้หลักของเกมบน ScreenGui อีกตัว ให้กำหนด DisplayOrder ที่สูงกว่าสำหรับโมดัลมากกว่าที่อยู่เบื้องล่าง
รีเซ็ตเมื่อเกิด
คุณสมบัติ boolean ResetOnSpawn กำหนดว่าตัวเก็บ ScreenGui จะรีเซ็ต (ลบตัวเองและโคลนใหม่ไปยัง PlayerGui ของผู้เล่น) ทุกครั้งที่ตัวละครของผู้เล่นเกิดใหม่หรือไม่
| เงื่อนไข | รีเซ็ต |
|---|---|
| ResetOnSpawn เป็น true (ค่าเริ่มต้น). | ใช่ |
| ตัวเก็บ ScreenGui เป็นลูกหลาน ทางอ้อม ของ StarterGui; ตัวอย่างเช่น มันถูกวางไว้ภายใน Folder ที่ตั้งอยู่ภายใน StarterGui. | ใช่ |
| ResetOnSpawn เป็น false และ ตัวเก็บ ScreenGui เป็นลูกหลาน โดยตรง ของ StarterGui. | ไม่ |
เข้าถึง UI ของผู้เล่น
ตามที่ได้กล่าวไว้ การตั้งค่าตัวเก็บ ScreenGui ให้เป็น StarterGui จะทำให้มันและลูกของ GuiObjects ถูกโคลนไปยังตัวเก็บ PlayerGui ของผู้เล่นเมื่อพวกเขาเข้าร่วมเกมและตัวละครของพวกเขาเกิดขึ้นครั้งแรก
หากคุณต้องการควบคุมตัวเก็บ UI ของผู้เล่นในระหว่างเวลาเล่น เช่น เพื่อแสดง/ซ่อน ScreenGui เฉพาะหรือใดๆ ของลูกของมัน ให้เข้าถึงมันดังนี้จาก 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 -- แสดงเมนูการตั้งค่าปิด UI เริ่มต้น
ทุกเกมของ Roblox จะมีองค์ประกอบ UI หลายอย่างที่เปิดใช้งานโดยค่าเริ่มต้น หากคุณไม่ต้องการองค์ประกอบใด ๆ เหล่านี้หรือหากคุณต้องการแทนที่ด้วยการสร้างของคุณเอง คุณสามารถใช้วิธี SetCoreGuiEnabled() ในสคริปต์ฝั่งไคลเอ็นต์พร้อมกับตัวเลือก Enum.CoreGuiType ที่เกี่ยวข้อง
| UI เริ่มต้น | อีนัมที่เกี่ยวข้อง |
|---|---|
| รายการ 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 |
| Avatar Switcher ช่วยให้ผู้ใช้สามารถเปลี่ยนภาพอวตาร์ของแพลตฟอร์มได้ | Enum.CoreGuiType.AvatarSwitcher |
local StarterGui = game:GetService("StarterGui")
-- ปิดใช้งานแถบสุขภาพและกระเป๋า
StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.Health, false)
StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.Backpack, false)นอกจากนี้ อุปกรณ์ที่มีความสามารถในการสัมผัสยังมีลูกศรเสมือนและปุ่มกระโดดโดยค่าเริ่มต้น หากต้องการ คุณสามารถซ่อนองค์ประกอบเหล่านี้โดยการตั้งค่า GuiService.TouchControlsEnabled เป็น false ในสคริปต์ฝั่งไคลเอ็นต์
local GuiService = game:GetService("GuiService")
GuiService.TouchControlsEnabled = false