Auf-Bildschirm-UI-Container

Der ScreenGui -Container enthält GuiObjects , um auf dem Bildschirm eines Spieler:inangezeigt zu werden, einschließlich Frames , Labels , Buttons und mehr.Alle auf dem Bildschirm angezeigten UI-Objekte und Code werden auf dem Client gespeichert und geändert.

Example ScreenGui with various GuiObject children, including a Frame, TextLabel, TextBox, and ImageButton.

Um ein ScreenGui und sein Kind GuiObjects jedem Spieler anzuzeigen, der sich der Erfahrung anschließt, platzieren Sie es im StarterGui -Container.Wenn ein Spieler einem Erlebnis beitritt und sein Charakter zuerst erscheint, klont der ScreenGui und seine Inhalte in den PlayerGui -Container für diesen Spieler:in, der sich innerhalb des Players -Containers befindet.

Diagram of how a ScreenGui clones from StarterGui to a player's PlayerGui

Standardmäßig erscheinen GuiObjects innerhalb einer ScreenGui innerhalb von StarterGui als Überlagerung der 3D-Ansichtsfenster, die ihr Aussehen und ihre Position in einer laufenden Erlebnissimuliert.Um alle solchen Bildschirmüberlagerungen auszublenden, schalte GUI-Überlagerung aus dem Widget Visualisierungsoptionen in der oberen rechten Ecke des 3D-Ansichtsfensters oder schalte UI-Sichtbarkeit aus der Registerkarte Ansicht aus.

Wenn Players.CharacterAutoLoads deaktiviert ist, werden die Inhalte von StarterGui nicht geklont, bis Player:LoadCharacter() aufgerufen wird.

Wenn sich ein Erlebnis im Umfang erweitert, benötigen Sie möglicherweise mehrere Bildschirmoberflächen wie einen Titelbildschirm, ein Einstellungsmenü, einen Shop-Bildschirm und mehr.In solchen Fällen kannst du mehrere einzigartige ScreenGui Container innerhalb von StarterGui platzieren und die Eigenschaft eines jeden Containers Enabled abschalten, abhängig davon, ob er sichtbar und aktiv sein soll (während false Inhalte nicht gerendert, der Benutzerinput verarbeitet oder aktualisiert wird, in Reaktion auf Änderungen).

Explorer hierarchy showing multiple ScreenGui containers, one enabled and the others disabled, in order to control which are visible at a given time.

Die Eigenschaft kann zunächst durch das Eigenschaften-Fenster umgeschaltet werden, und/oder kann sie während der Spielzeit durch ein Client-Skript von zugänglich gemacht werden, um den gewünschten Container(en) auf oder festzulegen.

Wenn Sie mehrere ScreenGui-Schnittstellen verwenden, können Sie sie durch ihren Eigenschaftenzuschichten.Siehe Anzeigereihenfolge für weitere Informationen.

Conteneer-Eigenschaften

Die folgenden Eigenschaften lassen dich den Bildschirm einfügen über mehrere Geräte anpassen, die Anzeigereihenfolge beim Einsatz mehrerer Bildschirmelemente und mehr.

Bildschirm-Einsätze

Moderne Telefone nutzen den gesamten Bildschirm, aber sie enthalten in der Regel Abstände, Auschnitte und andere Elemente, die den Platzeinnehmen.Jedes Roblox-Erlebnis enthält auch die oberen Menüsteuerelemente für einen schnellen Zugriff auf das Hauptmenü, Chat, Bestenliste und mehr.

Mobile device showing Roblox top bar buttons and device cutout.

Um sicherzustellen, dass Spieler alle UI einfach und ohne Hindernis sehen und zugreifen können, bietet Roblox die ScreenInsets, die die sichere Bereich -Einsätze für den Inhalt eines ScreenGui steuert.

Die Standardversion von CoreUISafeInsets behält alle Nachkommen GuiObjects innerhalb des Kern-UI-Sicherheitsbereichs, frei von den oberen Toolbar-Buttons und anderen Bildschirmabschnitten.Diese Einstellung wird empfohlen, wenn die ScreenGui interaktive UI-Elemente enthält.

Mobile device showing the core UI safe area.

Anzeigereihenfolge

Wenn Sie mehrere ScreenGui-Schnittstellen verwenden, können Sie sie durch ihren Eigenschaftenzuschichten.Zum Beispiel, um ein Modal-Einstellungsmenü auf einem vor dem Hauptnutzeroberfläche der Erlebnisauf einem anderen anzuzeigen, weise einen höheren dem Modal als der unterliegenden Schnittstelle zu.

Zurücksetzen beim Spawn

Die ResetOnSpawn boolesche Eigenschaft bestimmt, ob die ScreenGui Wiederherstellungen (sich selbst zurücksetzt und in den Charakter des Spieler:inPlayerGui klont) jedes Mal, wenn der Charakter des Spieler:inwieder erscheint.

Bedingung	Wiederherstellungen
ResetOnSpawn ist true (standard).	yes
Die ScreenGui ist eine indirekte Abkömmling von StarterGui ; zum Beispiel wird sie in einem Folder platziert, das sich innerhalb von StarterGui befindet.	yes
ist und der ist ein direkter nachkomme von .	no

Zugriff auf Spieler-UI

Wie bemerkt, pflegen ein ScreenGui zu StarterGui Klone und sein Kind GuiObjects in einen Spieler:inPlayerGui -Container, wenn sie sich der Erfahrung anschließen und ihr Charakter zuerst spawnet.

Wenn du während der Spielzeit den UI-Container eines Spieler:insteuern musst, zum Beispiel um ein bestimmtes ScreenGui oder eines seiner Kinder anzuzeigen/auszublenden, greife darauf wie folgt von einem LocalScript zu:

LocalScript - Zugriff auf einen Spieler's UI
local Players = game:GetService("Players")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui

local titleScreen = playerGui:WaitForChild("TitleScreen")
local settingsMenu = playerGui:WaitForChild("SettingsMenu")

titleScreen.Enabled = false  -- Titelbildschirm ausblenden
settingsMenu.Enabled = true  -- Show settings menu

Standard-UI deaktivieren

Alle Roblox-Erlebnisse enthalten mehrere UI-Elemente, die standardmäßig aktiviert sind.Wenn du keines dieser Elemente benötigst oder sie durch eigene Kreationen ersetzen möchtest, kannst du die SetCoreGuiEnabled()-Methode in einem Client-Skript mit der zugeordneten Enum.CoreGuiType-Option verwenden.

Standard-Oberfläche	Verknüpfte Enum
Dynamisch aktualisierte Players, die häufig als Bestenliste verwendet wird.	Enum.CoreGuiType.PlayerList
Die Leiste des Charakters Health. Es erscheint nicht, wenn die Gesundheit des Charakters Humanoid voll ist.	Enum.CoreGuiType.Health
Die Zeichen Backpack, die Erfahrungswerkzeuge enthält. Taucht nicht auf, wenn es keine Tools im Rucksack gibt.	Enum.CoreGuiType.Backpack
Das Text-Chat-Fenster.	Enum.CoreGuiType.Chat
Pop-up-Menü von Charakter Emotes.	Enum.CoreGuiType.EmotesMenu
Ein Fenster, das die Perspektive oder den Blick eines Spieler:inauf seinen eigenen Charakter anzeigt.Es erscheint nicht, es sei denn, der Spieler hat Selbstansicht aus dem Roblox-Menü aktiviert.	Enum.CoreGuiType.SelfView
Eine Screenshot-Aufnahme Schaltfläche entlang der rechten Seite des Bildschirms.Es erscheint nicht, es sei denn, der Spieler hat Einfänge aus dem Roblox-Menü aktiviert.	Enum.CoreGuiType.Captures

Core UI elements in every Roblox experience.

Client-Skript - Standard-UI-Elemente deaktivieren
local StarterGui = game:GetService("StarterGui")

-- Standard-Gesundheitsleiste und -rucksack deaktivieren
StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.Health, false)
StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.Backpack, false)

Zusätzlich enthalten Geräte mit Touch-Funktionen standardmäßig einen virtuellen Daumenstick und einen Sprung-Button.Wenn gewünscht, können Sie diese Elemente ausblenden, indem Sie GuiService.TouchControlsEnabled in einem Skript, das. PL: die Skriptsauf false festlegen.

UI elements for touch-capable devices in every Roblox experience

Client-Skript - Berührungssteuerelemente deaktivieren
local GuiService = game:GetService("GuiService")

GuiService.TouchControlsEnabled = false