GuiService

Pokaż przestarzałe

*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.

Brak możliwości tworzenia
Usługa
Bez replikacji

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

  • Odczyt równoległy

    Jeśli jest aktywowany, przycisk Select na Gamepadzie lub Backslash automatycznie ustawi GUI jako wybrany obiekt.

  • Ukryte
    Bez replikacji
    Odczyt równoległy

    Określa, czy obiekty w CoreGui można przeglądać za pomocą Gamepadu.

  • Odczyt równoległy

    Używany do włączenia i wyłączenia domyślnej nawigacji interfejsu kontrolera.

  • Tylko do odczytu
    Bez replikacji
    Odczyt równoległy

    Wróщает prawdę, jeśli menu CoreGui jest otwarte.

  • Tylko do odczytu
    Bez replikacji
    Odczyt równoległy
  • Ukryte
    Tylko do odczytu
    Bez replikacji
    Odczyt równoległy

    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.

  • Ukryte
    Tylko do odczytu
    Bez replikacji
    Odczyt równoległy

    Wyświetla true jeśli użytkownik włączył zmniejszone ruchy. Domyślnie ustawione na false.

  • Odczyt równoległy

    Ustawia GUIObject, na którym obecnie skupia się GUI Navigator (używany do Gamepadów).

  • Tylko do odczytu
    Bez replikacji
    Odczyt równoległy

    Używany do określenia absolutnej wielkości i położenia niezakłóconej obszarze w przestrzeni górnej krawędzi.

  • Odczyt równoległy

    Używany do włączania i dezaktywowania sterowania dotykowego i wyświetlania interfejsu użytkownika sterowania dotykowego. Domyślnie ustawione na prawdę.

Metody

Zdarzenia

Właściwości

AutoSelectGuiEnabled

Odczyt równoległy

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>

CoreGuiNavigationEnabled

Ukryte
Bez replikacji
Odczyt równoległy

Określa, czy obiekty w CoreGui można przeglądać za pomocą Gamepadu.

GuiNavigationEnabled

Odczyt równoległy

Używany do włączenia i wyłączenia domyślnej nawigacji interfejsu kontrolera.

Tylko do odczytu
Bez replikacji
Odczyt równoległy

Wróщает prawdę, jeśli menu Class.CoreGui jest otwarte.

PreferredTextSize

Tylko do odczytu
Bez replikacji
Odczyt równoległy

PreferredTransparency

Ukryte
Tylko do odczytu
Bez replikacji
Odczyt równoległy

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

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

Ukryte
Tylko do odczytu
Bez replikacji
Odczyt równoległy

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

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

Odczyt równoległy

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

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

Tylko do odczytu
Bez replikacji
Odczyt równoległy

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

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

Odczyt równoległy

Używany do włączania i dezaktywowania sterowania dotykowego i wyświetlania interfejsu użytkownika sterowania dotykowego. Domyślnie ustawione na prawdę.

Metody

CloseInspectMenu

void

Funkcja ta zamyka menu Inspect, jeśli jest otwarte, podczas uruchomienia z LocalScript .

Zobacz również:


Zwroty

void

DismissNotification

Parametry

notificationId: string

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ż:


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ż:


Zwroty

Boolean wskazujący, czy funkcja Inspekt Menu jest włączona.

InspectPlayerFromHumanoidDescription

void

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ż:

Parametry

humanoidDescription: Instance

Obiekt HumanoidDescription, który zawiera zasoby do pokazania w menu Inspect.

name: string

Nazwa gracza będącego Inspektowanym, aby wyświetlić w menu Inspect.


Zwroty

void

Przykłady kodu

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

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ż:

Parametry

userId: number

Class.Player.UserId|userId gracza do sprawdzenia.


Zwroty

void

Przykłady kodu

Opening the Inspect Menu for a UserId

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

void

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

selectionParent: Instance

Parent selekcji, który jest szukany.


Zwroty

void

Przykłady kodu

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

Parametry

notificationInfo: Dictionary

Zwroty

SetEmotesMenuOpen

void

Otwiera lub zamyka menu Emotikon gracza.

Parametry

isOpen: bool

Zwroty

void

SetGameplayPausedNotificationEnabled

void

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ż:

Parametry

enabled: bool

Czy GUI powiadomienia jest włączona lub nie.


Zwroty

void

SetInspectMenuEnabled

void

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ż:

Parametry

enabled: bool

Boolean wskazujący, czy chcesz włączyć lub wyłączyć funkcjaInspect Menu.


Zwroty

void

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.