화면 UI 컨테이너

컨테이너 는 프레임 , 레이블 , 버튼 등을 포함하여 플레이어의 화면에 표시하기 위해 합니다.모든 화면 UI 개체 및 코드는 클라이언트에 저장되고 변경됩니다.

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

경험에 참여하는 모든 플레이어에게 ScreenGui 및 그 자식 GuiObjects을 표시하려면 컨테이너 StarterGui 내에 배치하십시오.플레이어가 경험에 참여하고 캐릭터가 처음 생성될 때, ScreenGui 및 그 내용이 해당 플레이어의 컨테이너 내에 복제되어 PlayerGui 컨테이너에 배치됩니다. 이 컨테이너는 컨테이너 Players 내에 위치합니다.

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

기본적으로, 내부의 내부에서는 실행 중인 경험에서 그들의 모양과 위치를 시뮬레이션하는 3D 뷰포트 의 오버레이로 나타납니다.모든 이러한 화면 겹치기를 숨기려면 3D 뷰포트의 오른쪽 상단 모서리에 있는 시각화 옵션 위젯에서 GUI 오버레이 를 끄거나 UI 표시성 탭에서 끄거나 해야 합니다.

가 비활성화되면 의 콘텐츠가 호출될 때까지 복제되지 않습니다.

경험이 범위를 넓히면서 타이틀 화면, 설정 메뉴, 상점 인터페이스 등 여러 화면 인터페이스가 필요할 수 있습니다.이러한 경우 여러 고유한 컨테이너를 내부에 배치하고 각 컨테이너의 속성을 활성화 여부에 따라 전환할 수 있습니다( 동안 콘텐츠가 렌더링되지 않거나, 사용자 입력을 처리하거나, 변경에 대한 응답으로 업데이트되지 않음).

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

Enabled은 처음에 속성 창을 통해 전환할 수 있으며/또는 클라이언트 측 스크립트에서 플레이 시간 동안 설정할 수 있으며, 플레이어의 에 액세스하여 원하는 컨테이너(들)에 대해 PlayerGui으로 설정하거나 true 또는 false으로 설정할 수 있습니다.

여러 개의 ScreenGui 인터페이스를 사용할 때, 그들의 DisplayOrder 속성을 통해 Z‑인덱스로 레이어링할 수 있습니다.자세한 내용은 표시 순서를 참조하십시오.

컨테이너 속성

다음 속성을 사용하면 여러 장치에서 화면 삽입을 사용자 지정하고, 여러 화면 컨테이너를 사용하는 경우 표시 순서를 사용자 지정하고, 더 많은 작업을 수행할 수 있습니다.

화면 삽입

현대 휴대폰은 전체 화면을 활용하지만 일반적으로 화면 공간을 차지하는 노치, 컷아웃, 기타 요소를 포함합니다.모든 Roblox 경험에는 메인 메뉴, 채팅, 리더보드, 그리고 더 많은 것에 즉시 액세스할 수 있는 상단 표시줄 컨트롤도 포함됩니다.

Mobile device showing Roblox top bar buttons and device cutout.

플레이어가 모든 UI를 쉽게 볼 수 있고 장애물 없이 액세스할 수 있도록 Roblox는 속성을 제공하여 콘텐츠의 안전 영역 삽입을 제어합니다.

기본값인 CoreUISafeInsets는 모든 하위 요소를 GuiObjects 코어 UI 안전 영역 내에 유지하고, 상단 바 버튼과 기타 화면 잘라내기에서 제거합니다.이 설정은 대화형 UI 요소가 포함된 ScreenGui의 경우 권장됩니다.

Mobile device showing the core UI safe area.

표시 순서

여러 개의 ScreenGui 인터페이스를 사용할 때, 그들의 DisplayOrder 속성을 통해 Z‑인덱스로 레이어링할 수 있습니다.예를 들어, 경험의 메인 사용자 인터페이스 앞에 모달 설정 메뉸을 표시하려면 다른 경험의 기본 인터페이스보다 모달의 우선 순위를 높이는 을 할당하십시오.

스폰 시 재설정

부울 속성은 플레이어의 캐릭터가 재생성될 때마다 리셋(자체를 삭제하고 플레이어의 캐릭터로 다시 클론화)되는지 여부를 결정합니다.

조건	리셋
ResetOnSpawn 는 true (기본값).	yes
The ScreenGui 는 간접 하위 계열의 StarterGui ; 예를 들어, 그것은 내부에 위치한 Folder 내에 배치됩니다 StarterGui .	yes
는 및 는 직접 하위입니다.	no

플레이어 UI 액세스

참고한 대로, ScreenGui 를 부모로 지정하면 그것과 그 자식 StarterGui 을 플레이어의 GuiObjects 컨테이너에 복제하고 그들의 캐릭터가 경험에 참여하고 처음 스폰할 때 그것과 그 자식을 플레이어의 PlayerGui 컨테이너에 넣습니다.

플레이 시간 동안 플레이어의 UI 컨테이너를 제어해야 하는 경우, 예를 들어 특정 ScreenGui 또는 자식 중 하나를 표시하거나 숨기려면 다음과 같이 LocalScript에서 액세스하십시오:

로컬스크립트 - 플레이어에 액세스'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  -- 제목 화면 숨기기
settingsMenu.Enabled = true  -- Show settings menu

기본 UI 비활성화

모든 Roblox 경험에는 기본적으로 활성화된 여러 UI 요소가 포함됩니다.이러한 요소가 필요하지 않거나 자신의 창조물로 교체하려는 경우, 관련된 SetCoreGuiEnabled() 옵션이 있는 클라이언트 측 스크립트에서 Enum.CoreGuiType 메서드를 사용할 수 있습니다.

기본 UI	관련된 열거형
동적으로 업데이트된 Players, 일반적으로 리더보드로 사용됩니다.	Enum.CoreGuiType.PlayerList
문자의 Health 바. 문자의 Humanoid가 전체 체력에 있으면 나타나지 않습니다.	Enum.CoreGuiType.Health
배낭에 없는 캐릭터의 경험 도구 가 포함된 부분. 백팩에 없으면 나타나지 않음	Enum.CoreGuiType.Backpack
텍스트 채팅 창.	Enum.CoreGuiType.Chat
캐릭터의 팝업 메뉴 감정 표현.	Enum.CoreGuiType.EmotesMenu
플레이어의 관점이나 자신의 캐릭터 보기를 표시하는 창.플레이어가 Roblox 메뉴에서 자체 보기 를 활성화하지 않으면 나타나지 않습니다.	Enum.CoreGuiType.SelfView
화면 오른쪽에 있는 캡처 스크린샷 버튼.플레이어가 Roblox 메뉴에서 캡처 를 활성화하지 않으면 나타나지 않습니다.	Enum.CoreGuiType.Captures

Core UI elements in every Roblox experience.

클라이언트 스크립트 - 기본 UI 요소 비활성화
local StarterGui = game:GetService("StarterGui")

-- 기본 건강 바와 백팩 비활성화
StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.Health, false)
StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.Backpack, false)

또한 터치 기능이 있는 장치에는 기본적으로 가상 썸스틱과 점프 버튼이 포함됩니다.원하는 경우 클라이언트 측 스크립트에서 GuiService.TouchControlsEnabled를 false로 설정하여 이러한 요소를 숨길 수 있습니다.

UI elements for touch-capable devices in every Roblox experience

클라이언트 스크립트 - 터치 컨트롤 비활성화
local GuiService = game:GetService("GuiService")

GuiService.TouchControlsEnabled = false