GuiService
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
GuiService cho phép các nhà phát triển kiểm soát những gì GuiObject đang được chọn bởi người dẫn đi gamepad, cũng như kiểm tra xem màn hình chính của Roblox hiện đang mở.
Tóm Tắt
Thuộc Tính
Nếu được kích hoạt, nút Select trên Gamepad hoặc Backslash sẽ tự động đặt một GUI làm đối tượng được chọn.
Bật/tắt mục đích sử dụng Gamepad để điều hướng đối tượng trong CoreGui nếu có hay không.
Được sử dụng để bật hoặc tắt sự lưu hướng của GUI điều khiển mặc định.
Trả về true nếu một menu của CoreGui được mở.
Lấy độ trong suốt mà người dùng muốn là một số từ 0 đến 1, cho biết mức độ che giấu của họ muốn cho các nền của các thành phần UI nhất định. Cách sử dụng mặc định là nhân bằng của TransparencyBackground của một thành phần. Mặc định là 1.
Trả lại true nếu người dùng đã bật tính di chuyển giảm. Mặc định trở về false .
Điều chỉnh GuiObject hiện đang tập trung vào bởi GUI Navigator (được sử dụng cho Gamepads).
Được sử dụng để xác định kích thước và vị trí tương đối của khu vực bị mất trong không gian thanh bên trên.
Được sử dụng để bật và tắt các nút chạm và hiển thị UI của các nút chạm. Mặc định là true.
Phương Pháp
Đóng menu kiểm tra, nếu có.
Kiểm tra apakah menu biểu cảm của người chơi đang mở.
Quyết định whether or not the gameplay paused notification has been disabled by the developer.
Trả lại hai giá trị Vector2 đại diện cho hàng loạt các GUI người dùng được hiển thị trong píx, 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.
Quyết định whether the Inspect and Buy menu functionality is enabled.
Cho phép một nhà phát triển để mở menu kiểm tra để hiển thị tài nguyên được liệt kê trong đối tượng HumanoidDescription này.
Cho phép Inspect Menu hiển thị người dùng có được UserId đã được cung cấp.
Trả về true nếu client đang sử dụng giao diện người dùng mười chân, which is a special version of Roblox's UI, exclusive to consoles. This is the only guaranteed way to verify if the user is on a console or not.
Đặt GuiService.SelectedObject vào một con của lựa chọn phụ huynh cung cấp được đưa ra bởi PlayerGui hoặc các con của nó.
Mở hoặc đóng menu biểu cảm người chơi.
Cho phép các nhà phát triển tắt thông báo bên trong khi một người chơi tạm dừng chơi.
Cho phép các nhà phát triển bật hoặc tắt các chức năng kiểm tra và mua mặc định.
Sự Kiện
Lửa khi người dùng đóng mục thoát trong menu người dùng Roblox.
Lửa khi người dùng mở menu trốn thoát trung tâm Roblox.
Thuộc Tính
AutoSelectGuiEnabled
Nếu được kích hoạt, nút Select trên Gamepad hoặc Backslash sẽ tự động đặt một GUI làm đối tượng được chọn. Việc tắt nó sẽ có nghĩa là GUI Navigation vẫn sẽ hoạt động nếu Class.Gui
CoreGuiNavigationEnabled
Bật/tắt mục đích sử dụng Gamepad để điều hướng đối tượng trong CoreGui nếu có hay không.
PreferredTextSize
PreferredTransparency
Lấy độ trong suốt mà người dùng đã tùy chỉnh như một số từ 0 đến 1, cho thấy mức độ bịt kín mà họ muốn cho hình nền của các thành phần UI. Mặc định là 1.
G
Mẫu mã
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
Trả lại true nếu người dùng đã bật tính di chuyển giảm. Mặc định trở về false .
Giá trị trả lại này phản ánh một cài đặt mà người dùng có thể đặt từ phía người dùng trong các cài đặt app hoặc trong menu cài đặt trong kinh nghiệm qua Giảm giảm chuyển động. Một giá trị true cho thấy người dùng muốn giảm hoặc loại bỏ
Mẫu mã
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
Đặt GuiObject hiện đang được tập trung bởi GUI Navigator (được sử dụng cho Gamepads). Điều này có thể được thiết lập lại thành nil nếu đối tượng đang ngoài màn hình.
Điều này được thay đổi bởi các 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.
Mẫu mã
local GuiService = game:GetService("GuiService")
local function printChanged(value)
if value == "SelectedObject" then
print("The SelectedObject changed!")
end
end
GuiService.Changed:Connect(printChanged)
TopbarInset
Đều trả một Rect đối tượng đại diện cho khu vực bị bỏ không giữa các nút bên trái và các cạnh của thiết bị an toàn.
Giá trị là động và có thể được mong đợi thay đổi do sự hiển thị của UI controls như thay đổi property Health của người chơi local, sử dụng StarterGui:SetCoreGuiEnabled() ,
Mẫu mã
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
Được sử dụng để bật và tắt các nút chạm và hiển thị UI của các nút chạm. Mặc định là true.
Phương Pháp
CloseInspectMenu
Hàm này đóng menu kiểm tra, nếu mở, khi chạy từ một LocalScript .
Xem thêm:
- Avatar Inspect Menu , một bài viết cung cấp một 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ở màn hình kiểm tra để hiển thị những tài nguyên được liệt kê trong HumanoidDescription đối tượng. Điều này đặc biệt hữu ích khi những gì đang được m
- GuiService:InspectPlayerFromUserId() , cho phép Inspect Menu xuất hiện để hiển thị người chơi có được UserId đã được cung cấp. Điều này đặc biệt hữu ích khi bạn muốn kiểm tra những người chơi đang không trong trò chơi hiện tại
Lợi Nhuận
GetEmotesMenuOpen
Trả lại mộtBoolean cho biết có hay không mở menu biểu cảm người chơi.
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ỉ ra nếu menu Trang chủ đã mở.
GetGameplayPausedNotificationEnabled
Hàm này trả về có hay không có thông báo gameplay paused của 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 cho thêm chi tiết về thời gian dừng chơi.
Lợi Nhuận
Dù có phải không thì thông báo gameplay paused đã bị tắt.
GetGuiInset
Trả lại hai giá trị Vector2 đại diện cho hàng loạt các GUI người dùng được hiển thị trong píx, 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.
Giá trị đặt trước được cung cấp bởi chức năng này chỉ áp dụng cho ScreenGuis mà có giá trị IgnoreGuiInset của họ đặt trên giả mạo.
Lợi Nhuận
Một tuỳ tập hai giá trị Vector2 mô tả hiện tại Gui Inset.
GetInspectMenuEnabled
Hàm này trả về whether the Inspect and Buy menu functionality is currently enabled. The feature is enabled by default và có thể được cài đặt bằng cách sử dụng hàm GuiService:SetInspectMenuEnabled().
Xem thêm:
- Avatar Inspect Menu , một bài viết cung cấp một 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ở màn hình kiểm tra để hiển thị những tài nguyên được liệt kê trong HumanoidDescription đối tượng. Điều này đặc biệt hữu ích khi những gì đang được m
- GuiService:InspectPlayerFromUserId() , cho phép Inspect Menu xuất hiện để hiển thị người chơi có được UserId đã được cung cấp. Điều này đặc biệt hữu ích khi bạn muốn kiểm tra những người chơi đang không trong trò chơi hiện tại
Lợi Nhuận
Một biểu tượngBoolean cho biết có phải kích hoạt tính năng Kiểm tra Mục đích.
InspectPlayerFromHumanoidDescription
Hành độ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 nguyên được liệt kê trong đối tượng HumanoidDescription này.
Đ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 những người chơi khác trong game 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 vào đó một đối tượng H
Xem thêm:
- Avatar Inspect Menu , một bài viết cung cấp một 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 các chức năng kiểm tra và mua mặc định
- GuiService:InspectPlayerFromUserId() , cho phép Inspect Menu xuất hiện thể hiện người dùng có được UserId đã được cấp. Điều này đặc biệt hữu ích khi bạn muốn kiểm tra những người chơi nằm ngoài trò chơi hiện tại.
Tham Số
Một HumanoidDescription đối tượng chứa tài nguyên để hiển thị trong menu kiểm tra.
Tên của người chơi đang được kiểm tra để hiển thị trong menu Kiểm tra.
Lợi Nhuận
Mẫu mã
local GuiService = game:GetService("GuiService")
local humanoidDescription = Instance.new("HumanoidDescription")
humanoidDescription.HatAccessory = "3339374070"
humanoidDescription.BackAccessory = "3339363671"
GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")
InspectPlayerFromUserId
Chức năng này cho phép Inspect Menu 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 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ư "Đang Mặc" trên hồ sơ người dùng được chỉ định.
Xem thêm:
- Avatar Inspect Menu , một bài viết cung cấp một 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 các 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 một người chơitrên nền tảng Roblox không phải là những gì họ đang tìm kiếm trong trò chơi
- GuiService:InspectPlayerFromHumanoidDescription() , cho phép một nhà phát triển để mở màn hình kiểm tra hiển thị các tài nguyên được liệt kê trong đối tượng HumanoidDescription này
Tham Số
Class.Player.UserId|userId của người chơi để kiểm tra.
Lợi Nhuận
Mẫu mã
local GuiService = game:GetService("GuiService")
GuiService:InspectPlayerFromUserId(772462)
IsTenFootInterface
Trả về true nếu client đang sử dụng giao diện người dùng mười chân, which is a special version of Roblox's UI, exclusive to consoles. This is the only guaranteed way to verify if the user is on a console or not.
Lợi Nhuận
Select
Khi Select được gọi trên một instance selectionParent là PlayerGui hoặc một con cháu của PlayerGui, engine tìm kiếm tất cả các GuiObjects chọn lựa, có thể nhìn thấy và trên màn hình GuiObjects mà là con cháu của SelectionParent và thiết lập GuiService.SelectedObject vào GuiObject với nhỏ nhất <
Tham Số
Eltern của lựa chọn cuy những con của nó được tìm kiếm.
Lợi Nhuận
Mẫu mã
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()
SetGameplayPausedNotificationEnabled
Phương pháp này cho phép các nhà phát triển tắt thông báo bên trong khi chơi của một người chơi đang tạm dừng. Sau đó, 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ể xem xét có phải kích hoạt thông báo bằng cách gọi hàm GuiService:GetGameplayPausedNotificationEnabled() .
Xem thêm:
- Workspace.StreamingIntegrityMode và Enum.StreamingIntegrityMode cho thêm chi tiết về thời gian dừng chơi.
Tham Số
Dù có hay không màn hình thông báo tích hợp được tắt.
Lợi Nhuận
SetInspectMenuEnabled
Chức năng này cho phép các nhà phát triển bật hoặc tắt các chức năng kiểm tra và mua mặc định. Điều này hữu ích khi bạn muốn tắt tính năng trong trò chơi của bạn, 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 này được bật mặc định.
Mẫu mã dưới đây cho thấy cách vô hiệu hóa Inspect Menu cho trò chơi của bạn:
local GuiService = game:GetService("GuiService")GuiService:SetInspectMenuEnabled(false)
Xem thêm:
- Avatar Inspect Menu , một bài viết cung cấp một 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ở màn hình kiểm tra để hiển thị những tài nguyên được liệt kê trong HumanoidDescription đối tượng. Điều này đặc biệt hữu ích khi những gì đang được m
- GuiService:InspectPlayerFromUserId() , cho phép Inspect Menu xuất hiện để hiển thị người chơi có được UserId đã được cung cấp. Điều này đặc biệt hữu ích khi bạn muốn kiểm tra những người chơi đang không trong trò chơi hiện tại
Tham Số
Một biểu tượngBoolean cho biết có nên bật hoặc tắt tính năng Kiểm tra Menu.
Lợi Nhuận
Sự Kiện
MenuClosed
Lửa khi người dùng đóng mục thoát trong menu người dùng Roblox.
MenuOpened
Lửa khi người dùng mở menu trốn thoát trung tâm Roblox.