StarterGui

แสดงที่เลิกใช้งานแล้ว

*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

ไม่สามารถสร้าง
บริการ

StarterGui เป็นวัตถุคอนเทนเนอร์ที่ออกแบบมาเพื่อรองรับวัตถุ LayerCollector เช่น ScreenGuis

StarterGui รวมถึงระเบียบาตรของฟังก์ชันที่ช่วยให้คุณสามารถใช้งานกับ CoreGui ตัวอย่างเช่น StarterGui:SetCoreGuiEnabled()

สรุป

คุณสมบัติ

  • ซ่อนอยู่
    ไม่ซ้ำ
    การรักษาความปลอดภัยของปลั๊กอิน
    อ่านพร้อมๆ กัน

    ช่วยให้บริการนี้ประมวลผลการป้อนข้อมูลเช่น PlayerGui และ CoreGui ทำ

  • ไม่สามารถเขียนสคริปต์
    อ่านพร้อมๆ กัน
  • อ่านพร้อมๆ กัน

    ตั้งค่าโหมดการจัดเรียงหน้าจอเริ่มต้นสำหรับผู้ใช้ที่มีอุปกรณ์เคลื่อนที่

  • อ่านพร้อมๆ กัน

    กำหนดว่าโคเนอร์ของ StarterGui มองเห็นได้ใน Studio หรือไม่

  • ไม่สามารถเขียนสคริปต์
    อ่านพร้อมๆ กัน

วิธีการ

  • กลับว่า Enum.CoreGuiType ที่ให้ไว้นั้นเปิดใช้งานหรือไม่ หรือถ้าปิดใช้งานโดยใช้ StarterGui:SetCoreGuiEnabled()

  • SetCore(parameterName : string,value : Variant):void

    ช่วยให้คุณทำสิ่งต่อไปนี้ด้วยสคริปต์แกนหลักของ Roblox

  • SetCoreGuiEnabled(coreGuiType : Enum.CoreGuiType,enabled : bool):void

    ตั้งค่าว่า CoreGui รายการที่เกี่ยวข้องกับ Enum.CoreGuiType จะเปิดหรือปิด

  • GetCore(parameterName : string):Variant
    ผลตอบแทน

    กลับค่าตัวแปรที่ได้รับการกำหนดโดยสคริปต์ Roblox เครื่องกล

วิธีการรับทอดมาจากBasePlayerGui
  • กลับรายการของ all GuiObject ตัวอย่างที่เป็นเจ้าของจุดที่กำหนดในหน้าจอ

คุณสมบัติ

ProcessUserInput

ซ่อนอยู่
ไม่ซ้ำ
การรักษาความปลอดภัยของปลั๊กอิน
อ่านพร้อมๆ กัน

ช่วยให้ StarterGui ประมวลผลการป้อนข้อมูลเช่น PlayerGui และ CoreGui ทำเช่นนั้น มีค่าเริ่มต้นคือ 1> false1>

RtlTextSupport

ไม่สามารถเขียนสคริปต์
อ่านพร้อมๆ กัน

ScreenOrientation

อ่านพร้อมๆ กัน

สมบัตินี้ตั้งค่าโหมดการจัดเรียงหน้าจอที่ชื่นชอบสำหรับผู้ใช้ที่มีอุปกรณ์เคลื่อนที่ สำหรับโหมดที่แตกต่างกัน โปรดดู Enum.ScreenOrientation

โดยปกติ, ค่านี้กำหนดเป็น Sensor หมายถึงประสบการณ์จะแสดงขึ้นอยู่กับการจับคู่ที่ดีที่สุดกับตำแหน่งปัจจุบันของอุปกรณ์ ไม่ว่าจะเป็นแนวตั้ง (ซ้าย/ขวา) หรือพอร์ตเทรต

เมื่อ Player เข้าร่วมประสบการณ์บนอุปกรณ์มือถือ, ผู้เล่นClass.PlayerGui.ScreenOrient

หมายเหตุว่าการเปลี่ยนแปลงค่านี้จะไม่เปลี่ยนตำแหน่งหน้าจอสำหรับ Players ที่อยู่ในประสบการณ์ เพื่อเปลี่ยนตำแหน่งสำหรับผู้เล่นที่มีอยู่ ใช้ค่า PlayerGui.ScreenOrientation ของพว

ShowDevelopmentGui

อ่านพร้อมๆ กัน

สมบัตินี้กำหนดว่ามีให้เห็นใน Studio หรือไม่มีให้เห็นใน Studio

VirtualCursorMode

ไม่สามารถเขียนสคริปต์
อ่านพร้อมๆ กัน

วิธีการ

GetCoreGuiEnabled

ฟังก์ชันนี้จะกลับมาว่า Enum.CoreGuiType ที่ให้ไว้นั้นเปิดใช้งานหรือไม่ หรือถ้าใช้ StarterGui:SetCoreGuiEnabled() ในการปิดใช้งาน

หมายเหตุว่าการตั้งค่า "TopbarEnabled" ให้เป็น false โดยใช้ SetCore() ซ่อนผลลัพธ์ทั้งหมดของ 1> еньื่อย CoreGuiType|CoreGuiTypes1> แต่ไม่ส่งผลต่อผลลัพธ์ของฟังก

พารามิเตอร์

coreGuiType: Enum.CoreGuiType

CoreGuiType ที่มอบให้


ส่งค่ากลับ

ว่า Enum.CoreGuiType ที่ให้ไว้นี้เปิดใช้งานหรือไม่

ตัวอย่างโค้ด

Checking if a Core GUI is Enabled

local StarterGui = game:GetService("StarterGui")
print(StarterGui:GetCoreGuiEnabled("PlayerList"))

SetCore

void

วิธีนี้ (ไม่ควรสับสนกับ SetCoreGuiEnabled() ) เปิดเผยความสามารถต่างๆ ที่กำหนดโดยสคริปต์หลักของ Roblox เช่นการส่งการแจ้งเตือนการเปลี่ยนแปลงสถานะสำหรับ

ตัวแปรแรกคือสตริงที่เลือกคุณสมบัติที่จะใช้งานได้ อาจจำเป็นต้องเรียกวิธีนี้หลายครั้งโดยใช้ pcall() ในกรณีที่สคริปต์รุ่นที่เกี่ยวข้องยังไม่โหลด (หรือถ้ามันถ

ตารางต่อไปนี้อธิบายสตริงที่อาจได้รับเป็นตัวแรกของตัวแปร ตัวแปรที่ควรติดตามจะขึ้นอยู่กับความสามารถที่จะใช้และอธิบายใน sub-tables

แชทแอคทีฟ

ควบคุมว่าการแชทเปิดอยู่หรือไม่


<tbody>
<tr>
<td><code>ใช้งานอยู่</code></td>
<td>บูลีน</td>
<td>(ต้องการ)</td>
<td>กำหนดว่าคุณควรให้แชทใช้งานได้หรือไม่</td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย
การแจ้งเตือนจุด

ควบคุมว่าจะปรากฏข้อความสำหรับแต้มผู้เล่นที่ได้รับหรือไม่


<tbody>
<tr>
<td><code>ใช้งานอยู่</code></td>
<td>บูลีน</td>
<td>(ต้องการ)</td>
<td>กำหนดว่าจะปรากฏข้อความสำหรับแต้มผู้เล่นที่ได้รับหรือไม่</td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย
แจ้งเหรียญตราได้แล้ว

ควบคุมว่าจะปรากฏบัตรเหรียญที่ได้รับหรือไม่


<tbody>
<tr>
<td><code>ใช้งานอยู่</code></td>
<td>บูลีน</td>
<td>(ต้องการ)</td>
<td>กำหนดว่าจะปรากฏบัตรเหรียญที่ได้รับหรือไม่</td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย
รีเซ็ตปุ่มโทร

กำหนดพฤติกรรม, ถ้ามี, ของปุ่มรีเซ็ตที่ให้ตัวเลือกหรือ BindableEvent เพื่อถูกยิงเมื่อผู้เล่นร้องขอให้รีเซ็ต


<tbody>
<tr>
<td><code>เปิดใช้งานแล้ว</code></td>
<td>บูลีน</td>
<td>(ต้องการ)</td>
<td>กำหนดว่าปุ่มรีเซ็ตจะเก็บพฤติกรรมปกติของมันหรือไม่</td>
</tr>
<tr>
<td colspan="4"><b>หรือ</b></td>
</tr>
<tr>
<td><code>คืนค่า</code></td>
<td><code>Class.BindableEvent</code></td>
<td>(ต้องการ)</td>
<td>Class.BindableEvent เพื่อจะได้รับการเปิดเมื่อผู้เล่นยืนยันว่าต้องการรีเซ็ต</td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย
ChatMakeSystemMessage

แสดงข้อความที่ปรับแต่งในแชท


<tbody>
<tr>
<td><code>โครงการตารางข้อมูล</code></td>
<td>พจนานุกรม</td>
<td>(ต้องการ)</td>
<td>พจนานุกรมของข้อความที่อธิบายข้อความ (ดูด้านล่าง)</td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย

<tbody>
<tr>
<td><code>ข้อความนี้</code></td>
<td>สตริง</td>
<td>(ต้องการ)</td>
<td>ข้อความที่จะแสดง</td>
</tr>
<tr>
<td><code>สี</code></td>
<td><code>ข้อมูลประเภท .Color3</code></td>
<td><code>Datatype.Color3.fromRGB(255, 255, 243)</code></td>
<td>สีข้อความ</td>
</tr>
<tr>
<td><code>ตัวอักษร</code></td>
<td><code>Font ตรรกะ</code></td>
<td><code>SourceSansBold</code></td>
<td>ตัวอักษรของข้อความ</td>
</tr>
<tr>
<td><code>ขนาดข้อความ</code></td>
<td>ตัวเลข</td>
<td><code>18 ตัวอักษร</code></td>
<td>ขนาดข้อความ</td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย
ส่งแจ้ง

ส่งการแจ้งเตือนที่ไม่รบกวนมาที่ด้านล่างขวาของหน้าจอ การแจ้งเตือนอาจมีปุ่มถึงสองปุ่ม


<tbody>
<tr>
<td><code>โครงการตารางข้อมูล</code></td>
<td>พจนานุกรม</td>
<td>(ต้องการ)</td>
<td>พจนานุกรมของข้อมูลที่อธิบายการแจ้งเตือน (ดูด้านล่าง)</td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย

<tbody>
<tr>
<td><code>ชื่อเรื่อง</code></td>
<td>สตริง</td>
<td>(ต้องการ)</td>
<td>ชื่อเรื่องของการแจ้งเตือน</td>
</tr>
<tr>
<td><code>ข้อความนี้</code></td>
<td>สตริง</td>
<td>(ต้องการ)</td>
<td>ข้อความหลักของการแจ้งเตือน</td>
</tr>
<tr>
<td><code>ไอคอน</code></td>
<td>สตริง</td>
<td />
<td>รูปภาพที่จะแสดงพร้อมการแจ้งเตือน</td>
</tr>
<tr>
<td><code>ระยะเวลา</code></td>
<td>จํานวน</td>
<td><code>5</code></td>
<td>ระยะเวลา (ในวินาที) การแจ้งเตือนจะยังคงมองเห็นได้</td>
</tr>
<tr>
<td><code>คืนค่า</code></td>
<td><code>คลาส .BindableFunction</code></td>
<td />
<td>Class.BindableFunction ผู้เล่น</td>
</tr>
<tr>
<td><code>ปุ่ม1</code></td>
<td>สตริง</td>
<td />
<td>ข้อความที่แสดงบนปุ่มแรก</td>
</tr>
<tr>
<td><code>ปุ่ม 2</code></td>
<td>สตริง</td>
<td />
<td>ข้อความที่แสดงบนปุ่มที่สอง</td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย
มีแถบเมนู

กำหนดว่ามีเป็นแถบด้านบนหรือไม่ คลังไอเท็มCoreGuis เช่นการแชทรายการ

เมื่อปิดใช้งาน แถบสถานะจะยังคงจับเหตุการณ์เมาส์ อย่างไรก็ตาม ปุ่มที่วางอยู่ที่นั่นจะไม่ตอบสนองต่อการคลิก พื้นที่ GUI จะยังคงเป็น 36 พิกเซลจากด้านบนของหน้าจอ


<tbody>
<tr>
<td><code>เปิดใช้งานแล้ว</code></td>
<td>บูลีน</td>
<td>(ต้องการ)</td>
<td>กำหนดว่าคุณสมบัติด้านบนควรมองเห็นได้หรือไม่</td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย
DevConsoleมองเห็นได้

กำหนดว่า คอนโซลผู้พัฒนา มองเห็นได้หรือไม่


<tbody>
<tr>
<td><code>ความโปร่งใส</code></td>
<td>บูลีน</td>
<td>(ต้องการ)</td>
<td>กำหนดว่าคอนโซลมองเห็นได้หรือไม่</td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย
ส่งคำขอเพื่อน

ขอให้ผู้เล่นปัจจุบันส่งคำขอเพื่อนไปยัง Player ที่กำหนด


<tbody>
<tr>
<td><code>ผู้เล่น</code></td>
<td><code>Class.Player</code></td>
<td>(ต้องการ)</td>
<td>ผู้เล่นที่เพื่อนขอให้ส่งคำขอ</td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย
ค้นหาเพื่อนที่ไม่ใช่เพื่อน

ขอให้ผู้เล่นปัจจุบันลบ Player จากรายชื่อเพื่อนของพวกเขา


<tbody>
<tr>
<td><code>ผู้เล่น</code></td>
<td><code>Class.Player</code></td>
<td>(ต้องการ)</td>
<td>ผู้เล่นที่คุณควรจะถอนเป็นเพื่อน</td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย
โปรมป์ต์บล็อกเพลเยอร์

ขอให้ผู้เล่นปัจจุบันบล็อก Player ที่ให้


<tbody>
<tr>
<td><code>ผู้เล่น</code></td>
<td><code>Class.Player</code></td>
<td>(ต้องการ)</td>
<td>ผู้เล่นที่ควรจะถูกบล็อก</td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย
โปรมปต์ยูนบล็อกเพลเยอร์

ขอให้ผู้เล่นปัจจุบันปลดบล็อก Player ที่ให้


<tbody>
<tr>
<td><code>ผู้เล่น</code></td>
<td><code>Class.Player</code></td>
<td>(ต้องการ)</td>
<td>ผู้เล่นที่ควรจะได้รับการปลดบล็อก</td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย
เปิดใช้งาน AvatarContextMenu

กำหนดว่า Avatar Context Menu เปิดใช้งานหรือไม่


<tbody>
<tr>
<td><code>เปิดใช้งานแล้ว</code></td>
<td>บูลีน</td>
<td>(ต้องการ)</td>
<td>กำหนดว่ามีเมนู上下文หรือไม่</td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย
AvatarContextMenuเป้าหมาย

เปิดใช้งาน เมนูบริบทัศน์ของ Avatar


<tbody>
<tr>
<td><code>ผู้เล่น</code></td>
<td><code>Class.Player</code></td>
<td>(ต้องการ)</td>
<td>ผู้เล่นที่จะเปิดหน้าเมนูบริบทัศน์</td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย
เพิ่ม Avatar Context Menu ตัวเลือก

เพิ่มตัวเลือกให้กับ Avatar Context Menu


<tbody>
<tr>
<td><code>ตัวเลือก</code></td>
<td><code>เมนู.AvatarContextMenuOption</code></td>
<td>(ต้องการ)</td>
<td>ตัวเลือกในการเพิ่ม</td>
</tr>
<tr>
<td colspan="4"><b>หรือ</b></td>
</tr>
<tr>
<td><code>ตัวเลือก</code></td>
<td>ตาราง</td>
<td>(ต้องการ)</td>
<td>ตารางสององค์ประกอบซึ่งอันแรกคือชื่อของการกระทําเฉพาะและอันที่สองคือ <code>Class.BindableEvent</code> ซึ่งจะถูกเรียกใช้ด้วยผู้เล่นที่เลือกตอนที่ตัวเลือกถูกเปิดใช้งาน</td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย
ลบโอเปอร์เตอร์คอนเท็กส์เมนู

ลบตัวเลือกจาก เมนูบริบทของ Avatar ตัวอังก์ option จะต้องเหมือนกับสิ่งที่ใช้กับ "AddAvatarContextMenuOption" (ดูด้านบน)


<tbody>
<tr>
<td><code>ตัวเลือก</code></td>
<td>ตัวแปร</td>
<td>(ต้องการ)</td>
<td>มีค่าเดียวกันที่ให้กับ <b>AddAvatarContextMenuOption</b></td>
</tr>
</tbody>
ชื่อชนิดเริ่มต้นคำอธิบาย
AvatarContextMenu

กำหนดการตั้งค่า Avatar Context Menu ซึ่งเป็นคุณสมบัติเลือกใหม่ที่สามารถให้การโต้ตอบของผู้เล่นแบบอนุรักษ์นิยมผ่านการกระทําที่ปรับแต่งได้เช่นการเริ่มการแลกเปลี่ยนกา

การเชื่อมต่อ CoreGuiChat

ติดตั้งการเชื่อมต่อระหว่างปุ่มการแชทของ CoreGui แถบด้านบน และระบบการแชทในอดีต สมุดประวัติต้องเป็นตารางของ BindableEvents และ BindableFunctions ต่อไป

พารามิเตอร์

parameterName: string

เลือกคุณสมบัติที่จะใช้งานกับการโทร

value: Variant

ตารางของ BindableEvents และ BindableFunctions


ส่งค่ากลับ

void

ตัวอย่างโค้ด

StarterGui Setting Core GUI

local StarterGui = game:GetService("StarterGui")
StarterGui:SetCore("AvatarContextMenuTheme", {
BackgroundImage = "",
BackgroundTransparency = 0.5,
BackgroundColor = Color3.fromRGB(111, 145, 242),
NameTagColor = Color3.fromRGB(0, 0, 200),
NameUnderlineColor = Color3.fromRGB(213, 233, 255),
ButtonFrameColor = Color3.fromRGB(15, 24, 65),
ButtonFrameTransparency = 0.2,
ButtonUnderlineColor = Color3.fromRGB(213, 233, 255),
Font = Enum.Font.SciFi,
})

SetCoreGuiEnabled

void

ฟังก์ชันนี้ตั้งค่าว่า CoreGui รายการที่เกี่ยวข้องกับ Enum.CoreGuiType จะเปิดหรือปิด

แถบด้านบนไม่สามารถปิดใช้งานได้โดยใช้หน้านี้ เพื่อปิดใช้งาน ให้ตั้ง "TopbarEnabled" เป็น false โดยใช้ StarterGui:SetCore() .

พารามิเตอร์

coreGuiType: Enum.CoreGuiType

CoreGuiType ที่มอบให้

enabled: bool

จะเปิดใช้งานหรือปิดใช้งาน Enum.CoreGuiType ที่มี


ส่งค่ากลับ

void

GetCore

Variant
ผลตอบแทน

วิธีนี้กลับค่าชุดข้อมูลหรือทำให้มีให้บริการโดย Roblox สคริปต์หลัก ตัวแรกและเท่านั้นคือสตริงที่เลือกข้อมูลที่จะได้รับ วิธีต่อไปนี้อธิบายสตริงและข้อมูลที่กลับมาโดยหน้าฟ้า

การเรียกวิธีนี้อาจให้ผล หลายจากนี้ยังลงทะเบียนอยู่ในระดับเทียมเทียมของเรา SetCore() ฟังก์ชัน (เหล่านี้มีด้วยดาวหมาก)

PointsNotificationsActive *

กลับ true หากเปิดใช้งานการแจ้งเตือนจุด

BadgesNotificationsActive *

กลับ true หากเปิดใช้งานการแจ้งเตือนรางวัล

AvatarContextMenu เปิดใช้งาน *

กลับ true หาก เมนูบริบทัศน์ของ Avatar เปิดใช้งาน

ChatActive *

กลับไปที่ว่าการแชทเป็นไปอย่างไร สถานะนี้สามารถแสดงได้โดยการเลือกสถานะของไอคอนแชทในแถบด้านบน

ขนาดหน้าต่าง *

กลับขนาดของหน้าต่างแชทเป็น UDim2

ตำแหน่งหน้าต่าง *

กลับขนาดของหน้าต่างแชทเป็น UDim2

ChatBarDisabled *

กลับมา true หากแถบแชทถูกปิด

รับรหัสผู้ใช้ที่ถูกบล็อก

กลับรายการ UserIds ที่เกี่ยวข้องกับผู้ใช้ที่ถูกบล็อกโดยผู้เล่นในท้องถิ่น

PlayerBlockedEvent

กลับไปที่ BindableEvent ที่จะถูกเรียกใช้เมื่อผู้เล่นถูกบล็อกโดยผู้เล่นในเกม

PlayerUnblockedEvent

กลับไปที่ BindableEvent ที่จะถูกเรียกใช้เมื่อผู้เล่นถูกปลดบล็อกโดยผู้เล่นในเกม

PlayerMutedEvent (การปิดเสียงผู้เล่น)

กลับไปที่ BindableEvent ที่จะถูกเรียกใช้เมื่อผู้เล่นถูกปิดเสียงโดยผู้เล่นในเกม

PlayerUnMutedEvent

กลับไปที่ BindableEvent ที่จะถูกเรียกใช้เมื่อผู้เล่นถูกเปิดเสียงใหม่โดยผู้เล่นท้องถิ่น

PlayerFriendedEvent สนับสนุน

กลับไปที่ BindableEvent ที่จะถูกเรียกใช้เมื่อผู้เล่นเป็นเพื่อนกับผู้เล่นในเกม

PlayerUnfriendedEvent

กลับไปที่ BindableEvent ที่จะถูกเรียกใช้เมื่อผู้เล่นถูก BindableEvent

DevConsoleVisible *

กลับ true หาก คอนโซลผู้พัฒนา มองเห็นได้

ความเข้มของการหมุน VR

กลับสตริงที่อธิบายความไวในการหมุนกล้องใน VR: Low ، High และ Smooth นี้จะไม่มีให้ใช้งานได้ยกเว้น 2> Class.VRService.VREnabled2> เป็น 5> true5>

พารามิเตอร์

parameterName: string

ส่งค่ากลับ

Variant

อีเวนต์