GuiService

Nếu được kích hoạt, nút Select trên Gamepad hoặc Backslash sẽ tự động đặt một GUI là đối tượng được chọn.Tắt nó sẽ có nghĩa là Gui navigation vẫn sẽ hoạt động nếu GuiService.GuiNavigationEnabled được bật nhưng bạn sẽ phải thiết lập GuiService.SelectedObject bằng tay để bắt đầu Gui navigation.

Bật/tắt việc các đối tượng trong CoreGui có thể được điều hướng bằng Gamepad hay không.

Dùng để bật và tắt chức năng điều hướng GUI mặc định của điều khiển.

Trả về true nếu có bất kỳ menu nào của CoreGui được mở.

Nhận được sự minh bạch ưa thích của người dùng như một số từ 0 đến 1, cho thấy họ muốn có bao nhiêu mờ hơn nữa về nền của các thành phần UI.Mặc định là 1.

Giá trị trả lại này phản ánh một cài đặt có thể được thiết lập từ phía người dùng trong cài đặt ứng dụng hoặc trong menu cài đặt kinh nghiệm thông qua minh bạch nền .Giá trị mặc định là 1, cho thấy rằng người dùng thích sự minh bạch nền tảng mặc định.Giá trị thấp nhất là 0, cho thấy rằng người dùng thích nền hoàn toàn mờ nhạt, cải thiện độ đọc và tương phản cho UI bị ảnh hưởng.Nhân nhân tố của một yếu tố GuiObject.BackgroundTransparency với giá trị được trả về từ PreferredTransparency là cách được đề xuất để sử dụng cài đặt này; nền sẽ trở nên mờ nhạt hơn khi PreferredTransparency tiếp cận 0.Nó nên được sử dụng với Object:GetPropertyChangedSignal() để tự động cập nhật khi người dùng thay đổi độ trong suốt yêu thích của họ.

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()

Trả về true nếu người dùng đã bật chuyển động giảm. Mặc định thành false .

Giá trị trả lại này phản ánh một cài đặt có thể được đặt từ phía người dùng trong cài đặt ứng dụng hoặc trong menu cài đặt kinh nghiệm thông qua Giảm chuyển động .Một giá trị của true cho thấy rằng người dùng muốn giảm hoặc loại bỏ hoàn toàn các hiệu ứng chuyển động và hoạt hình.

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

Bộ GuiObject hiện đang được tập trung vào bởi GUI Navigator (được sử dụng cho Gamepad). Nó có thể được đặt lại thành nil nếu đối tượng ở ngoài màn hình.

Thuộc tính này được thay đổi bởi sự kiện GuiObject.SelectionGained và GuiObject.SelectionLost .

Nếu bạn muốn xác định khi thuộc tính này thay đổi mà không theo dõi sự kiện SelectionGained và SelectionLost cho tất cả các thành phần GUI, bạn có thể sử dụng sự kiện Changed.

local GuiService = game:GetService("GuiService")

local function printChanged(value)
	if value == "SelectedObject" then
		print("The SelectedObject changed!")
	end
end

GuiService.Changed:Connect(printChanged)

Trả về một đối tượng Rect đại diện cho khu vực chưa được chiếm giữ giữa các điều khiển bên trái nhất của Roblox và cạnh khu vực an toàn của thiết bị.

Giá trị là năng động và có thể được mong đợi thay đổi dựa trên tầm nhìn của điều khiển UI như thay đổi tính chất Health của người chơi địa phương, sử dụng StarterGui:SetCoreGuiEnabled() , thay đổi kích thước và vị trí của điều khiển UI Roblox, và/hoặc những người khác.Vì lý do này, nó được khuyến khích bạn phát hiện và phản ứng lại các thay đổi của thuộc tính này với Object:GetPropertyChangedSignal() .

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)

Được sử dụng để bật và tắt điều khiển chạm và hiển thị giao diện người dùng điều khiển chạm. Mặc định là true.

Chức năng này đóng menu kiểm tra, nếu mở, khi chạy từ một LocalScript .

Xem thêm:

• Thực đơn kiểm tra Avatar , một bài báo cung cấp một lời giải thích chi tiết hơn về tính năng Kiểm tra và Mua và cách nó hoạt động
• GuiService:InspectPlayerFromHumanoidDescription() , cho phép một nhà phát triển mở menu Kiểm tra hiển thị các tài sản được liệt kê trong đối tượng này HumanoidDescription .Điều này đặc biệt hữu ích khi những gì đang được mặc trên avatar của người chơi trên nền tảng Roblox không nhất thiết phải giống với ngoại hìnhxuất hiện trong trò chơi
• GuiService:InspectPlayerFromUserId() , cho phép Thực đơn kiểm tra xuất hiện hiển thị người dùng có được UserId .Điều này đặc biệt hữu ích khi bạn muốn kiểm tra các người chơi không ở trong trò chơi hiện tại

Lợi Nhuận

Tham Số

Lợi Nhuận

Trả về một boolean cho biết liệu menu Biểu cảm của người chơi có mở hay không.

Các nhà phát triển có thể mở hoặc đóng menu Biểu tượng bằng cách gọi chức năng GuiService:SetEmotesMenuOpen().

Lợi Nhuận

Chức năng này trả về việc có hay không có gameplay paused thông báo bị vô hiệu hóa bởi nhà phát triển.

Các nhà phát triển có thể bật hoặc tắt thông báo bằng cách gọi chức năng GuiService:SetGameplayPausedNotificationEnabled().

Xem thêm:

• Workspace.StreamingIntegrityMode và Enum.StreamingIntegrityMode để có thêm chi tiết về khi nào trò chơi bị tạm dừng.

Lợi Nhuận

Trả về hai giá trị Vector2 đại diện cho sự chèn của GUI người dùng trong điểm ảnh, từ góc trên cùng bên trái của màn hình và góc dưới cùng bên phải của màn hình lần lượt.

Các giá trị nhúc nhích được cung cấp bởi chức năng này chỉ có hiệu lực trên ScreenGuis những thành phần có chỉ số IgnoreGuiInset được đặt thành false.

Lợi Nhuận

Chức năng này trả về xem có chức năng menu Kiểm tra và Mua hiện đang được bật hay không.Tính năng được bật mặc định và có thể được đặt bằng chức năng GuiService:SetInspectMenuEnabled().

Xem thêm:

• Thực đơn kiểm tra Avatar , một bài báo cung cấp một lời giải thích chi tiết hơn về tính năng Kiểm tra và Mua và cách nó hoạt động
• GuiService:InspectPlayerFromHumanoidDescription() , cho phép một nhà phát triển mở menu Kiểm tra hiển thị các tài sản được liệt kê trong đối tượng này HumanoidDescription .Điều này đặc biệt hữu ích khi những gì đang được mặc trên avatar của người chơi trên nền tảng Roblox không nhất thiết phải giống với ngoại hìnhxuất hiện trong trò chơi
• GuiService:InspectPlayerFromUserId() , cho phép Thực đơn kiểm tra xuất hiện hiển thị người dùng có được UserId .Điều này đặc biệt hữu ích khi bạn muốn kiểm tra các người chơi không ở trong trò chơi hiện tại

Lợi Nhuận

Chức năng này cho phép một nhà phát triển mở menu Kiểm tra hiển thị các tài sản được liệt kê trong đối tượng HumanoidDescription.

Điều này cho phép thêm tùy chỉnh với những gì được hiển thị trong menu kiểm tra khi người chơi kiểm tra người chơi khác trong trò chơi của bạn.Nếu trò chơi của bạn thay đổi những gì người chơi đang mặc, bạn có thể thay thế cho Inspect Menu một đối tượng HumanoidDescription mô tả những gì một người chơi đang mặc và những vật phẩm sẽ được hiển thị.Bạn nên truyền một tên để đại diện cho tên của người chơi sẽ được kiểm tra.

Xem thêm:

• Thực đơn kiểm tra Avatar , một bài báo cung cấp một lời giải thích chi tiết hơn về tính năng Kiểm tra và Mua và cách nó hoạt động
• GuiService:SetInspectMenuEnabled() , cho phép các nhà phát triển bật hoặc tắt chức năng kiểm tra và mua mặc định
• GuiService:InspectPlayerFromUserId() , cho phép Thực đơn kiểm tra xuất hiện hiển thị người dùng có được UserId .Điều này đặc biệt hữu ích khi bạn muốn kiểm tra các người chơi không ở trong trò chơi hiện tại.

Tham Số

Lợi Nhuận

local GuiService = game:GetService("GuiService")

local humanoidDescription = Instance.new("HumanoidDescription")
humanoidDescription.HatAccessory = "3339374070"
humanoidDescription.BackAccessory = "3339363671"

GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")

Chức năng này cho phép Thực đơn kiểm tra xuất hiện hiển thị người dùng có được UserId đã cho.Điều này đặc biệt hữu ích khi bạn muốn kiểm tra các người chơi không ở trong trò chơi hiện tại.

Điều này hiển thị cùng một thông tin như tab "Hiện đang mặc" trên hồ sơ của người dùng được chỉ định.

Xem thêm:

• Thực đơn kiểm tra Avatar , một bài báo cung cấp một lời giải thích chi tiết hơn về tính năng Kiểm tra và Mua và cách nó hoạt động
• GuiService:SetInspectMenuEnabled() , cho phép các nhà phát triển bật hoặc tắt chức năng kiểm tra và mua mặc định.Điều này đặc biệt hữu ích khi những gì đang được mặc trên avatar của người chơi trên nền tảng Roblox không nhất thiết phải giống với hình xuất hiện trong trò ngoại hình
• GuiService:InspectPlayerFromHumanoidDescription() , cho phép một nhà phát triển mở ra menu Kiểm tra hiển thị các tài sản được liệt kê trong đối tượng này HumanoidDescription

Tham Số

Lợi Nhuận

local GuiService = game:GetService("GuiService")
GuiService:InspectPlayerFromUserId(772462)

Trả về true nếu khách hàng đang sử dụng giao diện 10 feet, đó là một phiên bản đặc biệt của giao diện người dùng của Roblox, dành riêng cho các bảng điều khiển.Đây là cách duy nhất được đảm bảo để kiểm tra xem người dùng có ở trên bảng điều khiển hay không.

Lợi Nhuận

Khi Select được gọi trên một instance selectionParent là PlayerGui hoặc là con cháu của PlayerGui, động cơ tìm kiếm tất cả các GuiObjects có thể chọn, có thể nhìn thấy và trên màn hình là con cháu của selectionParent và đặt GuiService.SelectedObject vào GuiObject với GuiObject nhỏ nhất GuiService.SelectionOrder.

Tham Số

Lợi Nhuận

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()

Tham Số

Lợi Nhuận

Mở hoặc đóng menu Biểu cảm của người chơi.

Tham Số

Lợi Nhuận

Phương pháp này cho phép các nhà phát triển vô hiệu hóa thông báo tích hợp khi một trò chơi của người chơi bị tạm dừng.Họ có thể thêm UI của riêng họ nếu họ muốn tùy chỉnh nó.

Các nhà phát triển có thể truy vấn xem có bật thông báo hay không bằng cách gọi chức năng GuiService:GetGameplayPausedNotificationEnabled().

Xem thêm:

• Workspace.StreamingIntegrityMode và Enum.StreamingIntegrityMode để có thêm chi tiết về khi nào trò chơi bị tạm dừng.

Tham Số

Lợi Nhuận

Chức năng này cho phép các nhà phát triển bật hoặc tắt chức năng kiểm tra và mua mặc định.Điều này hữu ích khi bạn muốn vô hiệu hóa tính năng trong trò chơi của mình, hoàn toàn hoặc trong một số phần của trò chơi của bạn (như một cảnh cắt).Tính năng được bật mặc định.

Ví dụ mã bên dưới cho thấy cách vô hiệu hóa menu kiểm tra cho trò chơi của bạn:

local GuiService = game:GetService("GuiService")
GuiService:SetInspectMenuEnabled(false)

Xem thêm:

• Thực đơn kiểm tra Avatar , một bài báo cung cấp một lời giải thích chi tiết hơn về tính năng Kiểm tra và Mua và cách nó hoạt động
• GuiService:InspectPlayerFromHumanoidDescription() , cho phép một nhà phát triển mở menu Kiểm tra hiển thị các tài sản được liệt kê trong đối tượng này HumanoidDescription .Điều này đặc biệt hữu ích khi những gì đang được mặc trên avatar của người chơi trên nền tảng Roblox không nhất thiết phải giống với ngoại hìnhxuất hiện trong trò chơi
• GuiService:InspectPlayerFromUserId() , cho phép Thực đơn kiểm tra xuất hiện hiển thị người dùng có được UserId .Điều này đặc biệt hữu ích khi bạn muốn kiểm tra các người chơi không ở trong trò chơi hiện tại

Tham Số

Lợi Nhuận

Bắt lửa khi người dùng đóng menu thoát cốt lõi Roblox.

Bắt lửa khi người dùng mở menu thoát cốt lõi Roblox.