GuiService
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
GuiService geliştiricilerin şimdi oyun padı navigatori tarafından seçili olan GuiObject ile ilgili kontrolü sağlar, ayrıca Roblox'un ana menüsünün şu anda açık olup olmadığını da kontrol eder.
Özet
Özellikler
Aktif edildiğinde, Gamepad'deki Select düğmesi veya Backslash otomatik olarak seçili olan bir GUI olarak ayarlanır.
Oyunpad kullanarak objelerin CoreGui içinde gezilebilir olup olmadığını ayarlar.
Varsayılan kontrolör GUI navigasyonunu etkinleştirmek veya devre dışı bırakmak için kullanılır.
CoreGui'nin herhangi bir menüsü açıksa geri döndürür.
Kullanıcının tercih ettiği gizliliği 0 ila 1 arasındaki bir sayı olarak alır, bu da belirli UI öğelerinin arka planlarının ne kadar opak olacağını gösterir. Önerilen kullanım, bir elementin BackgroundTransparency'sinin varsayılan olarak 1'dir.Varsayılan olarak 1.
Kullanıcının azaltılmış hareketi etkinleştirildiyse true döndürür.Varsayılan false .
Gamepads için kullanılan GUI Navigator tarafından şu anda odaklanan GuiObject ayarlarını belirler.
Üst kutu alanındaki engellendi olmayan alanın kesin boyutunu ve konumunu belirlemek için kullanılır.
Dokunmatik kontrolleri etkinleştirmek ve kapatmak için kullanılır.Varsayılan doğru.
Yöntemler
Açıksa Kontrol Menüsünü kapatır.
Oyuncu Emotes menüsünün açık olduğunu kontrol eder.
Oyun durdurulduğunu veya oyun durdurulduğunu veya geliştirici tarafından oyun durdurulduğunu gösterir.
Ekranın sol üst kısmındaki kullanıcı GUI'lerinin yüklenmesini temsil eden iki Vector2 değeri içerir.
İncele ve Satın Al menü işlevlerinin etkinleştirildiğini veya etkinleştirilmediğini iade eder.
Bu nesneye listelenen kaynakları gösteren geliştirici tarafından gösterilen İnceleme menüsünü gösteren bir geliştirici oluşturur.
Kontrol Menüsü'nün verilen UserId 'i gösteren görünmesine izin verir.
Konsollar için Roblox'un UI'sini kullanan müşteri aşağıdaki gerçekleştirmeyi kullanıyorsa geri döndürür. Bu, konsolda olup olmadığınızı garanti eden tek yol.
Set GuiService.SelectedObject'ı PlayerGui veya onun geliştiricileri olan bir çocuğa bir ebeveyn olarak ayarlar.
Oyuncu Emoteleri menüsünü açar veya kapar.
Oyun durdurulduğunda oyuncuların oynatımını durdurmalarına izin verir.
Geliştiricilerin varsayılan Inspect ve Buy işlevlerini etkinleştirmesine veya devre dışı bırakmasına izin verir.
Etkinlikler
Kullanıcı, Roblox coregui kaçış menüsünü kapatır ve kayıt işlemlerini gerçekleştirir.
Kullanıcı açtığında Roblox çekirdek çıkış menüsünü açar.
Özellikler
AutoSelectGuiEnabled
Aktifleştirildiğinde, Oyunpad'da veya Select 'da bulunan Seç düğmesi otomatik olarak bir GUI'yi seçili nesne olarak ayarlar. Bu, Gui navigasyonunun hala çalışmasını sağlayacak, ancak GuiService.GuiNavigationEnabled et
CoreGuiNavigationEnabled
Oyunpad kullanarak objelerin CoreGui içinde gezilebilir olup olmadığını ayarlar.
GuiNavigationEnabled
Varsayılan kontrolör GUI navigasyonunu etkinleştirmek veya devre dışı bırakmak için kullanılır.
PreferredTextSize
PreferredTransparency
Kullanıcının tercih ettiği gizliliği 0 ila 1 arasındaki bir sayı olarak alır, bu da UI öğelerinin arka planının ne kadarının gizli olacağını gösterir.Varsayılan 1.
Kod Örnekleri
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
Kullanıcının azaltılmış hareketi etkinleştirildiyse true döndürür.Varsayılan false .
Bu dönüş değeri, uygulama ayarlarındaki veya deneyim içi ayarlardaki kullanıcı tarafından ayarlanabilen bir ayardan yansıtır. Bir Hareketi Azalt değeri, kullanıcının hareket etkilerini ve animasyonlarını azaltmak veya tamamen kaldırmak istediğini gösterir. Bir true değeri, kullanıcının hareket etkiler
Kod Örnekleri
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
Oyunpad'lar için kullanılan GuiObject şu anda GUI Navigator tarafından odaklanıyor. Bu, objeyi ekran dışındaysa sıfırlanabilir.
Bu özellik GuiObject.SelectionGained ve GuiObject.SelectionLost etkinlikleri tarafından değiştirilir.
Tüm GUI öğeleri için SeçimKazanılan ve SeçimKaybı etkinliklerini izlemeden bu özellik ne zaman değiştirilmesini isterseniz, Changed etkinliğini kullanabilirsiniz.
Kod Örnekleri
local GuiService = game:GetService("GuiService")
local function printChanged(value)
if value == "SelectedObject" then
print("The SelectedObject changed!")
end
end
GuiService.Changed:Connect(printChanged)
TopbarInset
Roblox'un sağ sol kontrolleriyle ve cihaz güvenli alanın kenarıyla ilgili boş alanı temsil eden bir Rect nesneleri döndürür.
Değer dinamiktir ve Health gibi UI kontrollerinin görünürlüğüne bağlı olarak değişmesi beklenebilir. StarterGui:SetCoreGuiEnabled() , Roblox UI Kontrollerinin boyutunu ve konumunu değiştirme ve/veya
Kod Örnekleri
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
Dokunmatik kontrolleri etkinleştirmek ve kapatmak için kullanılır.Varsayılan doğru.
Yöntemler
CloseInspectMenu
Bu işlev, açık olduğunda, bir LocalScript 'den çalıştığında kapatır.
Ayrıca bakınız:
- Avatar Inspect Menüsü , Inspect ve Satın Al özelliğinin daha ayrıntılı bir açıklamasını sağlayan bir makale
- GuiService:InspectPlayerFromHumanoidDescription() , bir geliştiriciyi bu HumanoidDescription nesninde listelenen varlıkları gösteren Inspect menüsünü gösteren Inspect menüsünü gösteren Inspect menüsünü gösteren Inspect menüsünü gösteren Inspect menüsünü gösteren Inspect menüsünü gösteren Inspect menüsünü göster
- GuiService:InspectPlayerFromUserId() , UserId ile verilen oyuncuyu gösteren İnceleme Menüsü görünmesine izin verir. Bu özellik özellikle mevcut oyun dışındaki oyuncuları incelemek istediğinizde kullanışlıdır.
Dönüşler
GetEmotesMenuOpen
Oyuncu Emotes menüsünün açık olup olmadığını gösteren bir booleto döndürür.
Geliştiriciler, Class.GuiService:SetEmotesMenuOpen() fonksiyonunu çağırarak Emotes menüsünü açabilir veya kapatabilir.
Dönüşler
Emoteler menüsünün açık olup olmadığını gösterir.
GetGameplayPausedNotificationEnabled
Bu işlev, gameplay paused bildiriminin geliştirici tarafından devre dışı bırakıldığını veya Class.Player.GameplayPaused|gameplay pause edildi bildiriminin geliştirici tarafından devre dışı bırakıldığını döndürür.
Geliştiriciler, Class.GuiService:SetGameplayPausedNotificationEnabled() fonksiyonunu çağırarak bildirimi etkinleştirebilir veya devre dışı bırakabilirler.
Ayrıca bakınız:
- Workspace.StreamingIntegrityMode ve Enum.StreamingIntegrityMode için daha fazla ayrıntı için kullanılır.
Dönüşler
Eğer gameplay paused notifikasyonu etkisiz hale getirilmiştir.
GetGuiInset
Ekranın sol üst kısmındaki kullanıcı GUI'lerinin yüklenmesini temsil eden iki Vector2 değeri içerir.
Bu işlev tarafından sağlanan giriş değerleri sadece ScreenGuis , IgnoreGuiInset özellik setlerinin sahte olup olmadığını etkiler.
Dönüşler
Mevcut Gui Inset'i tarif eden iki Vector2 değerinin bir tuşaması.
GetInspectMenuEnabled
Bu işlev, müfettiş ve satın alma menüsünün şu anda etkinleştirilip etkinleştirilmediğini gösterir. Özellik, varsayılan olarak etkinleştirilmiştir ve GuiService:SetInspectMenuEnabled() işlevi kullanılarak ayarlanabilir.
Ayrıca bakınız:
- Avatar Inspect Menüsü , Inspect ve Satın Al özelliğinin daha ayrıntılı bir açıklamasını sağlayan bir makale
- GuiService:InspectPlayerFromHumanoidDescription() , bir geliştiriciyi bu HumanoidDescription nesninde listelenen varlıkları gösteren Inspect menüsünü gösteren Inspect menüsünü gösteren Inspect menüsünü gösteren Inspect menüsünü gösteren Inspect menüsünü gösteren Inspect menüsünü gösteren Inspect menüsünü göster
- GuiService:InspectPlayerFromUserId() , UserId ile verilen oyuncuyu gösteren İnceleme Menüsü görünmesine izin verir. Bu özellik özellikle mevcut oyun dışındaki oyuncuları incelemek istediğinizde kullanışlıdır.
Dönüşler
İnceleme Menüsü özelliğinin etkinleştirilip etkinleştirilmediğini gösteren bir boşluk.
InspectPlayerFromHumanoidDescription
Bu işlev, bir geliştirici bu HumanoidDescription nesninde listelenen varlıkları gösteren İnceleme menüsünü göstermesine izin verir.
Bu, oyuncuların oyununuzdaki diğer oyuncuları incelediğinde Inspect Menüsünde gösterilen ile daha fazla özelleştirmeyi sağlar. Eğer oyunuzun oyuncularının giydiği şeyi değiştirirse, bunun yerine Inspect Menüsüne bir HumanoidDescription nesesi verebilirsiniz, bu da oyuncunun adını temsil eder. Oyununuzun adını da ver
Ayrıca bakınız:
- Avatar Inspect Menüsü , Inspect ve Satın Al özelliğinin daha ayrıntılı bir açıklamasını sağlayan bir makale
- GuiService:SetInspectMenuEnabled() , geliştiricilerin varsayılan İnceleme ve Satın Alma işlevlerini etkinleştirmesine veya devre dışı bırakmasına izin verir
- GuiService:InspectPlayerFromUserId() , UserId ile verilen kullanıcıyı gösteren Kontrol Menüsünü görüntülemesine izin verir. Bu özellik özellikle mevcut oyun dışındaki oyuncuları kontrol etmek istediğinizde kullanışlıdır.
Parametreler
İnspect menüsünde gösterilecek varlıkları gösteren bir HumanoidDescription nesnesi.
İnceleme menüsünde gösterilecek oyuncunun ismi.
Dönüşler
Kod Örnekleri
local GuiService = game:GetService("GuiService")
local humanoidDescription = Instance.new("HumanoidDescription")
humanoidDescription.HatAccessory = "3339374070"
humanoidDescription.BackAccessory = "3339363671"
GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")
InspectPlayerFromUserId
Bu işlev, UserId ile verilen kullanıcıyı gösteren Kontrol Etme Menüsü'nü görünmesini sağlar. Bu özellik özellikle mevcut oyun dışındaki oyuncuları kontrol etmek istediğinizde kullanışlıdır.
Bu, belirli kullanıcının profilindeki "Şu Anda Giyiyor" sekmesinin aynı bilgilerini gösterir.
Ayrıca bakınız:
- Avatar Inspect Menüsü , Inspect ve Satın Al özelliğinin daha ayrıntılı bir açıklamasını sağlayan bir makale
- GuiService:SetInspectMenuEnabled() , geliştiricilerin varsayılan Inspect ve Buy işlevlerini etkinleştirmesine veya devre dışı bırakmasına izin verir. Bu özellik özellikle oyun avatarında oynanan bir oyuncunun görünümünün gerektiği gibi olmadığında kullanışlıdır.
- GuiService:InspectPlayerFromHumanoidDescription() , bir geliştirici bu HumanoidDescription nesnede listelenen varlıkları gösteren İnceleme menüsünü gösterir
Parametreler
Dönüşler
Kod Örnekleri
local GuiService = game:GetService("GuiService")
GuiService:InspectPlayerFromUserId(772462)
IsTenFootInterface
Konsollar için Roblox'un UI'sini kullanan müşteri aşağıdaki gerçekleştirmeyi kullanıyorsa geri döndürür. Bu, konsolda olup olmadığınızı garanti eden tek yol.
Dönüşler
Select
Select İnstansı, PlayerGui veya bir PlayerGui'nin yan ürünü olan bir seçim ebeveyni çağrıldığında, motor tüm seçilebilir, görünür ve ekran üzeri GuiObjects arar ve GuiService.SelectedObject'yu en küçük GuiService.SelectionOrder ile GuiObject ayarlar.
Parametreler
Araştırılanların aşçıları olan seçimin ebeveyni.
Dönüşler
Kod Örnekleri
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
Bu yöntem, oyuncuların oynatma eğlencesini durdurduğunda geliştiricilerin içeriği gizlemelerine izin verir. Daha sonra istedikleri kadar kendi UI'larını ekleyebilirler.
Geliştiriciler, bildirimin GuiService:GetGameplayPausedNotificationEnabled() işlevini çağırarak etkinleştirilip etkinleştirilmediğini sorgulayabilirler.
Ayrıca bakınız:
- Workspace.StreamingIntegrityMode ve Enum.StreamingIntegrityMode için daha fazla ayrıntı için kullanılır.
Parametreler
Yerleşik bildirim GUI'si etkin değil.
Dönüşler
SetInspectMenuEnabled
Bu işlev, geliştiricilerin varsayılan Inspect ve Buy işlevlerini etkinleştirmesine veya devre dışı bırakmasına izin verir. Bu, oyununuzdaki özellikleri tamamen veya bazı kısımlarınızın (örneğin bir keskinlik) devre dışı bırakmasını istediğinizde yararlıdır. Bu özellik, varsayılan olarak etkinleştirilmiştir.
Aşağıdaki kod örneği, oyununuz için Kontrol Menüsünü nasıl devre dışı bırakacağınızı gösterir:
local GuiService = game:GetService("GuiService")GuiService:SetInspectMenuEnabled(false)
Ayrıca bakınız:
- Avatar Inspect Menüsü , Inspect ve Satın Al özelliğinin daha ayrıntılı bir açıklamasını sağlayan bir makale
- GuiService:InspectPlayerFromHumanoidDescription() , bir geliştiriciyi bu HumanoidDescription nesninde listelenen varlıkları gösteren Inspect menüsünü gösteren Inspect menüsünü gösteren Inspect menüsünü gösteren Inspect menüsünü gösteren Inspect menüsünü gösteren Inspect menüsünü gösteren Inspect menüsünü göster
- GuiService:InspectPlayerFromUserId() , UserId ile verilen oyuncuyu gösteren İnceleme Menüsü görünmesine izin verir. Bu özellik özellikle mevcut oyun dışındaki oyuncuları incelemek istediğinizde kullanışlıdır.
Parametreler
İnceleme Menüsü özelliketkinleştirmek veya devre dışı bırakmak için bir boBoolean.
Dönüşler
Etkinlikler
MenuClosed
Kullanıcı, Roblox coregui kaçış menüsünü kapatır ve kayıt işlemlerini gerçekleştirir.
MenuOpened
Kullanıcı açtığında Roblox çekirdek çıkış menüsünü açar.