GuiService

Tampilkan yang Tidak Digunakan Lagi

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Tidak Dapat Dibuat
Layanan
Tidak Direplikasi

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.

  • Tersembunyi
    Tidak Direplikasi
    Baca Paralel

    Mengubah apakah objek dalam CoreGui dapat di navigasikan menggunakan Gamepad.

  • Digunakan untuk mengaktifkan dan menonaktifkan navigasi GUI kontroler default.

  • Hanya Baca
    Tidak Direplikasi
    Baca Paralel

    Kembalinya benar jika menu CoreGui terbuka.

  • Hanya Baca
    Tidak Direplikasi
    Baca Paralel
  • Tersembunyi
    Hanya Baca
    Tidak Direplikasi
    Baca Paralel

    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.

  • Tersembunyi
    Hanya Baca
    Tidak Direplikasi
    Baca Paralel

    Mengembalikan true jika pengguna mengaktifkan gerakan yang dikurangi. Standar untuk false .

  • Tetapkan GuiObject saat ini fokus pada oleh GUI Navigator ( digunakan untuk Gamepads).

  • Hanya Baca
    Tidak Direplikasi
    Baca Paralel

    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

Acara

Properti

AutoSelectGuiEnabled

Baca Paralel

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

Tersembunyi
Tidak Direplikasi
Baca Paralel

Mengubah apakah objek dalam CoreGui dapat di navigasikan menggunakan Gamepad.

GuiNavigationEnabled

Baca Paralel

Digunakan untuk mengaktifkan dan menonaktifkan navigasi GUI kontroler default.

Hanya Baca
Tidak Direplikasi
Baca Paralel

Kembalinya benar jika menu dari CoreGui terbuka.

PreferredTextSize

Hanya Baca
Tidak Direplikasi
Baca Paralel

PreferredTransparency

Tersembunyi
Hanya Baca
Tidak Direplikasi
Baca Paralel

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

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

Tersembunyi
Hanya Baca
Tidak Direplikasi
Baca Paralel

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

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

Baca Paralel

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

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

Hanya Baca
Tidak Direplikasi
Baca Paralel

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

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

Baca Paralel

Digunakan untuk mengaktifkan dan menonaktifkan tombol sentuh dan tampilan tombol sentuh. Standar untuk benar.

Metode

CloseInspectMenu

void

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

void

DismissNotification

Parameter

notificationId: string

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:


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

void

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:

Parameter

humanoidDescription: Instance

Sebuah objek HumanoidDescription yang berisi aset untuk ditampilkan di menu Inspect.

name: string

Nama pemain yang akan Diaudit untuk ditampilkan di menu Inspect.


Memberikan nilai

void

Contoh Kode

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

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:

Parameter

userId: number

Class.Player.UserId|UserId pemain untuk diperiksa.


Memberikan nilai

void

Contoh Kode

Opening the Inspect Menu for a UserId

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

void

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

selectionParent: Instance

Orang tua pilihan cuplikan dari orang-orang yang dicari.


Memberikan nilai

void

Contoh Kode

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

Parameter

notificationInfo: Dictionary

Memberikan nilai

SetEmotesMenuOpen

void

Membuka atau menutup menu Emotes pemain.

Parameter

isOpen: bool

Memberikan nilai

void

SetGameplayPausedNotificationEnabled

void

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:

Parameter

enabled: bool

Apakah atau tidak GUI notifikasi bawaan diaktifkan.


Memberikan nilai

void

SetInspectMenuEnabled

void

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

enabled: bool

Boolean yang menunjukkan apakah akan mengaktifkan atau menonaktifkan fitur Inspect Menu.


Memberikan nilai

void

Acara

Dibakar saat pengguna tutup menu pelarian coregui Roblox.


Dibakar saat pengguna membuka menu kabur coreguardi Roblox.