คอนเทนเนอร์ UI ในประสบการณ์เก็บ GuiObjects ที่คุณต้องการแสดงภายในโลก 3D ของประสบการณ์ของคุณ
- A SurfaceGui ช่วยให้สามารถเรนเดอร์ไอเทม UI บนพื้นผิวของชิ้นส่วนในโลก 3D โดยยังอนุญาตให้การโต้ตอบของผู้ใช้พื้นฐานเกิดขึ้นได้
- A BillboardGui เป็นคอนเทนเนอร์สำหรับวัตถุ UI ที่จะปรากฏในพื้นที่ 3D แต่เสมอสู่กล้อง
UI พื้นผิว
คล้ายกับ และ , วัตถุ UI เช่น และ ถูกผูกกับใบหน้าเดียวกันกับพื้นผิวที่พวกเขาอยู่ สามารถแก้ไขได้ผ่านคุณสมบัติ
เพื่อใช้ SurfaceGui กับประสบการณ์ในเวลาจริง BasePart เพียงแค่ส่งมันไปยังส่วนนั้นและตั้งค่าคุณสมบัติ SurfaceGui.Faceวัตถุ UI เด็กจะปรากฏบนใบหน้าของส่วนประกอบพ่อแม่
หรือคุณสามารถวาง SurfaceGui ภายในคอนเทนเนอร์เช่น StarterGui แล้วกำหนดค่า Adornee ของมันเป็นค่าใดก็ได้จาก BasePart เช่นเดียวกับเป้าหมาย Faceการตั้งค่า Adornee ยกเลิกการเชื่อมโยงโดยตรงกับพ่อแม่โดยตรงทำให้สามารถยืดหยุ่นในการวางได้มากขึ้นเนื่องจากสามารถตั้งค่าได้จากสคริปต์ในระหว่างการทำงาน
องค์ประกอบ UI โต้ตอบเช่น ImageButtons และ TextButtons ภายใน SurfaceGui จะได้รับการใส่ข้อมูลผู้ใช้เฉพาะเมื่อพวกเขามีส่วนร่วมกับผู้เล่น PlayerGui โดยปกติผ่านการวาง SurfaceGui ภายใน StarterGui ตามที่ระบุไว้ข้างต้น
เพื่อช่วยในการเลือกใบหน้าที่ถูกต้องสำหรับ SurfaceGui , คลิกขวาที่ส่วนเป้าหมายและเลือก แสดงตัวบ่งบอกทิศทาง .นี้แสดงวงกลมสีน้ำเงินพร้อมกับ F และเส้นที่ติดกับใบหน้าของวัตถุ Front และลูกศรสีเขียวที่ชี้ไปในทิศทางของใบหน้าของวัตถุ Top
ขนาดและตำแหน่ง
"พื้นที่วาดภาพ" ของ SurfaceGui ใช้พื้นที่ทั้งหมดของ Face ของพ่อหรือ Adornee ส่วนในฐานะที่เป็นการปฏิบัติที่ดีที่สุดแนะนำให้คุณใช้ค่า ขนาด และ ตำแหน่ง ของวัตถุ UI ลูกเช่น คุณยังสามารถใช้ UIAspectRatioConstraint กับบุตรของ SurfaceGui เพื่อรักษาอัตราส่วนที่ต้องการได้อย่างไม่ขึ้นกับขนาดใบหน้า
โหมดการบดบัง
คุณสมบัติ AlwaysOnTop จะกำหนดว่า SurfaceGui จะแสดงบนด้านบนของเนื้อหา 3D หรือจะถูกปิดกั้นโดยมันเมื่อตั้งค่าเป็น (เริ่มต้น) รูปแบบจะแสดงเช่นเนื้อหา 3D อื่น ๆ และถูกปิดกั้นโดยวัตถุ 3D อื่น ๆเมื่อตั้งค่าเป็น true มันจะแสดงเสมอเหนือเนื้อหา 3D และไม่ได้รับอิทธิพลจาก ความสว่าง/แสง ในสภาพแวดล้อม 3D
ความสว่างและแสงมีอิทธิพล
Brightness และ LightInfluence ทำงานร่วมกันเพื่อกำหนดวิธีที่แสงสิ่งแวดล้อมส่งผลต่อเนื้อหา UI ของ SurfaceGui
Brightness กำหนดตัวคูณที่แสงที่ปล่อยออกมาถูกขยายในช่วง 0 ถึง 1000 ทำให้คุณสามารถจับคู่ SurfaceGui อินสแตนซ์บิลบอร์ดวิดีโอสามารถสว่างขึ้นภายในห้องมืดโดยเพิ่ม Brightness เป็น 10
LightInfluence ควบคุมจํานวนการมีผลกระทบของ SurfaceGui ต่อแสงในสถานที่ในช่วงตั้งแต่ 0 ถึง 1การตั้งค่านี้เป็น 1 หมายความว่าแสงรอบๆ มีการควบคุมทั้งหมดเกี่ยวกับรูปลักษณ์ในขณะที่ตั้งค่าเป็น 0 หมายความว่าแสงไม่มีผล
โปรดทราบว่า Brightness ไม่สามารถเข้าถึงได้ใน Studio และไม่มีผลใดๆ เมื่อ LightInfluence เป็น 1 หรือ AlwaysOnTop เป็น true
การมองเห็นระยะทาง
MaxDistance ควบคุมระยะห่างจากกล้องที่ SurfaceGui จะแสดงก่อนหยุดการเรนเดอร์ค่าของ 0 หมายถึงไม่มีขีดจํากัดและจะแสดงได้ไกลอย่างไม่มีที่สิ้นสุดค่าเริ่มต้นของ 1000 ทำงานได้ดีสำหรับส่วนใหญ่กรณี
สำหรับ SurfaceGuis ที่ปรากฏในสภาพแวดล้อมภายนอก แนะนำให้ MaxDistance สูงพอที่จะให้แน่ใจว่า UI ของคอนเทนเนอร์มีขนาดเล็กพอที่จะให้แน่ใจว่าปรากฏหรือหายไปบนหน้าจอเมื่อปรากฏ ลดผลกระทบการป๊อปอิน/ออกอย่างกะทันหัน
แสดงลำดับ
หากมีตัวคอนเทนเนอร์หลายตัว SurfaceGui บนใบหน้าเดียวกัน คุณสามารถแยกชั้นได้โดยใช้ Z‑index ผ่านคุณสมบัติ ZOffset ของพวกเขา (การเปลี่ยนแปลงนี้จะไม่ "ยก" หรือ "จม" คอนเทนเนอร์จากพื้นผิว)
อินเทอร์เฟซบอร์ด UI
คอนเทนเนอร์ BillboardGui แสดงวัตถุ UI ในพื้นที่ 3D แต่แตกต่างจาก SurfaceGui ลูกหลานของ BillboardGui มักจะเผชิญกับกล้องเสมอคอนเทนเนอร์นี้มีประโยชน์สำหรับการแสดงข้อมูลที่เผยให้เห็นข้างหน้าด้านบนในวัตถุในประสบการณ์เช่นเครื่องวัดสุขภาพหรือชื่อเหนือตัวละครผู้เล่นตัวบ่งชี้ที่จะนําผู้เล่นไปยังวัตถุในโลก 3D และอื่น ๆ
เพื่อเชื่อมโยง กับประสบการณ์ใน หรือ เพียงแค่ส่งมันไปยังส่วนหรือแนบเนียนั้นและหากต้องการก็ปรับขนาด/ตำแหน่งของมัน ได้
หรือคุณสามารถวาง BillboardGui ภายในคอนเทนเนอร์เช่น StarterGui แล้วกำหนดค่า Adornee ของมันเป็นค่าใดก็ได้จาก BasePart หรือ Attachmentวิธีนี้ให้ความยืดหยุ่นมากขึ้นในการวางตำแหน่งเนื่องจาก Adornee สามารถตั้งค่าได้จากสคริปต์ในระหว่างการทำงาน เช่น เพื่อวาง BillboardGui บนหัวของตัวละครผู้เล่นระหว่างการทำงาน
องค์ประกอบ UI โต้ตอบเช่น ImageButtons และ TextButtons ภายใน BillboardGui จะได้รับการใส่ข้อมูลผู้ใช้เฉพาะเมื่อพวกเขามีส่วนร่วมกับผู้เล่น PlayerGui โดยปกติผ่านการวาง BillboardGui ภายใน StarterGui ตามที่ระบุไว้ข้างต้น
ขนาดและตำแหน่ง
สำหรับการจัดขนาดบิลบอร์ด ส่วนประกอบ ขนาดเล็ก ของชุดค่าเลขทรรศน์ของบิลบอร์ดตั้งค่าขนาดของบิลบอร์ดในพื้นที่ 3Dตัวอย่างเช่นการตั้งค่า {10, 0},{2, 0}( UDim2.fromScale(10, 2) ) จะสร้างป้ายโฆษณาที่มีอัตราส่วน 10:2 ที่มีขนาดใหญ่หรือเล็กขึ้นอยู่กับระยะห่างจากกล้อง
สำหรับการจัดตำแหน่ง, คุณสมบัติ StudsOffset เปลี่ยนแคนวาสบิลบอร์ดบนแกน X (ซ้าย/ขวา), Y แกน (ขึ้น/ลง), และ Z แกน (ไปข้างหน้า/หลัง) เมื่อเทียบกับกล้อง
เมื่อสร้างขนาดที่ปรับขนาดได้ BillboardGui ที่มีแท็ก TextLabel ก็เป็นประโยชน์ที่จะเปิดใช้งานคุณสมบัติ TextScaled ของฉลากเพื่อให้ข้อความขยายตามความลึกของกล้องเมื่อระยะทางกล้องเปลี่ยนไป
โหมดการบดบัง
คุณสมบัติ AlwaysOnTop จะกำหนดว่า BillboardGui จะแสดงบนด้านบนของเนื้อหา 3D หรือจะถูกปิดกั้นโดยมันเมื่อตั้งค่าเป็น (เริ่มต้น) รูปแบบจะแสดงเช่นเนื้อหา 3D อื่น ๆ และถูกปิดกั้นโดยวัตถุ 3D อื่น ๆเมื่อตั้งค่าเป็น true มันจะแสดงเสมอเหนือเนื้อหา 3D และไม่ได้รับอิทธิพลจาก ความสว่าง/แสง ในสภาพแวดล้อม 3D
ความสว่างและแสงมีอิทธิพล
Brightness และ LightInfluence ทำงานร่วมกันเพื่อกำหนดวิธีที่แสงสิ่งแวดล้อมส่งผลต่อเนื้อหา UI ของ BillboardGui
Brightness กำหนดตัวคูณที่แสงที่ปล่อยออกมาถูกขยายในช่วง 0 ถึง 1000 ทำให้คุณสามารถจับคู่ BillboardGui อินสแตนซ์บิลบอร์ดวิดีโอสามารถสว่างขึ้นภายในห้องมืดโดยเพิ่ม Brightness เป็น 10
LightInfluence ควบคุมจํานวนการมีผลกระทบของ BillboardGui ต่อแสงในสถานที่ในช่วงตั้งแต่ 0 ถึง 1การตั้งค่านี้เป็น 1 หมายความว่าแสงรอบๆ มีการควบคุมทั้งหมดเกี่ยวกับรูปลักษณ์ในขณะที่ตั้งค่าเป็น 0 หมายความว่าแสงไม่มีผล
โปรดทราบว่า Brightness ไม่สามารถเข้าถึงได้ใน Studio และไม่มีผลใดๆ เมื่อ LightInfluence เป็น 1 หรือ AlwaysOnTop เป็น true
การมองเห็นระยะทาง
MaxDistance ควบคุมระยะห่างจากกล้องที่ BillboardGui จะแสดงก่อนหยุดการเรนเดอร์ค่าของ 0 หรือ inf (เริ่มต้น) หมายความว่าไม่มีขีดจํากัดและจะแสดงผลได้ไม่มีที่สิ้นสุดไกล