GuiService

Jeśli jest aktywowany, przycisk Select na Gamepadzie lub Backslash automatycznie ustawi interfejs jako wybrany obiekt.Wyłączenie tego oznacza, że nawigacja GUI nadal będzie działać, jeśli GuiService.GuiNavigationEnabled jest włączona, ale będziesz musiał ustawić GuiService.SelectedObject ręcznie, aby rozpocząć nawigację GUI.

Przełącza, czy obiekty w CoreGui można nawigować za pomocą Gamepada.

Używany do włączania i wyłączania domyślnej nawigacji GUI kontrolera.

Wyświetla prawdę, jeśli którekolwiek menu CoreGui jest otwarte.

Otrzymuje preferowaną przez użytkownika przejrzystość jako liczbę pomiędzy 0 a 1, która wskazuje, jak wiele bardziej niejasną chce być tła elementów interfejsu.Domyślnie 1.

Wartość zwrotna ta odzwierciedla ustawienie, które można ustawić z strony użytkownika w ustawieniach aplikacji lub w menu ustawień doświadczenia za pomocą przezroczystości tła .Domyślna wartość to 1, co oznacza, że użytkownik preferuje domyślną przejrzystość tła.Najniższa wartość to 0, co oznacza, że użytkownik preferuje, aby tła były całkowicie niedostępne, poprawiając czytelność i kontrast dla dotkniętej interfejsu użytkownika.Mnożenie elementu GuiObject.BackgroundTransparency z wartością zwróconą z PreferredTransparency jest zalecanym sposobem korzystania z tego ustawienia; tła staną się bardziej niejasne, gdy PreferredTransparency zbliży się do 0.Powinno to być używane z Object:GetPropertyChangedSignal(), aby automatycznie aktualizować się, gdy użytkownik zmienia preferowaną przejrzystość.

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

Wyświetla true jeśli użytkownik włączył zmniejszoną kinematykę. Domyślnie jest to false .

Wartość zwrotna ta odzwierciedla ustawienie, które można ustawić z strony użytkownika w ustawieniach aplikacji lub w menu ustawień doświadczenia za pośrednictwem Zmniejsz ruch .Wartość true wskazuje, że użytkownik chce, aby efekty ruchu i animacje zostały zredukowane lub całkowicie usunięte.

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

Ustawia GuiObject obecnie skupione przez nawigator GUI (używane do Gamepadów). Może to zostać zresetowane do nil jeśli obiekt jest poza ekranem.

Właściwość ta jest zmieniana przez wydarzenia GuiObject.SelectionGained i GuiObject.SelectionLost.

Jeśli chcesz określić, kiedy ta właściwość zmienia się bez śledzenia wydarzeń SelectionGained i SelectionLost dla wszystkich elementów interfejsu użytkownika, możesz użyć wydarzenia Changed.

local GuiService = game:GetService("GuiService")

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

GuiService.Changed:Connect(printChanged)

Zwraca obiekt Rect reprezentujący niezajętą strefę między najlewymi kontrolami Roblox i krawędzią bezpiecznej strefy urządzenia.

Wartość jest dynamiczna i można się spodziewać, że zmieni się w zależności od widoczności kontroli interfejsu użytkownika, takich jak zmiana właściwości lokalnego gracza Health, korzystanie z StarterGui:SetCoreGuiEnabled() , zmiana rozmiaru i pozycji kontroli interfejsu użytkownika Roblox oraz/lub innych.Z tego powodu zaleca się, aby wykryć i zareagować na zmiany tej właściwości za pomocą Object:GetPropertyChangedSignal() .

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)

Używany do włączania i wyłączania kontroli dotykowych i interfejsu wyświetlania kontroli dotykowych. Domyślnie ustawiony na prawdę.

Funkcja ta zamyka menu inspekcji, jeśli jest otwarte, podczas uruchamiania z LocalScript.

Zobacz także:

• Menu inspekcji awatara, artykuł zapewniający bardziej szczegółowe wyjaśnienie funkcji inspekcji i zakupu oraz sposobu jej działania
• GuiService:InspectPlayerFromHumanoidDescription() , pozwala programiście wyświetlić menu inspekcji pokazujące zasoby wymienione w tym obiekcie HumanoidDescription.Jest to szczególnie przydatne, gdy to, co jest noszone na awatarze gracza na platformie Roblox, nie musi być takie samo jak jego wygląd w grze
• GuiService:InspectPlayerFromUserId() , pozwala menu inspekcji pojawić się pokazując użytkownikowi, który ma podany UserId .Jest to szczególnie przydatne, gdy chcesz sprawdzić graczy, którzy nie są w obecnej grze

Zwroty

Parametry

Zwroty

Zwraca booleszny wskazujący, czy otwarte jest menu Emotki gracza, czy nie.

Twórcy mogą otworzyć lub zamknąć menu Emotki za pomocą funkcji GuiService:SetEmotesMenuOpen().

Zwroty

Funkcja ta zwraca, czy powiadomienie gameplay paused zostało wyłączone przez programistę, czy nie.

Twórcy mogą włączyć lub wyłączyć powiadomienie za pomocą funkcji GuiService:SetGameplayPausedNotificationEnabled().

Zobacz także:

• Workspace.StreamingIntegrityMode i Enum.StreamingIntegrityMode na temat szczegółów, kiedy gry są wstrzymywane.

Zwroty

Zwraca dwie wartości Vector2 reprezentujące wstawienie interfejsów użytkownika w pikselach, z lewej górnej części ekranu i z prawej dolnej części ekranu odpowiednio.

Wartości insercji dostarczone przez tę funkcję obowiązują tylko na ScreenGuis, które mają ustawioną właściwość IgnoreGuiInset na fałsz.

Zwroty

Funkcja ta zwraca, czy funkcjonalność menu Inspekcja i Kupowanie jest obecnie włączona.Funkcja jest włączona domyślnie i można ją ustawić za pomocą funkcji GuiService:SetInspectMenuEnabled().

Zobacz także:

• Menu inspekcji awatara, artykuł zapewniający bardziej szczegółowe wyjaśnienie funkcji inspekcji i zakupu oraz sposobu jej działania
• GuiService:InspectPlayerFromHumanoidDescription() , pozwala programiście wyświetlić menu inspekcji pokazujące zasoby wymienione w tym obiekcie HumanoidDescription.Jest to szczególnie przydatne, gdy to, co jest noszone na awatarze gracza na platformie Roblox, nie musi być takie samo jak jego wygląd w grze
• GuiService:InspectPlayerFromUserId() , pozwala menu inspekcji pojawić się pokazując użytkownikowi, który ma podany UserId .Jest to szczególnie przydatne, gdy chcesz sprawdzić graczy, którzy nie są w obecnej grze

Zwroty

Funkcja ta pozwala programiście wyświetlić menu inspekcji pokazujące zasoby wymienione w tym HumanoidDescription.

Umożliwia to dalszą personalizację z tym, co jest pokazane w menu inspekcji, gdy gracze inspekują innych graczy w twojej grze.Jeśli twoja gra zmienia to, co noszą gracze, możesz zamiast tego dać menu inspekcji obiekt HumanoidDescription, który reprezentuje to, co nosi gracz, a te przedmioty zostaną wyświetlone.Powinieneś przekazać nazwę również, aby reprezentować nazwę gracza, który zostanie sprawdzony.

Zobacz także:

• Menu inspekcji awatara, artykuł zapewniający bardziej szczegółowe wyjaśnienie funkcji inspekcji i zakupu oraz sposobu jej działania
• GuiService:SetInspectMenuEnabled() pozwala programistom włączyć lub wyłączyć domyślną funkcjonalność inspekcji i zakupu
• GuiService:InspectPlayerFromUserId() , pozwala menu inspekcji pojawić się pokazując użytkownikowi, który ma podany UserId .Jest to szczególnie przydatne, gdy chcesz sprawdzić graczy, którzy nie są w obecnej grze.

Parametry

Zwroty

local GuiService = game:GetService("GuiService")

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

GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")

Funkcja ta pozwala menu inspekcji pojawić się, pokazując użytkownikowi, który ma podany UserId.Jest to szczególnie przydatne, gdy chcesz sprawdzić graczy, którzy nie są w obecnej grze.

Pokazuje to te same informacje, co zakładka "Obecnie noszone" na profilu określonego użytkownika.

Zobacz także:

• Menu inspekcji awatara, artykuł zapewniający bardziej szczegółowe wyjaśnienie funkcji inspekcji i zakupu oraz sposobu jej działania
• GuiService:SetInspectMenuEnabled() pozwala programistom włączyć lub wyłączyć domyślną funkcjonalność inspekcji i zakupu.Jest to szczególnie przydatne, gdy to, co jest noszone na awatarze gracza na platformie Roblox, nie musi być takie samo jak jego wygląd w grze
• GuiService:InspectPlayerFromHumanoidDescription() , pozwala programiście wyświetlić menu inspekcji pokazujące zasoby wymienione w tym obiekcie HumanoidDescription

Parametry

Zwroty

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

Wyświetla prawdę, jeśli klient używa interfejsu dziesięciu stóp, który jest specjalną wersją interfejsu Roblox dla konsol.Jest to jedyny gwarantowany sposób weryfikacji, czy użytkownik jest na konsoli, czy nie.

Zwroty

Gdy wybór jest wzywany na instancji selekcjiParent, która jest PlayerGui lub potomkiem PlayerGui, silnik wyszukuje wszystkie dostępne wybieralne, widoczne i na ekranie obiekty Gui, które są potomkami selekcjiParent, i ustawia GuiService.SelectedObject na obiekt Gui z najmniejszym GuiService.SelectionOrder.

Parametry

Zwroty

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

Parametry

Zwroty

Otwiera lub zamyka menu Emotki gracza.

Parametry

Zwroty

Ta metoda pozwala programistom wyłączyć zintegrowane powiadomienie, gdy gra gracza jest wstrzymana.Następnie mogą dodać własną interfejs użytkownika, jeśli chcą go dostosować.

Twórcy mogą sprawdzić, czy powiadomienie jest włączone, wywołując funkcję GuiService:GetGameplayPausedNotificationEnabled().

Zobacz także:

• Workspace.StreamingIntegrityMode i Enum.StreamingIntegrityMode na temat szczegółów, kiedy gry są wstrzymywane.

Parametry

Zwroty

Funkcja ta pozwala programistom włączyć lub wyłączyć domyślną funkcjonalność inspekcji i zakupu.Jest to przydatne, gdy chcesz wyłączyć funkcję w swojej grze, całkowicie lub w pewnych częściach swojej gry (na przykład w scenie cięcia).Funkcja jest włączona domyślnie.

Poniższy przykład kodu pokazuje, jak wyłączyć menu inspekcji dla twojej gra:

local GuiService = game:GetService("GuiService")
GuiService:SetInspectMenuEnabled(false)

Zobacz także:

• Menu inspekcji awatara, artykuł zapewniający bardziej szczegółowe wyjaśnienie funkcji inspekcji i zakupu oraz sposobu jej działania
• GuiService:InspectPlayerFromHumanoidDescription() , pozwala programiście wyświetlić menu inspekcji pokazujące zasoby wymienione w tym obiekcie HumanoidDescription.Jest to szczególnie przydatne, gdy to, co jest noszone na awatarze gracza na platformie Roblox, nie musi być takie samo jak jego wygląd w grze
• GuiService:InspectPlayerFromUserId() , pozwala menu inspekcji pojawić się pokazując użytkownikowi, który ma podany UserId .Jest to szczególnie przydatne, gdy chcesz sprawdzić graczy, którzy nie są w obecnej grze

Parametry

Zwroty

Wystrzeliwuje, gdy użytkownik zamyka menu ucieczki z menu głównego Roblox.

Wystrzeliwuje, gdy użytkownik otwiera menu ucieczki z menu głównego Roblox.