GuiService

Hiển Thị Bản Đã Lỗi Thời

*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.

Không Thể Tạo
Dịch Vụ
Không Sao Chép

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

  • Đọc Song Song

    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.

  • Ẩn
    Không Sao Chép
    Đọc Song Song

    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 Song Song

    Đượ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.

  • Chỉ Đọc
    Không Sao Chép
    Đọc Song Song

    Trả về true nếu một menu của CoreGui được mở.

  • Chỉ Đọc
    Không Sao Chép
    Đọc Song Song
  • Ẩn
    Chỉ Đọc
    Không Sao Chép
    Đọc Song Song

    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.

  • Ẩn
    Chỉ Đọc
    Không Sao Chép
    Đọc Song Song

    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 .

  • Đọc Song Song

    Điều chỉnh GuiObject hiện đang tập trung vào bởi GUI Navigator (được sử dụng cho Gamepads).

  • Chỉ Đọc
    Không Sao Chép
    Đọc Song Song

    Đượ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 Song Song

    Đượ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

Sự Kiện

Thuộc Tính

AutoSelectGuiEnabled

Đọc Song Song

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

Ẩn
Không Sao Chép
Đọc Song Song

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.

GuiNavigationEnabled

Đọc Song Song

Đượ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.

Chỉ Đọc
Không Sao Chép
Đọc Song Song

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

PreferredTextSize

Chỉ Đọc
Không Sao Chép
Đọc Song Song

PreferredTransparency

Ẩn
Chỉ Đọc
Không Sao Chép
Đọc Song Song

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ã

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

Ẩn
Chỉ Đọc
Không Sao Chép
Đọc Song Song

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ã

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

Đọc Song Song

Đặ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.SelectionGainedGuiObject.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ã

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

Chỉ Đọc
Không Sao Chép
Đọc Song Song

Đề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ã

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

Đọc Song Song

Đượ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

void

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

void

DismissNotification

Tham Số

notificationId: string

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:


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

void

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ố

humanoidDescription: Instance

Một HumanoidDescription đối tượng chứa tài nguyên để hiển thị trong menu kiểm tra.

name: string

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

void

Mẫu mã

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

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ố

userId: number

Class.Player.UserId|userId của người chơi để kiểm tra.


Lợi Nhuận

void

Mẫu mã

Opening the Inspect Menu for a UserId

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

void

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ố

selectionParent: Instance

Eltern của lựa chọn cuy những con của nó được tìm kiếm.


Lợi Nhuận

void

Mẫu mã

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

Tham Số

notificationInfo: Dictionary

Lợi Nhuận

SetEmotesMenuOpen

void

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

Tham Số

isOpen: bool

Lợi Nhuận

void

SetGameplayPausedNotificationEnabled

void

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:

Tham Số

enabled: bool

Dù có hay không màn hình thông báo tích hợp được tắt.


Lợi Nhuận

void

SetInspectMenuEnabled

void

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ố

enabled: bool

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

void

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.