GuiService

Jika diaktifkan, tombol Select pada Gamepad atau Backslash akan secara otomatis mengatur GUI sebagai objek yang dipilih.Mematikan ini akan berarti bahwa navigasi Gui masih berfungsi jika GuiService.GuiNavigationEnabled diaktifkan tetapi Anda harus menetapkan GuiService.SelectedObject secara manual untuk memulai navigasi Gui.

Beralih apakah objek di CoreGui dapat di navigasikan menggunakan Gamepad atau tidak.

Digunakan untuk mengaktifkan dan menonaktifkan navigasi GUI kontrol default.

Kembalikan benar jika ada menu dari CoreGui dibuka.

Mendapatkan transparansi yang diinginkan pengguna sebagai angka antara 0 dan 1, yang menunjukkan seberapa tidak transparan mereka ingin latar belakang elemen UI.Biasanya menjadi 1.

Nilai pengembalian ini mencerminkan pengaturan yang dapat ditetapkan dari sisi pengguna di dalam pengaturan aplikasi atau di dalam menu pengaturan pengalaman melalui Transparansi Latar Belakang .Nilai default adalah 1, menunjukkan bahwa pengguna lebih menyukai transparansi latar belakang default.Nilai terendah adalah 0, menunjukkan bahwa pengguna lebih memilih latar belakang menjadi benar-benar tidak transparan, meningkatkan kelayakan baca dan kontras untuk UI yang terpengaruh.Menggandakan elemen GuiObject.BackgroundTransparency dengan nilai yang dikembalikan dari PreferredTransparency adalah cara yang direkomendasikan untuk menggunakan pengaturan ini; latar belakang akan menjadi lebih buram saat PreferredTransparency mendekati 0.Ini harus digunakan dengan Object:GetPropertyChangedSignal() sehingga secara otomatis diperbarui saat pengguna mengubah transparansi preferensial mereka.

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

Kembali true jika pengguna telah mengaktifkan gerakan yang dikurangi. Nilai default adalah false .

Nilai pengembalian ini mencerminkan pengaturan yang dapat ditetapkan dari sisi pengguna di dalam pengaturan aplikasi atau melalui menu pengaturan pengalaman dalam Mengurangi Gerakan .Nilai true menunjukkan bahwa pengguna ingin efek gerakan dan animasi dikurangi atau dihapus sepenuhnya.

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

Tetapkan GuiObject saat ini yang difokuskan oleh Navigator GUI (digunakan untuk Gamepad). Ini dapat diatur ulang menjadi nil jika objek berada di luar layar.

Properti ini diubah oleh peristiwa GuiObject.SelectionGained dan GuiObject.SelectionLost .

Jika Anda ingin menentukan kapan properti ini berubah tanpa melacak peristiwa SelectionGained dan SelectionLost untuk semua elemen GUI, Anda dapat menggunakan acara Changed.

local GuiService = game:GetService("GuiService")

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

GuiService.Changed:Connect(printChanged)

Kembalikan objek Rect yang mewakili area yang tidak ditempati di antara kontrol Roblox paling kiri dan ujung area aman perangkat.

Nilainya dinamis dan dapat diharapkan berubah berdasarkan visibilitas kontrol UI seperti mengubah properti pemainlokal Health, penggunaan StarterGui:SetCoreGuiEnabled(), mengubah ukuran dan posisi kontrol UI Roblox, dan/atau lainnya.Untuk alasan ini, disarankan agar Anda mendeteksi dan bereaksi terhadap perubahan properti ini dengan 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)

Digunakan untuk mengaktifkan dan menonaktifkan kontrol sentuhan dan tampilan UI kontrol sentuhan. Nilai default adalah benar.

Fungsi ini menutup Menu Inspeksi, jika terbuka, saat dijalankan dari LocalScript.

Lihat juga:

• Menu Inspeksi Avatar , sebuah artikel yang memberikan penjelasan lebih terperinci tentang fitur Inspeksi dan Beli dan bagaimana cara kerjanya
• GuiService:InspectPlayerFromHumanoidDescription() , memungkinkan seorang pengembang untuk menampilkan menu Inspeksi yang menunjukkan aset yang terdaftar dalam objek ini HumanoidDescription .Ini terutama berguna ketika apa yang dipakai pada avatar pemain di platform Roblox tidak harus sama dengan penampilan mereka dalam game
• GuiService:InspectPlayerFromUserId() , memungkinkan Menu Inspeksi muncul menunjukkan pengguna yang memiliki UserId yang diberikan.Ini sangat berguna ketika Anda ingin memeriksa pemain yang tidak ada di game saat ini

Memberikan nilai

Parameter

Memberikan nilai

Kembalikan boolean yang menunjukkan apakah pemain Emote menu terbuka atau tidak.

Pengembang dapat membuka atau menutup menu Emote dengan memanggil fungsi GuiService:SetEmotesMenuOpen().

Memberikan nilai

Fungsi ini menghasilkan apakah atau tidak notifikasi gameplay paused telah dinonaktifkan oleh pengembang.

Pengembang dapat mengaktifkan atau menonaktifkan notifikasi dengan memanggil fungsi GuiService:SetGameplayPausedNotificationEnabled().

Lihat juga:

• Workspace.StreamingIntegrityMode dan Enum.StreamingIntegrityMode untuk lebih banyak rincian tentang kapan permainan berhenti.

Memberikan nilai

Kembalikan dua nilai Vector2 yang mewakili insersi UI pengguna dalam piksel, dari sudut kiri atas layar dan sudut kanan bawah layar masing-masing.

Nilai insersi yang disediakan oleh fungsi ini hanya berlaku pada ScreenGuis yang memiliki properti IgnoreGuiInset diatur ke false.

Memberikan nilai

Fungsi ini men返回 apakah fungsi menu Inspeksi dan Beli saat ini diaktifkan.Fitur ini diaktifkan secara default dan dapat ditetapkan menggunakan fungsi GuiService:SetInspectMenuEnabled().

Lihat juga:

• Menu Inspeksi Avatar , sebuah artikel yang memberikan penjelasan lebih terperinci tentang fitur Inspeksi dan Beli dan bagaimana cara kerjanya
• GuiService:InspectPlayerFromHumanoidDescription() , memungkinkan seorang pengembang untuk menampilkan menu Inspeksi yang menunjukkan aset yang terdaftar dalam objek ini HumanoidDescription .Ini terutama berguna ketika apa yang dipakai pada avatar pemain di platform Roblox tidak harus sama dengan penampilan mereka dalam game
• GuiService:InspectPlayerFromUserId() , memungkinkan Menu Inspeksi muncul menunjukkan pengguna yang memiliki UserId yang diberikan.Ini sangat berguna ketika Anda ingin memeriksa pemain yang tidak ada di game saat ini

Memberikan nilai

Fungsi ini memungkinkan seorang pengembang untuk membuka menu Inspeksi yang menampilkan aset yang terdaftar dalam objek ini HumanoidDescription .

Ini memungkinkan kustomisasi lebih lanjut dengan apa yang ditampilkan di Menu Inspeksi saat pemain memeriksa pemain lain di game Anda.Jika permainan Anda mengubah apa yang dikenakan pemain, Anda dapat memberikan Inspect Menu objek HumanoidDescription yang mewakili apa yang dikenakan pemain dan item-item tersebut akan ditampilkan.Anda harus melewati nama juga untuk mewakili nama pemain yang akan diperiksa.

Lihat juga:

• Menu Inspeksi Avatar , sebuah artikel yang memberikan penjelasan lebih terperinci tentang fitur Inspeksi dan Beli dan bagaimana cara kerjanya
• GuiService:SetInspectMenuEnabled() , memungkinkan pengembang untuk mengaktifkan atau menonaktifkan fungsi Inspeksi dan Pembelian default
• GuiService:InspectPlayerFromUserId() , memungkinkan Menu Inspeksi muncul menunjukkan pengguna yang memiliki UserId yang diberikan.Ini sangat berguna ketika Anda ingin memeriksa pemain yang tidak ada di game saat ini.

Parameter

Memberikan nilai

local GuiService = game:GetService("GuiService")

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

GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")

Fungsi ini memungkinkan Menu Inspeksi muncul menunjukkan pengguna yang memiliki UserId yang diberikan.Ini sangat berguna ketika Anda ingin memeriksa pemain yang tidak ada di game saat ini.

Ini menunjukkan informasi yang sama dengan tab "Saat ini Memakai" di profil pengguna yang ditentukan.

Lihat juga:

• Menu Inspeksi Avatar , sebuah artikel yang memberikan penjelasan lebih terperinci tentang fitur Inspeksi dan Beli dan bagaimana cara kerjanya
• GuiService:SetInspectMenuEnabled() , memungkinkan pengembang untuk mengaktifkan atau menonaktifkan fungsi Inspeksi dan Pembelian default.Ini terutama berguna ketika apa yang dipakai pada avatar pemain di platform Roblox tidak harus sama dengan penampilan mereka dalam game
• GuiService:InspectPlayerFromHumanoidDescription() , memungkinkan seorang pengembang untuk menampilkan menu Inspeksi yang menunjukkan aset yang terdaftar dalam objek ini HumanoidDescription

Parameter

Memberikan nilai

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

Kembalikan benar jika klien menggunakan antarmuka sepuluh kaki, yang merupakan versi khusus dari UI Roblox, eksklusif untuk konsol.Ini adalah satu-satunya cara yang dijamin untuk memverifikasi apakah pengguna berada di konsol atau tidak.

Memberikan nilai

Ketika Pilih dipanggil pada seleksi instanceParent yang merupakan PlayerGui atau keturunan dari PlayerGui, mesin mencari semua GuiObject yang dapat dipilih, terlihat dan di layar yang merupakan keturunan dari seleksiParent dan menetapkan ke GuiObject dengan GuiObject terkecil .

Parameter

Memberikan nilai

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

Parameter

Memberikan nilai

Membuka atau menutup menu Emote pemain.

Parameter

Memberikan nilai

Metode ini memungkinkan pengembang untuk menonaktifkan notifikasi bawaan saat permainan pemain dijeda.Mereka kemudian dapat menambahkan UI mereka sendiri jika mereka ingin menyesuaikannya.

Pengembang dapat menanyakan apakah notifikasi diaktifkan dengan memanggil fungsi GuiService:GetGameplayPausedNotificationEnabled().

Lihat juga:

• Workspace.StreamingIntegrityMode dan Enum.StreamingIntegrityMode untuk lebih banyak rincian tentang kapan permainan berhenti.

Parameter

Memberikan nilai

Fungsi ini memungkinkan pengembang untuk mengaktifkan atau menonaktifkan fungsi Inspeksi dan Pembelian default.Ini berguna ketika Anda ingin menonaktifkan fitur di game Anda, sepenuhnya atau selama bagian tertentu dari permainan Anda (seperti cutscene).Fitur ini diaktifkan secara default.

Contoh kode di bawah ini menunjukkan cara menonaktifkan Menu Inspeksi untuk game Anda:

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

Lihat juga:

• Menu Inspeksi Avatar , sebuah artikel yang memberikan penjelasan lebih terperinci tentang fitur Inspeksi dan Beli dan bagaimana cara kerjanya
• GuiService:InspectPlayerFromHumanoidDescription() , memungkinkan seorang pengembang untuk menampilkan menu Inspeksi yang menunjukkan aset yang terdaftar dalam objek ini HumanoidDescription .Ini terutama berguna ketika apa yang dipakai pada avatar pemain di platform Roblox tidak harus sama dengan penampilan mereka dalam game
• GuiService:InspectPlayerFromUserId() , memungkinkan Menu Inspeksi muncul menunjukkan pengguna yang memiliki UserId yang diberikan.Ini sangat berguna ketika Anda ingin memeriksa pemain yang tidak ada di game saat ini

Parameter

Memberikan nilai

Melepaskan api saat pengguna menutup menu pelarian koreksi Roblox.

Melepaskan api saat pengguna membuka menu pelarian koreksi Roblox.