GuiService
*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.
GuiService umożliwia programistom kontrolowanie tego, co GuiObject jest obecnie wybierane przez nawigator gamepadu, a также sprawdzenie, czy główny menu Roblox jest obecnie otwarty.
Podsumowanie
Właściwości
Jeśli jest aktywowany, przycisk Select na Gamepadzie lub Backslash automatycznie ustawi GUI jako wybrany obiekt.
Określa, czy obiekty w CoreGui można przeglądać za pomocą Gamepadu.
Używany do włączenia i wyłączenia domyślnej nawigacji interfejsu kontrolera.
Wróщает prawdę, jeśli menu CoreGui jest otwarte.
Otrzymuje preferowaną przez użytkownika przejrzystość jako liczbę pomiędzy 0 i 1, co wskazuje, jak niedostępne chcą być tło niektórych elementów interfejsu użytkownika. Domyślną użyciem jest mnożnik przepustnicy dla wybranego elementu. Domyślnie ustawione na 1.
Wyświetla true jeśli użytkownik włączył zmniejszone ruchy. Domyślnie ustawione na false.
Ustawia GUIObject, na którym obecnie skupia się GUI Navigator (używany do Gamepadów).
Używany do określenia absolutnej wielkości i położenia niezakłóconej obszarze w przestrzeni górnej krawędzi.
Używany do włączania i dezaktywowania sterowania dotykowego i wyświetlania interfejsu użytkownika sterowania dotykowego. Domyślnie ustawione na prawdę.
Metody
Zamknięuje menu Inspect, jeśli jest otwarte.
Sprawdza czy menu Emotikon gracza jest otwarte.
Wyświetla czy notyfikacja gameplay paused została wyłączona przez rozwój.
Zwraca dwa wartości Vector2, które reprezentują wszystkie wiersze użytkowników GUI w pikselach, od lewego górnego rogu ekranu i lewego górnego rogu ekranu odpowiednio.
Wyjaśnia, czy funkcjonalność menu Inspekt i Kup jest włączona.
Pozwala rozwijać menu Inspect, które pokazuje zasoby wymienione w tym obiekcie HumanoidDescription.
Pozwala na wyświetlenie menu inspekcji, które pokazuje użytkownik, który ma dany UserId .
Wróщает prawdę, jeśli klient używa interfejsu dziesięciu stóp, który jest specjalną wersją interfejsu Roblox'a, ekskluzywną dla konsol. Jest to jedyny gwarantowany sposób na sprawdzenie, czy użytkownik jest na konsoli lub nie.
Ustaw GuiService.SelectedObject jako dziecko dostępnej selekcji instancjiParent, które jest PlayerGui lub jego potomstwo.
Otwiera lub zamyka menu Emotikon gracza.
Pozwala rozwójcom wyłączyć wbudowaną notyfikację, gdy gra gracza jest wstrzymana.
Pozwala rozwójcom włączyć lub wyłączyć domyślną funkcjonalność Inspekt i Kup.
Zdarzenia
Wyst?puje, gdy u?yty zamkni? menu escape'u Roblox'a.
Wyst?puje, gdy u?yty otworzy otworzy menu ucieczki z kodu źród?owego Roblox.
Właściwości
AutoSelectGuiEnabled
Jeśli jest aktywowany, przycisk Select na Gamepadzie lub Backslash automatycznie ustawi interfejs grafy użytkownika jako wybrany obiekt. Włączanie tego wyłączy automatyczną nawigację GUI, jeśli GuiService.GuiNavigationEnabled jest włączone, ale musisz ręcznie ustawić 2>
GuiNavigationEnabled
Używany do włączenia i wyłączenia domyślnej nawigacji interfejsu kontrolera.
PreferredTextSize
PreferredTransparency
Otrzymuje preferowaną przez użytkownika przejrzystość jako liczbę pomiędzy 0 i 1, co wskazuje, jak bardziej nieskomplikowaną chcesz, aby była tło elementów interfejsu użytkownika. Domyślnie ustawione na 1.
Przykłady kodu
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
Wyświetla true jeśli użytkownik włączył zmniejszone ruchy. Domyślnie ustawione na false.
Ta wartość zwrotu odzwierciedla ustawienie, które można ustawić z strony użytkownika w either the app settings or within the in-experience settings menu via Reduce Motion . Wartość true wskazuje, że użytkownik chce, aby efekty i animacje ruchu zostały zmniejszone lub całkowicie usunięte.
Przykłady kodu
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
Ustawia GuiObject , który jest obecnie skupiony na przez GUI Navigator (używany do Gamepads). Może to zresetować do nil, jeśli obiekt jest off-screen.
To właściwość jest zmieniana przez wydarzenia GuiObject.SelectionGained i GuiObject.SelectionLost.
Jeśli chcesz określić, kiedy ta właściwość zmienia się bez śledzenia wydarzeń Wybrane i Wybrane dla wszystkich elementów GUI, możesz użyć wydarzenia Changed.
Przykłady kodu
local GuiService = game:GetService("GuiService")
local function printChanged(value)
if value == "SelectedObject" then
print("The SelectedObject changed!")
end
end
GuiService.Changed:Connect(printChanged)
TopbarInset
Zwraca obiekt Rect reprezentujący nie zajęty obszar między Roblox lewymi sterowaniami a krawędzią obszaru bezpieczeństwa urządzenia.
Wartość jest dynamiczna i może się zmieniać w zależności od widoczności sterowania UI, takich jak zmiana lokalnego gracza Health właściwości, użycie StarterGui:SetCoreGuiEnabled() , zmiana rozmiaru i pozycji sterowania Roblox UI, i/lub inne
Przykłady kodu
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
Używany do włączania i dezaktywowania sterowania dotykowego i wyświetlania interfejsu użytkownika sterowania dotykowego. Domyślnie ustawione na prawdę.
Metody
CloseInspectMenu
Funkcja ta zamyka menu Inspect, jeśli jest otwarte, podczas uruchomienia z LocalScript .
Zobacz również:
- Menu Inspect Avatar, artykuł zapewniający bardziej szczegółowe wyjaśnienie funkcji Inspect i Buy i jak działa
- GuiService:InspectPlayerFromHumanoidDescription() , umożliwia rozwinięcie menu Inspect, które pokazuje zasoby wymienione w tym HumanoidDescription obiekcie. To szczególnie przydatne, gdy to, co nosi na awatarze gracza na platformie Roblox, nie jest niezbędne do jego wyglądu w grze.
- GuiService:InspectPlayerFromUserId() , umożliwia inspektorowi menu wyświetlenie użytkownika, który ma podany UserId . Jest to szczególnie przydatne, gdy chcesz inspektować graczy, którzy nie są w obecnej grze
Zwroty
GetEmotesMenuOpen
Zwraca prawdziwy, wskazujący czy menu Emotikon gracza jest otwarte czy nie.
Rozwinięciu można otworzyć lub zamknąć menu Emotikon poprzez wezwanie funkcji GuiService:SetEmotesMenuOpen() .
Zwroty
Wskazuje, czy menu Emotki jest otwarte.
GetGameplayPausedNotificationEnabled
Funkcja ta weryfikuje, czy notyfikacja gameplay paused została wyłączona przez rozwiniętora.
Rozwój może włączyć lub wyłączyć powiadomienie, nazyając funkcję GuiService:SetGameplayPausedNotificationEnabled().
Zobacz również:
- Workspace.StreamingIntegrityMode i Enum.StreamingIntegrityMode dla więcej szczegółów na temat tego, kiedy gry wstrzymane są.
Zwroty
Czy notyfikacja gameplay paused była wyłączona.
GetGuiInset
Zwraca dwa wartości Vector2, które reprezentują wszystkie wiersze użytkowników GUI w pikselach, od lewego górnego rogu ekranu i lewego górnego rogu ekranu odpowiednio.
Zwartość wskaźników dostarczonych przez tę funkcję ma zastosowanie tylko do ScreenGuis, które mają ustawioną ich IgnoreGuiInset wartość właściwości na fałszywą.
Zwroty
Zestaw dwóch wartości Vector2 opisujący obecnie określony Gui Inset.
GetInspectMenuEnabled
Funkcja ta weryfikuje, czy funkcjonalność menu Inspektuj i Kup jest obecnie włączona. Funkcja jest włączona domyślnie i można ją ustawić używając funkcji GuiService:SetInspectMenuEnabled().
Zobacz również:
- Menu Inspect Avatar, artykuł zapewniający bardziej szczegółowe wyjaśnienie funkcji Inspect i Buy i jak działa
- GuiService:InspectPlayerFromHumanoidDescription() , umożliwia rozwinięcie menu Inspect, które pokazuje zasoby wymienione w tym HumanoidDescription obiekcie. To szczególnie przydatne, gdy to, co nosi na awatarze gracza na platformie Roblox, nie jest niezbędne do jego wyglądu w grze.
- GuiService:InspectPlayerFromUserId() , umożliwia inspektorowi menu wyświetlenie użytkownika, który ma podany UserId . Jest to szczególnie przydatne, gdy chcesz inspektować graczy, którzy nie są w obecnej grze
Zwroty
Boolean wskazujący, czy funkcja Inspekt Menu jest włączona.
InspectPlayerFromHumanoidDescription
Funkcja ta umożliwia rozwinięcie menu Inspect, które pokazuje zasoby wymienione w tym obiekcie HumanoidDescription.
Umożliwia to dalszą personalizację z tym, co pokazano w menu Inspect, gdy gracze inspektują innych graczy w Twojej grze. Jeśli Twoja gra zmienia to, co noszą gracze, możesz zamiast tego dać Inspect Menu obiekt HumanoidDescription, który przedstawia to, co nosi gracz i te przedmioty zostaną wyświetione. Powinieneś również przekazać imię, aby przedstawić imię gracza, którego będzie inspektowano.
Zobacz również:
- Menu Inspect Avatar, artykuł zapewniający bardziej szczegółowe wyjaśnienie funkcji Inspect i Buy i jak działa
- GuiService:SetInspectMenuEnabled() umożliwia programistom włączenie lub wyłączenie domyślnej funkcji Inspekt i Kup
- GuiService:InspectPlayerFromUserId() , umożliwia wyświetlenie menu Inspect, które pokazuje użytkownika, który ma podany UserId . Jest to szczególnie przydatne, gdy chcesz sprawdzić graczy, którzy nie są w obecnej grze.
Parametry
Obiekt HumanoidDescription, który zawiera zasoby do pokazania w menu Inspect.
Nazwa gracza będącego Inspektowanym, aby wyświetlić w menu Inspect.
Zwroty
Przykłady kodu
local GuiService = game:GetService("GuiService")
local humanoidDescription = Instance.new("HumanoidDescription")
humanoidDescription.HatAccessory = "3339374070"
humanoidDescription.BackAccessory = "3339363671"
GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")
InspectPlayerFromUserId
Funkcja ta pozwala na wyświetlenie menu inspekcji, które pokazuje użytkownik, który ma dany UserId. Jest to szczególnie przydatne, gdy chcesz inspektować graczy, którzy nie są w obecnej grze.
Pokaża to te same informacje co zakładka "Obecnie noszący" na profilu określonego użytkownika.
Zobacz również:
- Menu Inspect Avatar, artykuł zapewniający bardziej szczegółowe wyjaśnienie funkcji Inspect i Buy i jak działa
- GuiService:SetInspectMenuEnabled() , umożliwia programistom włączenie lub wyłączenie domyślnej funkcji Inspekt i Kupuj. Jest to szczególnie przydatne, gdy to, co jest noszone na awatarze gracza na platformie Roblox, nie jest niezbędne do jego wyglądu w grze.
- GuiService:InspectPlayerFromHumanoidDescription() umożliwia programistom otwarcie menu Inspect, które pokazuje zasoby wymienione w tym obiekcie HumanoidDescription
Parametry
Class.Player.UserId|userId gracza do sprawdzenia.
Zwroty
Przykłady kodu
local GuiService = game:GetService("GuiService")
GuiService:InspectPlayerFromUserId(772462)
IsTenFootInterface
Wróщает prawdę, jeśli klient używa interfejsu dziesięciu stóp, który jest specjalną wersją interfejsu Roblox'a, ekskluzywną dla konsol. Jest to jedyny gwarantowany sposób na sprawdzenie, czy użytkownik jest na konsoli lub nie.
Zwroty
Select
Gdy Select jest wyszwany na instancji selekcjiParent, który jest PlayerGui lub potomstwem PlayerGui, silnik szuka wszystkie dostępne wybieralne, widoczne i na ekranie GuiObjekty, które są potomstwami selekcjiParent i ustawia GuiService.SelectedObject na GuiObjekcie z najmniejszym GuiService.SelectionOrder .
Parametry
Parent selekcji, który jest szukany.
Zwroty
Przykłady kodu
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
Ten metod pozwala rozwójcom wyłączyć wbudowaną notyfikację, gdy gra gracza jest wstrzymana. Następnie mogą dodać własną interfejs użytkownika, jeśli chcą go dostosować.
Rozwój może zapytać, czy powiadomienie jest włączone, wywołując funkcję GuiService:GetGameplayPausedNotificationEnabled().
Zobacz również:
- Workspace.StreamingIntegrityMode i Enum.StreamingIntegrityMode dla więcej szczegółów na temat tego, kiedy gry wstrzymane są.
Parametry
Czy GUI powiadomienia jest włączona lub nie.
Zwroty
SetInspectMenuEnabled
Funkcja ta umożliwia rozwójom developoperom włączenie lub wyłączenie domyślnej funkcji Inspect i Buy. Ta funkcja jest przydatna, gdy chcesz wyłączyć funkcję w swojej gra, w całości lub podczas pewnych części swojej gry (takich jak scena). Funkcja jest włączona domyślnie.
Poniżej znajduje się przykładowy kod pokazujący, jak wyłączyć menu do sprawdzania dla swojej gra:
local GuiService = game:GetService("GuiService")GuiService:SetInspectMenuEnabled(false)
Zobacz również:
- Menu Inspect Avatar, artykuł zapewniający bardziej szczegółowe wyjaśnienie funkcji Inspect i Buy i jak działa
- GuiService:InspectPlayerFromHumanoidDescription() , umożliwia rozwinięcie menu Inspect, które pokazuje zasoby wymienione w tym HumanoidDescription obiekcie. To szczególnie przydatne, gdy to, co nosi na awatarze gracza na platformie Roblox, nie jest niezbędne do jego wyglądu w grze.
- GuiService:InspectPlayerFromUserId() , umożliwia inspektorowi menu wyświetlenie użytkownika, który ma podany UserId . Jest to szczególnie przydatne, gdy chcesz inspektować graczy, którzy nie są w obecnej grze
Parametry
Boolean wskazujący, czy chcesz włączyć lub wyłączyć funkcjaInspect Menu.
Zwroty
Zdarzenia
MenuClosed
Wyst?puje, gdy u?yty zamkni? menu escape'u Roblox'a.
MenuOpened
Wyst?puje, gdy u?yty otworzy otworzy menu ucieczki z kodu źród?owego Roblox.