GuiService
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
GuiService memungkinkan pengembang untuk mengontrol apa GuiObject saat ini dipilih oleh pengguna gamepad, serta memeriksa apakah menu utama Roblox saat ini terbuka.
Rangkuman
Properti
Jika diaktifkan, tombol Select pada Gamepad atau Backslash akan secara otomatis menetapkan GUI sebagai objek yang dipilih.
Mengubah apakah objek dalam CoreGui dapat di navigasikan menggunakan Gamepad.
Digunakan untuk mengaktifkan dan menonaktifkan navigasi GUI kontroler default.
Kembalinya benar jika menu CoreGui terbuka.
Mendapatkan transparansi pengguna yang diinginkan sebagai angka antara 0 dan 1, yang menunjukkan seberapa opak mereka ingin agar latar belakang beberapa elemen UI. Penggunaan default adalah sebagai pengganda dari Transparansi Latar Belakang . Standar adalah 1.
Mengembalikan true jika pengguna mengaktifkan gerakan yang dikurangi. Standar untuk false .
Tetapkan GuiObject saat ini fokus pada oleh GUI Navigator ( digunakan untuk Gamepads).
Digunakan untuk menentukan ukuran dan posisi area yang tidak diblokir dalam ruang bar atas.
Digunakan untuk mengaktifkan dan menonaktifkan tombol sentuh dan tampilan tombol sentuh. Standar untuk benar.
Metode
Tutup Menu Inspeksi, jika terbuka.
Memeriksa apakah menu Emotes pemain terbuka.
Mengembalikan apakah atau tidak notifikasi gameplay paused telah dinonaktifkan oleh pengembang.
Mengembalikan dua nilai Vector2 yang mewakili inset GUI pengguna dalam pixel, dari sudut kiri atas layar dan sudut kanan bawahnya masing-masing.
Mengembalikan apakah fungsionalitas menu Inspect and Buy diaktifkan.
Memungkinkan seorang pengembang untuk menunjukkan menu Inspect yang menunjukkan aset yang tercantum dalam objek HumanoidDescription ini.
Memungkinkan Menu Pemeriksaan untuk muncul menunjukkan pengguna yang memiliki UserId yang diberikan.
Mengembalikan benar jika klien menggunakan antarmuka sepuluh kaki, yang merupakan versi khusus UI Roblox, eksklusif untuk konsol. Ini adalah satu-satunya cara yang dijamin untuk memeriksa apakah pengguna berada di konsol atau tidak.
Set GuiService.SelectedObject ke anak dari pilihan instans yang disediakanParent yang adalah PlayerGui atau anak-anaknya.
Membuka atau menutup menu Emotes pemain.
Memungkinkan pengembang untuk menonaktifkan notifikasi bawaan saat gameplay pemain dihentikan.
Memungkinkan pengembang untuk mengaktifkan atau menonaktifkan fitur Inspeksi dan Beli yang default.
Acara
Dibakar saat pengguna tutup menu pelarian coregui Roblox.
Dibakar saat pengguna membuka menu kabur coreguardi Roblox.
Properti
AutoSelectGuiEnabled
Jika diaktifkan, tombol Select pada Gamepad atau Backslash akan secara otomatis menetapkan GUI sebagai objek yang dipilih. Menonaktifkan ini akan berarti bahwa navigasi Gui masih akan bekerja jika GuiService.GuiNavigationEnabled diaktifkan tetapi Anda harus menetapkan 1> Class.
CoreGuiNavigationEnabled
Mengubah apakah objek dalam CoreGui dapat di navigasikan menggunakan Gamepad.
GuiNavigationEnabled
Digunakan untuk mengaktifkan dan menonaktifkan navigasi GUI kontroler default.
PreferredTextSize
PreferredTransparency
Mendapatkan transparansi pengguna sebagai angka antara 0 dan 1, yang menunjukkan seberapa banyak transparansi latar belakang elemen UI yang mereka inginkan. Standar ke 1.
Contoh Kode
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
Mengembalikan true jika pengguna mengaktifkan gerakan yang dikurangi. Standar untuk false .
Nilai kembalian ini mencerminkan pengaturan yang dapat diatur dari pihak pengguna dalam aplikasi pengaturan atau dalam menu pengaturan pengalaman melalui Reduce Motion . Sebuah nilai true menunjukkan bahwa pengguna ingin efek gerakan dan animasi dikurangi atau benar-benar dihapus.
Contoh Kode
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
Tetapkan bahwa GuiObject saat ini fokus dengan GUI Navigator (digunakan untuk Gamepads). Ini mungkin diatur ulang menjadi nol jika objek berada di luar layar.
Elemen ini diubah oleh acara GuiObject.SelectionGained dan GuiObject.SelectionLost.
Jika Anda ingin menentukan kapan properti ini berubah tanpa melacak acara Pemilihan yang Diterima dan Pemilihan yang Hilang untuk semua elemen GUI, Anda dapat menggunakan acara Changed.
Contoh Kode
local GuiService = game:GetService("GuiService")
local function printChanged(value)
if value == "SelectedObject" then
print("The SelectedObject changed!")
end
end
GuiService.Changed:Connect(printChanged)
TopbarInset
Mengembalikan objek Rect yang mewakili area yang tidak terisi di antara kontrol Roblox kiri-most dan sudut area aman perangkat.
Nilainya dinamis dan dapat diharapkan untuk berubah tergantung pada keseruan UI seperti mengubah properti Health lokal pemain, penggunaan StarterGui:SetCoreGuiEnabled() , dan/atau yang lainnya. Untuk alasan ini, dis
Contoh Kode
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
Digunakan untuk mengaktifkan dan menonaktifkan tombol sentuh dan tampilan tombol sentuh. Standar untuk benar.
Metode
CloseInspectMenu
Fungsi ini menutup Menu Inspeksi, jika terbuka, saat dijalankan dari LocalScript .
Lihat juga:
- Menu Penjelajahan Avatar , artikel yang memberikan penjelasan yang lebih rinci tentang fitur Inspect dan Buy dan cara kerjanya
- GuiService:InspectPlayerFromHumanoidDescription() , memungkinkan seorang pengembang untuk menampilkan menu Inspect menunjukkan item yang diperbarui dalam objek HumanoidDescription ini. Ini sangat berguna ketika apa yang dikenakan pada avatar pemain di platform Roblox tidak selalu sama dengan penampilan mereka dalam game
- GuiService:InspectPlayerFromUserId() , memungkinkan Inspect Menu untuk muncul menunjukkan pengguna yang memiliki UserId yang diberikan. Ini sangat berguna ketika Anda ingin mengecek pemain yang tidak dalam game saat ini
Memberikan nilai
GetEmotesMenuOpen
Mengembalikan boeing menunjukkan apakah atau tidak menu Emotes pemain dibuka.
Pengembang dapat membuka atau menutup menu Emotes dengan menelepon fungsi GuiService:SetEmotesMenuOpen() .
Memberikan nilai
Menunjukkan apakah menu Emotes terbuka.
GetGameplayPausedNotificationEnabled
Fungsi ini mengembalikan apakah atau tidak notifikasi gameplay paused telah dinonaktifkan oleh pengembang.
Pengembang dapat mengaktifkan atau menonaktifkan notifikasi dengan menyebut fungsi GuiService:SetGameplayPausedNotificationEnabled() .
Lihat juga:
- Workspace.StreamingIntegrityMode dan Enum.StreamingIntegrityMode untuk lebih banyak informasi tentang kapan gameplay dihentikan.
Memberikan nilai
Apakah atau tidak notifikasi gameplay paused telah dinonaktifkan.
GetGuiInset
Mengembalikan dua nilai Vector2 yang mewakili inset GUI pengguna dalam pixel, dari sudut kiri atas layar dan sudut kanan bawahnya masing-masing.
Nilai input yang disediakan oleh fungsi ini hanya berlaku pada ScreenGuis yang memiliki set propinsi IgnoreGuiInset ke benar.
Memberikan nilai
Sebuah tuple dua nilai Vector2 yang menggambarkan Gui Inset saat ini.
GetInspectMenuEnabled
Fungsi ini mengembalikan apakah fungsi Inspect dan Buy menu saat ini diaktifkan. Fitur ini diaktifkan secara default dan dapat diatur menggunakan fungsi GuiService:SetInspectMenuEnabled().
Lihat juga:
- Menu Penjelajahan Avatar , artikel yang memberikan penjelasan yang lebih rinci tentang fitur Inspect dan Buy dan cara kerjanya
- GuiService:InspectPlayerFromHumanoidDescription() , memungkinkan seorang pengembang untuk menampilkan menu Inspect menunjukkan item yang diperbarui dalam objek HumanoidDescription ini. Ini sangat berguna ketika apa yang dikenakan pada avatar pemain di platform Roblox tidak selalu sama dengan penampilan mereka dalam game
- GuiService:InspectPlayerFromUserId() , memungkinkan Inspect Menu untuk muncul menunjukkan pengguna yang memiliki UserId yang diberikan. Ini sangat berguna ketika Anda ingin mengecek pemain yang tidak dalam game saat ini
Memberikan nilai
Boolean menunjukkan apakah fitur Inspect Menu diaktifkan.
InspectPlayerFromHumanoidDescription
Fungsi ini memungkinkan seorang pengembang untuk menampilkan menu Inspect menunjukkan item yang terdaftar dalam objek HumanoidDescription ini.
Ini memungkinkan lebih banyak kustomisasi dengan apa yang ditunjukkan di Menu Inspect ketika pemain mengecek pemain lain di game Anda. Jika game Anda mengubah apa yang dikenakan pemain, Anda dapat memberikan objek Deskripsi Manusia ke Inspect Menu yang mewakili apa yang dikenakan pemain dan item tersebut akan ditampilkan. Anda juga harus menyebutkan nama untuk mewakili nama pemain yang a
Lihat juga:
- Menu Penjelajahan Avatar , artikel yang memberikan penjelasan yang lebih rinci tentang fitur Inspect dan Buy dan cara kerjanya
- GuiService:SetInspectMenuEnabled() , memungkinkan pengembang untuk mengaktifkan atau menonaktifkan fungsionalitas Inspeksi dan Beli default
- GuiService:InspectPlayerFromUserId() , memungkinkan Inspect Menu untuk muncul menunjukkan pengguna yang memiliki UserId yang diberikan. Ini sangat berguna ketika Anda ingin mengecek pemain yang tidak dalam game saat ini.
Parameter
Sebuah objek HumanoidDescription yang berisi aset untuk ditampilkan di menu Inspect.
Nama pemain yang akan Diaudit untuk ditampilkan di menu Inspect.
Memberikan nilai
Contoh Kode
local GuiService = game:GetService("GuiService")
local humanoidDescription = Instance.new("HumanoidDescription")
humanoidDescription.HatAccessory = "3339374070"
humanoidDescription.BackAccessory = "3339363671"
GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")
InspectPlayerFromUserId
Fungsi ini memungkinkan Menu Inspekti untuk muncul menunjukkan pengguna yang memiliki UserId yang diberikan. Ini sangat berguna ketika Anda ingin menginspeksi pemain yang tidak ada dalam game saat ini.
Ini menunjukkan informasi yang sama dengan tab "Saat Ini Memakai" di profil pengguna yang ditentukan.
Lihat juga:
- Menu Penjelajahan Avatar , artikel yang memberikan penjelasan yang lebih rinci tentang fitur Inspect dan Buy dan cara kerjanya
- GuiService:SetInspectMenuEnabled() , memungkinkan pengembang untuk mengaktifkan atau menonaktifkan fitur Inspeksi dan Beli default. Ini sangat berguna ketika apa yang dikenakan di avatar pemain di platform Roblox tidak selalu sama dengan penampilan mereka dalam game
- GuiService:InspectPlayerFromHumanoidDescription() , memungkinkan seorang pengembang untuk menunjukkan menu Inspect yang menunjukkan aset yang tercantum dalam objek HumanoidDescription ini
Parameter
Class.Player.UserId|UserId pemain untuk diperiksa.
Memberikan nilai
Contoh Kode
local GuiService = game:GetService("GuiService")
GuiService:InspectPlayerFromUserId(772462)
IsTenFootInterface
Mengembalikan benar jika klien menggunakan antarmuka sepuluh kaki, yang merupakan versi khusus UI Roblox, eksklusif untuk konsol. Ini adalah satu-satunya cara yang dijamin untuk memeriksa apakah pengguna berada di konsol atau tidak.
Memberikan nilai
Select
Ketika Select dipanggil pada instansi seleksiParent yang adalah PlayerGui atau anak của PlayerGui, mesin mencari semua GuiObjek yang tersedia, terlihat dan di-screen yang là con cái seleksiParent dan tetapkan GuiService.SelectedObject ke GuiObjek dengan GuiService.SelectionOrder terkecil.
Parameter
Orang tua pilihan cuplikan dari orang-orang yang dicari.
Memberikan nilai
Contoh Kode
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()
SetEmotesMenuOpen
Membuka atau menutup menu Emotes pemain.
Parameter
Memberikan nilai
SetGameplayPausedNotificationEnabled
Metode ini memungkinkan pengembang untuk menonaktifkan notifikasi bawaan saat gameplay pemain dihentikan. Mereka kemudian dapat menambahkan UI mereka sendiri jika mereka ingin menyesuaikannya.
Pengembang dapat mengambil kembali apakah notifikasi diaktifkan dengan memanggil fungsi GuiService:GetGameplayPausedNotificationEnabled() .
Lihat juga:
- Workspace.StreamingIntegrityMode dan Enum.StreamingIntegrityMode untuk lebih banyak informasi tentang kapan gameplay dihentikan.
Parameter
Apakah atau tidak GUI notifikasi bawaan diaktifkan.
Memberikan nilai
SetInspectMenuEnabled
Fungsi ini memungkinkan pengembang untuk mengaktifkan atau menonaktifkan fitur Inspeksi dan Beli default. Fitur ini berguna ketika Anda ingin menonaktifkan fitur dalam game Anda, sepenuhnya atau selama beberapa bagian dari game Anda (seperti cutscene). Fitur ini diaktifkan secara default.
Sampel kode di bawah ini menunjukkan cara menonaktifkan Menu Inspeksi untuk game Anda:
local GuiService = game:GetService("GuiService")GuiService:SetInspectMenuEnabled(false)
Lihat juga:
- Menu Penjelajahan Avatar , artikel yang memberikan penjelasan yang lebih rinci tentang fitur Inspect dan Buy dan cara kerjanya
- GuiService:InspectPlayerFromHumanoidDescription() , memungkinkan seorang pengembang untuk menampilkan menu Inspect menunjukkan item yang diperbarui dalam objek HumanoidDescription ini. Ini sangat berguna ketika apa yang dikenakan pada avatar pemain di platform Roblox tidak selalu sama dengan penampilan mereka dalam game
- GuiService:InspectPlayerFromUserId() , memungkinkan Inspect Menu untuk muncul menunjukkan pengguna yang memiliki UserId yang diberikan. Ini sangat berguna ketika Anda ingin mengecek pemain yang tidak dalam game saat ini
Parameter
Boolean yang menunjukkan apakah akan mengaktifkan atau menonaktifkan fitur Inspect Menu.
Memberikan nilai
Acara
MenuClosed
Dibakar saat pengguna tutup menu pelarian coregui Roblox.
MenuOpened
Dibakar saat pengguna membuka menu kabur coreguardi Roblox.