GuiService

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

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

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

GuiService ช่วยให้ผู้พัฒนาควบคุมสิ่งที่ GuiObject กำลังเลือกจากผู้นำทางเกมแพด, ตรวจสอบว่า เมนูหลักของ Roblox เปิดอยู่หรือไม่.

สรุป

คุณสมบัติ

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

    หากเปิดใช้งาน, ปุ่ม Select บน Gamepad หรือ Backslash จะตั้งค่า GUI เป็นวัตถุที่เลือกอัตโนมัติ

  • CoreGuiNavigationEnabled:bool
    ซ่อนอยู่
    ไม่ซ้ำ
    อ่านพร้อมๆ กัน

    เปิด/ปิดว่าวัตถุใน CoreGui สามารถนำทางได้โดย Gamepad หรือไม่

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

    ใช้เพื่อเปิด/ปิดการนำทางผ่าน GUI ของคอนโทรลเลอร์เริ่มต้น

  • MenuIsOpen:bool
    อ่านอย่างเดียว
    ไม่ซ้ำ
    อ่านพร้อมๆ กัน

    กลับ true หากเมนูใด ๆ ของ CoreGui เปิดอยู่

  • PreferredTextSize:Enum.PreferredTextSize
    อ่านอย่างเดียว
    ไม่ซ้ำ
    อ่านพร้อมๆ กัน
  • PreferredTransparency:number
    ซ่อนอยู่
    อ่านอย่างเดียว
    ไม่ซ้ำ
    อ่านพร้อมๆ กัน

    รับความโปร่งใสที่ผู้ใช้ต้องการเป็นตัวเลขระหว่าง 0 และ 1 ซึ่งแสดงถึงว่าพวกเขาต้องการให้พื้นหลังของบางส่วนของ UI นั้นมีความโปร่งใส การใช้งานที่แนะนำคือเป็นตัวคูณของความโปร่งใสขอ

  • ReducedMotionEnabled:bool
    ซ่อนอยู่
    อ่านอย่างเดียว
    ไม่ซ้ำ
    อ่านพร้อมๆ กัน

    กลับ true หากผู้ใช้เปิดใช้งานการเคลื่อนไหวลดลง ค่าเริ่มต้นจะเป็น false

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

    ตั้งค่า GuiObject ที่กำลังโฟกัสอยู่ในขณะนี้โดย GUI Navigator (ใช้สำหรับ Gamepads)

  • TopbarInset:Rect
    อ่านอย่างเดียว
    ไม่ซ้ำ
    อ่านพร้อมๆ กัน

    ใช้เพื่อกำหนดขนาดและตำแหน่งของพื้นที่ที่ไม่มีอุปสรรคภายในพื้นที่ด้านบนของแถบด้านบน

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

    ใช้เพื่อเปิดใช้งานและปิดการแสดงผลของการควบคุมและการควบคุมด้วยแท็ช ในการเริ่มต้น จะเป็นค่าเริ่มต้นที่จริง

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

วิธีการ

  • CloseInspectMenu():void

    ปิดหน้าต่างการตรวจสอบ, ถ้าเปิด

  • DismissNotification(notificationId : string):bool
  • GetEmotesMenuOpen():bool

    ตรวจสอบว่าหน้า Emotes ของผู้เล่นเปิดอยู่หรือไม่

  • GetGameplayPausedNotificationEnabled():bool

    กลับว่าจะเป็นไปตามที่ผู้พัฒนาได้ปิดการแจ้งเตือน gameplay paused หรือไม่

  • GetGuiInset():Tuple

    กลับค่าสองรายการ Vector2 ที่แทนที่ด้วยพิกเซลที่แสดงผลผู้ใช้ GUIs ในแนวตั้ง, จากมุมมองด้านบนซ้ายของหน้าจอและมุมมองด้านล่างของหน้าจอตามลำดับ

  • GetInspectMenuEnabled():bool

    กลับว่าใช้งานระเบียบของเมนูตรวจสอบและซื้อเปิดใช้งานหรือไม่

  • InspectPlayerFromHumanoidDescription(humanoidDescription : Instance,name : string):void

    ช่วยให้ผู้พัฒนานำเมนู Inspect ซึ่งแสดงรายการสินทรัพย์ที่ระบุในวัตถุ HumanoidDescription นี้

  • InspectPlayerFromUserId(userId : number):void

    ให้เมนูตรวจสอบปรากฏขึ้นแสดงผู้ใช้ที่มี UserId ที่ให้

  • IsTenFootInterface():bool

    กลับ true หากลูกค้ากำลังใช้ UI สามเท้าซึ่งเป็นเวอร์ชันพิเศษของ UI ของ Roblox สำหรับคอนโซล นี่เป็นวิธีการรับประกันเดียวเท่านั้นที่จะตรวจสอบว่าผู้ใช้อยู่บนคอนโซลหรือไม่

  • Select(selectionParent : Instance):void

    ตั้ง GuiService.SelectedObject เป็นลูกของตัวเลือกผู้ให้บริการที่เป็น PlayerGui หรือลูกหลานของมัน

  • SendNotification(notificationInfo : Dictionary):string
  • SetEmotesMenuOpen(isOpen : bool):void

    เปิดหรือปิดรายการอิโมจินี่ของผู้เล่น

  • SetGameplayPausedNotificationEnabled(enabled : bool):void

    ช่วยให้ผู้พัฒนาปิดการแจ้งเตือนเมื่อเกมของผู้เล่นถูกหยุดชั่วคราว

  • SetInspectMenuEnabled(enabled : bool):void

    ช่วยให้ผู้พัฒนาเปิดใช้งานหรือปิดการใช้งานการตรวจสอบและซื้อในตัวที่เรียบร้อย

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

อีเวนต์

  • MenuClosed():RBXScriptSignal

    เปิดเมนูหนีเมื่อผู้ใช้ปิดเมนู หุ้น ของ Roblox

  • MenuOpened():RBXScriptSignal

    เปิดเมนูหลบหนี Roblox coregui เมื่อผู้ใช้ เปิด เมนูหลักของ Roblox

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

คุณสมบัติ

AutoSelectGuiEnabled

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

หากเปิดใช้งาน, ปุ่ม Select บน Gamepad หรือ Backslash จะตั้งค่า GUI เป็นวัตถุที่เลือกอัตโนมัติ การปิดการใช้งานนี้จะหมายถึงว่าการนำทา

CoreGuiNavigationEnabled

bool
ซ่อนอยู่
ไม่ซ้ำ
อ่านพร้อมๆ กัน

เปิด/ปิดว่าวัตถุใน CoreGui สามารถนำทางได้โดย Gamepad หรือไม่

GuiNavigationEnabled

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

ใช้เพื่อเปิด/ปิดการนำทางผ่าน GUI ของคอนโทรลเลอร์เริ่มต้น

bool
อ่านอย่างเดียว
ไม่ซ้ำ
อ่านพร้อมๆ กัน

กลับ true หากเมนูใด ๆ ของ CoreGui เปิดอยู่

PreferredTextSize

Enum.PreferredTextSize
อ่านอย่างเดียว
ไม่ซ้ำ
อ่านพร้อมๆ กัน

PreferredTransparency

number
ซ่อนอยู่
อ่านอย่างเดียว
ไม่ซ้ำ
อ่านพร้อมๆ กัน

รับความโปร่งใสที่ผู้ใช้ต้องการเป็นตัวเลขระหว่าง 0 และ 1 ซึ่งแสดงถึงว่าพวกเขาต้องการให้พื้นหลังของรายการ UI มากขึ้นเท่าไหร่ ค่าเริ่มต้นคือ 1

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

Use Preferred Transparency
local DEFAULT_TRANSPARENCY = 0.5

local frame = script.Parent



local function setBackgroundTransparency()

	frame.BackgroundTransparency = DEFAULT_TRANSPARENCY * GuiService.PreferredTransparency

end



GuiService:GetPropertyChangedSignal("PreferredTransparency"):Connect(setBackgroundTransparency)

setBackgroundTransparency()

ReducedMotionEnabled

bool
ซ่อนอยู่
อ่านอย่างเดียว
ไม่ซ้ำ
อ่านพร้อมๆ กัน

กลับ true หากผู้ใช้เปิดใช้งานการเคลื่อนไหวลดลง ค่าเริ่มต้นจะเป็น false

ค่านี้สะท้อนการตั้งค่าที่สามารถตั้งค่าจากด้านผู้ใช้ในการตั้งค่าของแอปหรือในเมนูการตั้งค่าในประสบการณ์ผ่าน ลดความเคลื่อนไหว ค่าของ true แสดงถึงว่าผู้ใช้

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

Use Reduced Motion
local DEFAULT_TRANSPARENCY = 0.5

local frame = script.Parent



local endPosition = UDim2.fromScale(0.5, 0.8)

if GuiService.ReducedMotionEnabled then

	frame.Position = endPosition

else

	local moveTweenInfo = TweenInfo.new(0.5)

	local moveTweenProps = {

		Position = endPosition

	}

	local moveTween = TweenService:Create(frame, slideInTweenInfo, slideInTweenProps)

	moveTween:Play()

end

SelectedObject

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

ตั้งค่า GuiObject กำลังโฟกัสอยู่ในขณะนี้โดย GuiObject (ใช้สำหรับ Gamepads) นี่อาจรีเซ็ตเป็น zero หากวัตถุอยู่นอกหน้าจอ

สมบัตินี้เปลี่ยนแปลงโดย Class.GuiObject.SelectionGained และ Class.GuiObject.SelectionLost อีเวนต์

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

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

Printing When Gamepad Selection Changes
local GuiService = game:GetService("GuiService")



local function printChanged(value)

	if value == "SelectedObject" then

		print("The SelectedObject changed!")

	end

end



GuiService.Changed:Connect(printChanged)

TopbarInset

Rect
อ่านอย่างเดียว
ไม่ซ้ำ
อ่านพร้อมๆ กัน

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

ค่านี้มีความเป็นไปได้และสามารถเปลี่ยนแปลงตามความมองเห็นของการควบคุม UI เช่นการเปลี่ยนสถานะ Health ขอ

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

Responsive Frame Within Available Top Bar Space
local GuiService = game:GetService("GuiService")

local Players = game:GetService("Players")



local screenGui = Instance.new("ScreenGui")

screenGui.IgnoreGuiInset = true

screenGui.Parent = Players.LocalPlayer.PlayerGui



local frame = Instance.new("Frame")

frame.BackgroundColor3 = Color3.fromRGB(0, 255, 0)

frame.Parent = screenGui



GuiService:GetPropertyChangedSignal("TopbarInset"):Connect(function()

	local inset = GuiService.TopbarInset

	frame.Size = UDim2.new(0, inset.Width, 0, inset.Height)

	frame.Position = UDim2.new(0, inset.Min.X, 0, inset.Min.Y)

end)

TouchControlsEnabled

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

ใช้เพื่อเปิดใช้งานและปิดการแสดงผลของการควบคุมและการควบคุมด้วยแท็ช ในการเริ่มต้น จะเป็นค่าเริ่มต้นที่จริง

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

วิธีการ

CloseInspectMenu

void

ฟังก์ชันนี้ปิดหน้าตรวจสอบเมนู, หากเปิด, เมื่อวิ่งจาก LocalScript

ดูเพิ่มเติม:


ส่งค่ากลับ

void

DismissNotification

bool

พารามิเตอร์

notificationId: string

ส่งค่ากลับ

bool

GetEmotesMenuOpen

bool

กลับมาเป็นค่าตัวละครที่บ่งชี้ว่าผู้เล่นอิโมจิเปิดหรือไม่

ผู้พัฒนาสามารถเปิดหรือปิด Emotes เมนูโดยการโทร Emotes Menu Open ฟังก์ชัน GuiService:SetEmotesMenuOpen()


ส่งค่ากลับ

bool

ระบุว่า Emotes เมนูเปิดอยู่หรือไม่

GetGameplayPausedNotificationEnabled

bool

ฟังก์ชันนี้จะกลับมาที่จะว่ามีหรือไม่มีการแจ้งเตือน gameplay paused โดยผู้พัฒนา

ผู้พัฒนาสามารถเปิดหรือปิดการแจ้งเตือนโดยการเรียกฟังก์ชัน GuiService:SetGameplayPausedNotificationEnabled()

ดูเพิ่มเติม:


ส่งค่ากลับ

bool

จะให้คุณสมบัติ gameplay paused หรือไม่ได้

GetGuiInset

Tuple

กลับค่าสองรายการ Vector2 ที่แทนที่ด้วยพิกเซลที่แสดงผลผู้ใช้ GUIs ในแนวตั้ง, จากมุมมองด้านบนซ้ายของหน้าจอและมุมมองด้านล่างของหน้าจอตามลำดับ

ค่าตัวละครที่กำหนดโดยฟังก์ชันนี้ใช้ได้เฉพาะกับ ScreenGuis ที่มีค่าสมบัติของ IgnoreGuiInset ตั้งค่าเป็น false


ส่งค่ากลับ

Tuple

ชุดของสองค่า Value2 อธิบายการตั้งค่า Gui ปัจจุบัน

GetInspectMenuEnabled

bool

ฟังก์ชันนี้จะกลับมาว่าระบบการตรวจสอบและซื้อปัจจุบันเปิดใช้งานหรือไม่ คุณสมบัตินี้เปิดใช้งานโดยค่าเริ่มต้นและสามารถกำหนดได้โดยการใช้งานฟังก์ชัน GuiService:SetInspectMenuEnabled()

ดูเพิ่มเติม:


ส่งค่ากลับ

bool

บูเลียนที่แสดงว่า คุณสมบัติตรวจสอบ เปิดใช้งานหรือไม่

InspectPlayerFromHumanoidDescription

void

ระเบียบาศน์นี้ช่วยให้ผู้พัฒนานำเมนูนี้ขึ้นมาแสดงรายการสินทรัพย์ที่ระบุในวัตถุ HumanoidDescription นี้

นี่ช่วยให้การปรับแต่งเพิ่มเติมด้วยสิ่งที่ปรากฏในเมนูตรวจสอบเมื่อผู้เล่นตรวจสอบผู้เล่นคนอื่นในเกมของคุณ หากเกมของคุณเปลี่ยนสิ่งที่ผู้เล่นกําลังสวม

ดูเพิ่มเติม:

พารามิเตอร์

humanoidDescription: Instance

วัตถุ HumanoidDescription ที่มีสินทรัพย์ให้ดูในเมนูตรวจสอบ

name: string

ชื่อผู้เล่นที่จะปรากฏในเมนู ตรวจสอบ


ส่งค่ากลับ

void

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

Opening an Inspect Menu with a HumanoidDescription
local GuiService = game:GetService("GuiService")



local humanoidDescription = Instance.new("HumanoidDescription")

humanoidDescription.HatAccessory = "3339374070"

humanoidDescription.BackAccessory = "3339363671"



GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")

InspectPlayerFromUserId

void

ระเบียบเบียนนี้ช่วยให้เมนูปรากฏขึ้นแสดงผู้ใช้ที่มี UserId ที่ให้ไว้

นี่แสดงข้อมูลเดียวกับ "กําลังสวมใส่ในขณะนี้" บนโปรไฟล์ผู้ใช้ที่กำหนด

ดูเพิ่มเติม:

พารามิเตอร์

userId: number

Class.Player.UserId|userId ของผู้เล่นที่จะตรวจสอบ


ส่งค่ากลับ

void

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

Opening the Inspect Menu for a UserId
local GuiService = game:GetService("GuiService")

GuiService:InspectPlayerFromUserId(772462)

IsTenFootInterface

bool

กลับ true หากลูกค้ากำลังใช้ UI สามเท้าซึ่งเป็นเวอร์ชันพิเศษของ UI ของ Roblox สำหรับคอนโซล นี่เป็นวิธีการรับประกันเดียวเท่านั้นที่จะตรวจสอบว่าผู้ใช้อยู่บนคอนโซลหรือไม่


ส่งค่ากลับ

bool

Select

void

เมื่อ Select ถูกเรียกใน instanza เลือกพ่อที่เป็น PlayerGui หรือลูกหลานของ PlayerGui เครื่องมือจะค้นหา GuiObjects ทั้งหมดที่มีอยู่ที่เลือกพ่อและตั้ง GuiService.SelectedObject ไว้ใน GuiObjects ด้วย

พารามิเตอร์

selectionParent: Instance

พ่อของการเลือกซึ่งลูกหลานของเขาจะถูกค้นหา


ส่งค่ากลับ

void

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

Use Preferred Transparency
local DEFAULT_TRANSPARENCY = 0.5

local frame = script.Parent



local function setBackgroundTransparency()

	frame.BackgroundTransparency = DEFAULT_TRANSPARENCY * GuiService.PreferredTransparency

end



GuiService:GetPropertyChangedSignal("PreferredTransparency"):Connect(setBackgroundTransparency)

setBackgroundTransparency()

SendNotification

string

พารามิเตอร์

notificationInfo: Dictionary

ส่งค่ากลับ

string

SetEmotesMenuOpen

void

เปิดหรือปิดรายการอิโมจินี่ของผู้เล่น

พารามิเตอร์

isOpen: bool

ส่งค่ากลับ

void

SetGameplayPausedNotificationEnabled

void

วิธีนี้ช่วยให้ผู้พัฒนาปิดการแจ้งเตือนเมื่อเกมของผู้เล่นถูกหยุดชั่วคราว พวกเขาสามารถเพิ่ม UI ของตัวเองได้หากพวกเขาต้องการปรับแต่งมัน

ผู้พัฒนาสามารถรวมการตรวจสอบว่าการแจ้งเตือนนี้เปิดใช้งานได้โดยการโทรให้ฟัง GuiService:GetGameplayPausedNotificationEnabled() หรือไม่

ดูเพิ่มเติม:

พารามิเตอร์

enabled: bool

ว่าจะใช้หรือไม่ใช้ GUI การแจ้งเตือน


ส่งค่ากลับ

void

SetInspectMenuEnabled

void

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

ตัวอย่างโค้ดด้านล่างแสดงให้เห็นวิธีการปิดการใช้งานเมนูตรวจสอบสำหรับเกมของคุณ:

local GuiService = game:GetService("GuiService")

GuiService:SetInspectMenuEnabled(false)

ดูเพิ่มเติม:

พารามิเตอร์

enabled: bool

ตัวแปรที่แสดงว่าจะเปิดใช้งานหรือไม่เปิดใช้งานคุณสมบัติตรวจสอบ


ส่งค่ากลับ

void
ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

อีเวนต์

เปิดเมนูหนีเมื่อผู้ใช้ปิดเมนู หุ้น ของ Roblox


เปิดเมนูหลบหนี Roblox coregui เมื่อผู้ใช้ เปิด เมนูหลักของ Roblox


ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object