GuiService

Artık kullanılmayanları göster

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Oluşturulamaz
Hizmet
Çoğaltılmamış

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.

  • Gizli
    Çoğaltılmamış
    Paralel oku

    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.

  • Salt Okunur
    Çoğaltılmamış
    Paralel oku

    CoreGui'nin herhangi bir menüsü açıksa geri döndürür.

  • Salt Okunur
    Çoğaltılmamış
    Paralel oku
  • Gizli
    Salt Okunur
    Çoğaltılmamış
    Paralel oku

    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.

  • Gizli
    Salt Okunur
    Çoğaltılmamış
    Paralel oku

    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.

  • Salt Okunur
    Çoğaltılmamış
    Paralel oku

    Ü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

Etkinlikler

Özellikler

AutoSelectGuiEnabled

Paralel oku

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

Gizli
Çoğaltılmamış
Paralel oku

Oyunpad kullanarak objelerin CoreGui içinde gezilebilir olup olmadığını ayarlar.

GuiNavigationEnabled

Paralel oku

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

Salt Okunur
Çoğaltılmamış
Paralel oku

Açık bir CoreGui menüsü varsa geri döndürür.

PreferredTextSize

Salt Okunur
Çoğaltılmamış
Paralel oku

PreferredTransparency

Gizli
Salt Okunur
Çoğaltılmamış
Paralel oku

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

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

Gizli
Salt Okunur
Çoğaltılmamış
Paralel oku

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

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

Paralel oku

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

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

Salt Okunur
Çoğaltılmamış
Paralel oku

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

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

Paralel oku

Dokunmatik kontrolleri etkinleştirmek ve kapatmak için kullanılır.Varsayılan doğru.

Yöntemler

CloseInspectMenu

void

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

void

DismissNotification

Parametreler

notificationId: string

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:


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

void

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

humanoidDescription: Instance

İnspect menüsünde gösterilecek varlıkları gösteren bir HumanoidDescription nesnesi.

name: string

İnceleme menüsünde gösterilecek oyuncunun ismi.


Dönüşler

void

Kod Örnekleri

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

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:

Parametreler

userId: number

İnceleyeceğiniz oyuncunun UserId kimliği.


Dönüşler

void

Kod Örnekleri

Opening the Inspect Menu for a UserId

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

void

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

selectionParent: Instance

Araştırılanların aşçıları olan seçimin ebeveyni.


Dönüşler

void

Kod Örnekleri

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

Parametreler

notificationInfo: Dictionary

Dönüşler

SetEmotesMenuOpen

void

Oyuncu Emoteleri menüsünü açar veya kapar.

Parametreler

isOpen: bool

Dönüşler

void

SetGameplayPausedNotificationEnabled

void

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:

Parametreler

enabled: bool

Yerleşik bildirim GUI'si etkin değil.


Dönüşler

void

SetInspectMenuEnabled

void

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

enabled: bool

İnceleme Menüsü özelliketkinleştirmek veya devre dışı bırakmak için bir boBoolean.


Dönüşler

void

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.