GuiService

Etkinleştirildiğinde, bir Gamepad'deki Select veya Backslash düğmesi otomatik olarak seçilen nesne olarak bir GUI ayarlayacaktır.Bunu kapatmak, GuiService.GuiNavigationEnabled etkinleştirilmiş olsa bile Gui navigasyonunun hala çalışacağını ifade edecektir, ancak Gui navigasyonunu başlatmak için GuiService.SelectedObject manuel olarak ayarlamanız gerekecektir.

CoreGui 'deki nesnelerin bir Gamepad kullanılarak gezilebilir olup olmadığını değiştirir.

Varsayılan kontrolör GUI navigasyonunu etkinleştirmek ve devre dışı bırakmak için kullanılır.

Herhangi bir CoreGui menüsü açık olduğunda gerçek döndürür.

Kullanıcının tercih ettiği saydamlığı 0 ile 1 arasındaki bir sayı olarak alır, böylece UI öğelerinin arka planının ne kadar opak olmasını istediğini gösterir.Varsayılan 1'dir.

Bu dönüş değeri, uygulama ayarlarından veya deneyim içi ayarlar menüsünden kullanıcı tarafından ayarlanabilecek bir ayarı yansıtır; Arka Plan Saydamlığı aracılığıyla deneyim içi ayarlar menüsünde.Varsayılan değer 1'dir, kullanıcının varsayılan arka plan saydamlığını tercih ettiğini gösterir.En düşük değer 0'dur, kullanıcının arka planların tamamen opak olmasını tercih ettiğini gösterir ve etkilenen UI için okunabilirliği ve kontrastı artırır.Bir elemanın değerini 'dan dönen değerle çarpmak, bu ayarı kullanmanın önerilen yoludur; arka planlar 0'a yaklaştıkça daha opak hale gelecektir.Kullanıcı tercihli gizliliğini değiştirdiğinde otomatik olarak güncellenmesi için Object:GetPropertyChangedSignal() ile birlikte kullanılmalıdır.

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

Kullanıcı azaltılmış hareketi etkinleştirdiğinde true döndürür, varsayılan olarak false .

Bu dönüş değeri, uygulama ayarlarından veya deneyim içi ayarlar menüsünden kullanıcı tarafından ayarlanabilen bir ayarı yansıtır; Hareket Azaltma aracılığıyla deneyim içindeki ayarlar menüsünde.true değeri, kullanıcının hareket efektlerinin ve animasyonların azaltılmasını veya tamamen kaldırılmasını istediğini gösterir.

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

GUI Navigatörü tarafından şu anda odaklanan GuiObject setini ayarlar (Oyun Konsolları için kullanılır). Bu, ekran dışında olduğunda nil olarak sıfırlanabilir.

Bu özellik GuiObject.SelectionGained ve GuiObject.SelectionLost olayları tarafından değiştirilir.

Tüm GUI öğeleri için SeçimKazanılan ve SeçimKaybedilen olayları izlemeden bu özelliğin ne zaman değişeceğini belirlemek istiyorsanız, Changed etkinliğini kullanabilirsiniz.

local GuiService = game:GetService("GuiService")

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

GuiService.Changed:Connect(printChanged)

Roblox'un en sol kontrolleri ve cihazın güvenli alanının kenarı arasındaki boş alanı temsil eden bir Rect nesne döndürür.

Değer dinamiktir ve yerel oyuncunun Health özelliklerini değiştirmek, StarterGui:SetCoreGuiEnabled() kullanımı, Roblox UI Kontrollerinin boyutunu ve konumunu değiştirmek veya diğerleri gibi UI kontrollerinin görünürlüğüne bağlı olarak değişmesi beklenebilir.Bu nedenle, bu özelliğin değişikliklerini tespit edip Object:GetPropertyChangedSignal() ile tepki vermeniz önerilir.

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)

Dokunma kontrollerini etkinleştirmek ve dokunma kontrolü görüntüleme arayüzünü göstermek için kullanılır ve varsayılan değeri doğrudur.

Bu işlev, açıksa, bir LocalScript 'dan çalışırken Kontrol Menüsünü kapatır.

Ayrıca bakın:

• Avatar Kontrol Menüsü , Kontrol ve Satın Al özelliğinin daha ayrıntılı bir açıklamasını ve nasıl çalıştığını sağlayan bir makale
• GuiService:InspectPlayerFromHumanoidDescription() , bir geliştiricinin bu HumanoidDescription nesneye listelenen varlıkları gösteren İnceleme menüsünü getirmesine izin verir.Bu özellikle Roblox platformundaki bir oyuncunun avatarında giyilen şey oyuncunun oyundaki görünümüyle aynı olmayabilir durumlarda yararlıdır
• GuiService:InspectPlayerFromUserId() , Inspect Menüsünün görünmesine izin verir, kullanıcıya verilen UserId 'i gösterir.Bu, mevcut oyunda olmayan oyuncuları denetlemek istediğinizde özellikle yararlıdır

Dönüşler

Parametreler

Dönüşler

Oyuncu Emote menüsünün açık olup olmadığını gösteren bir boolean döndürür.

Geliştiriciler, GuiService:SetEmotesMenuOpen() fonksiyonunu çağırarak Emote menüsünü açabilir veya kapatabilir.

Dönüşler

Bu işlev, gameplay paused bildiriminin geliştirici tarafından devre dışı bırakılıp bırakılmadığını döndürür.

Geliştiriciler, GuiService:SetGameplayPausedNotificationEnabled() fonksiyonunu çağırarak bildirimi etkinleştirebilir veya devre dışı bırakabilir.

Ayrıca bakın:

• Workspace.StreamingIntegrityMode ve Enum.StreamingIntegrityMode oyun duraklatıldığında daha fazla ayrıntı için.

Dönüşler

Ekranın sol üst köşesinden ve sağ alt köşesinden kullanıcı arayüzlerinin piksel içine yerleştirilmesini temsil eden iki Vector2 değeri döndürür, sayısal olarak da ayrıca ekranın sol üst köşesinden ve sağ alt köşesinden.

Bu işlev tarafından sağlanan eklem değerleri yalnızca ScreenGuis özelliklerinin IgnoreGuiInset değeri false olarak ayarlanmış olanlara etki eder.

Dönüşler

Bu işlev, İncele ve Satın Al menü işlevlerinin şu anda etkin olup olmadığını döndürür.Özellik varsayılan olarak etkinleştirilir ve GuiService:SetInspectMenuEnabled() fonksiyonu kullanılarak ayarlanabilir.

Ayrıca bakın:

• Avatar Kontrol Menüsü , Kontrol ve Satın Al özelliğinin daha ayrıntılı bir açıklamasını ve nasıl çalıştığını sağlayan bir makale
• GuiService:InspectPlayerFromHumanoidDescription() , bir geliştiricinin bu HumanoidDescription nesneye listelenen varlıkları gösteren İnceleme menüsünü getirmesine izin verir.Bu özellikle Roblox platformundaki bir oyuncunun avatarında giyilen şey oyuncunun oyundaki görünümüyle aynı olmayabilir durumlarda yararlıdır
• GuiService:InspectPlayerFromUserId() , Inspect Menüsünün görünmesine izin verir, kullanıcıya verilen UserId 'i gösterir.Bu, mevcut oyunda olmayan oyuncuları denetlemek istediğinizde özellikle yararlıdır

Dönüşler

Bu işlev, bir geliştiricinin bu HumanoidDescription nesneye listelenen varlıkları gösteren İnceleme menüsünü getirmesine izin verir.

Bu, oyuncuların oyununuzdaki diğer oyuncuları incelerken Gözlem Menüsünde gösterilen şeyle daha fazla özelleştirmeye izin verir.Oyununuz oyuncuların ne giydiğini değiştiriyorsa, bunun yerine bir oyuncunun ne giydiğini temsil eden bir Inspeksiyon Menüsü nesnesi verebilir ve bu öğeler gösterilecektir.İncelenecek oyuncunun adını temsil etmek için bir isim de geçmelisiniz.

Ayrıca bakın:

• Avatar Kontrol Menüsü , Kontrol ve Satın Al özelliğinin daha ayrıntılı bir açıklamasını ve nasıl çalıştığını sağlayan bir makale
• GuiService:SetInspectMenuEnabled() , geliştiricilerin varsayılan İncele ve Satın Al işlevini etkinleştirmesine veya devre dışı bırakmasına izin verir
• GuiService:InspectPlayerFromUserId() , Inspect Menüsünün görünmesine izin verir, kullanıcıya verilen UserId 'i gösterir.Bu, mevcut oyunda olmayan oyuncuları denetlemek istediğinizde özellikle yararlıdır.

Parametreler

Dönüşler

local GuiService = game:GetService("GuiService")

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

GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")

Bu işlev, İnceleme Menisinin görünmesine izin verir, kullanıcıya verilen UserId 'yi gösterir.Bu, mevcut oyunda olmayan oyuncuları denetlemek istediğinizde özellikle yararlıdır.

Bu, belirtilen kullanıcının profilinde "Şu Anda Giyiliyor" sekmesindeki aynı bilgileri gösterir.

Ayrıca bakın:

• Avatar Kontrol Menüsü , Kontrol ve Satın Al özelliğinin daha ayrıntılı bir açıklamasını ve nasıl çalıştığını sağlayan bir makale
• GuiService:SetInspectMenuEnabled() , geliştiricilerin varsayılan İncele ve Satın Al işlevini etkinleştirmesine veya devre dışı bırakmasına izin verir.Bu özellikle Roblox platformundaki bir oyuncunun avatarında giyilen şey oyuncunun oyundaki görünümüyle aynı olmayabilir durumlarda yararlıdır
• GuiService:InspectPlayerFromHumanoidDescription() , bir geliştiricinin bu HumanoidDescription nesneye listelenen varlıkları gösteren İnceleme menüsünü getirmesine izin verir

Parametreler

Dönüşler

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

Müşteri Roblox'un UI'sinin özel bir versiyonu olan on ayak arayüzünü kullanıyorsa gerçek döndürür, konsollar için özel.Kullanıcının bir konsolda olup olmadığını doğrulamanın tek garantili yolu budur.

Dönüşler

Seçim yapıldığında, PlayerGui veya PlayerGui'nin bir soyundan gelen bir örnek seçimParent'a çağrıldığında, motor mevcut seçilebilir, görülebilir ve ekran üzerindeki tüm GuiObjectleri araştırır ve seçimParent'un soyundan gelen en küçük ile GuiObject'a ayarlar.

Parametreler

Dönüşler

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

Parametreler

Dönüşler

Oyuncu Emote menüsünü açar veya kapatır.

Parametreler

Dönüşler

Bu yöntem, geliştiricilerin bir oyuncunun oyun oynatması durdurulduğunda yerleşik bildirimi devre dışı bırakmasına izin verir.Daha sonra kendi UI'lerini özelleştirmek istediklerinde ekleyebilirler.

Geliştiriciler, bildirimin etkinleştirildiğini çağıran GuiService:GetGameplayPausedNotificationEnabled() fonksiyonuyla sorgulayabilir.

Ayrıca bakın:

• Workspace.StreamingIntegrityMode ve Enum.StreamingIntegrityMode oyun duraklatıldığında daha fazla ayrıntı için.

Parametreler

Dönüşler

Bu işlev, geliştiricilerin varsayılan İncele ve Satın Al işlevini etkinleştirmesini veya devre dışı bırakmasını sağlar.Bu, oyundaki özelliği devre dışı bırakmak istediğinizde, tümüyle veya oyunun bazı bölümlerinde (örneğin bir kesinti sahnesi) kullanışlıdır.Özellik varsayılan olarak etkinleştirilir.

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:

• Avatar Kontrol Menüsü , Kontrol ve Satın Al özelliğinin daha ayrıntılı bir açıklamasını ve nasıl çalıştığını sağlayan bir makale
• GuiService:InspectPlayerFromHumanoidDescription() , bir geliştiricinin bu HumanoidDescription nesneye listelenen varlıkları gösteren İnceleme menüsünü getirmesine izin verir.Bu özellikle Roblox platformundaki bir oyuncunun avatarında giyilen şey oyuncunun oyundaki görünümüyle aynı olmayabilir durumlarda yararlıdır
• GuiService:InspectPlayerFromUserId() , Inspect Menüsünün görünmesine izin verir, kullanıcıya verilen UserId 'i gösterir.Bu, mevcut oyunda olmayan oyuncuları denetlemek istediğinizde özellikle yararlıdır

Parametreler

Dönüşler

Kullanıcı Roblox coregui kaçış menüsünü kapattığında ateş eder.

Kullanıcı Roblox coregui kaçış menüsünü açtığında ateş eder.