GuiService

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

만들 수 없음
서비스
복제되지 않음

GUIService 는 게임 패드 탐색기가 현재 GuiObject를 선택하고 있으며 Roblox의 메인 메뉴가 현재 열려 있는지 여부를 확인하는 데 사용자 정의 버튼을 사용하는 것을 허용합니다.

요약

속성

  • 활성화되면 게임 패드의 Select 버튼이나 백스플래시 에 자동으로 GUI를 선택한 개체로 설정됩니다.

  • 숨김
    복제되지 않음
    병렬 읽기

    게임 패드를 사용하여 개체를 CoreGui 내에서 탐색할 수 있는지 여부를 토글합니다.

  • 기본 컨트롤러 GUI 탐색을 활성화하고 비활성화합니다.

  • 읽기 전용
    복제되지 않음
    병렬 읽기

    CoreGui의 메뉴가 열려 있으면 true를 반환합니다.

  • 읽기 전용
    복제되지 않음
    병렬 읽기
  • 숨김
    읽기 전용
    복제되지 않음
    병렬 읽기

    0에서 1 사이의 숫자로 사용자의 선호 투명도를 얻습니다. 이는 특정 UI 요소의 배경을 얼마나 불투명하게 하고 싶은지 나타냅니다. 기본 사용은 요소의 배경 투명도를 배수로 사용합니다. 기본값은 1입니다.

  • 숨김
    읽기 전용
    복제되지 않음
    병렬 읽기

    사용자가 감소된 이동을 활성화하면 true 반환합니다. 기본값은 false입니다.

  • 게임 패드에 사용되는 GUI 탐색기에 현재 집중되는 GuiObject를 설정합니다.

  • 읽기 전용
    복제되지 않음
    병렬 읽기

    상단 표시줄 공간의 왼쪽 크기 및 위치를 결정하는 데 사용됩니다.

  • 터치 컨트롤 및 터치 컨트롤 디스플레이 UI를 활성화하고 비활성화하는 데 사용됩니다. 기본값은 true입니다.

메서드

이벤트

속성

AutoSelectGuiEnabled

병렬 읽기

활성화되면 Gamepad의 Select 버튼이나 Backslash 가 자동으로 GUI를 선택한 개체로 설정됩니다. 이것을 끄면 게이 탐색이 여전히 작동하지만 GuiService.GuiNavigationEnabled 가 활성화되면 수동으로 1> Class.GuiService.

CoreGuiNavigationEnabled

숨김
복제되지 않음
병렬 읽기

게임 패드를 사용하여 개체를 CoreGui 내에서 탐색할 수 있는지 여부를 토글합니다.

GuiNavigationEnabled

병렬 읽기

기본 컨트롤러 GUI 탐색을 활성화하고 비활성화합니다.

읽기 전용
복제되지 않음
병렬 읽기

Class.CoreGui의 메뉴가 열려 있으면 모든 경우 트루가 반환됩니다.

PreferredTextSize

읽기 전용
복제되지 않음
병렬 읽기

PreferredTransparency

숨김
읽기 전용
복제되지 않음
병렬 읽기

사용자의 선호 투명도를 0에서 1 사이의 숫자로 나타냅니다. 기본값은 1입니다.

코드 샘플

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

숨김
읽기 전용
복제되지 않음
병렬 읽기

사용자가 감소된 이동을 활성화하면 true 반환합니다. 기본값은 false입니다.

이 반환 값은 앱 설정 또는 경험 내 설정 메뉴를 통해 사용자 측에서 설정할 수 있는 설정을 반영합니다. 이동 감소를 통해 사용자가 이동 효과 및 애니메이션을 줄이거나 완전히 제거하려는 것을 나타냅니다.

코드 샘플

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

병렬 읽기

게임 패드에 사용되는 GUI 탐색기에 현재 GuiObject 를 초점으로 설정합니다. 오브젝트가 스크린 밖에 있으면 이 값이 0으로 재설정될 수 있습니다.

이 속성은 GuiObject.SelectionGainedGuiObject.SelectionLost 이벤트에 의해 변경됩니다.

모든 GUI 요소에 대해 선택 얻은 및 선택 잃은 이벤트를 추적하지 않고 속성이 변경된 시간을 결정하려면 Changed 이벤트를 사용할 수 있습니다.

코드 샘플

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

읽기 전용
복제되지 않음
병렬 읽기

Roblox 왼쪽 최대 컨트롤과 장치 안전 영역 사이의 비워진 영역을 나타내는 Rect 개체를 반환합니다.

값은 시각적 개체 플레이어가시성에 따라 변경될 수 있으므로 예상되는 변경에 대응하기 위해 기대됩니다. Health 속성, StarterGui:SetCoreGuiEnabled() 사용 및/또는 기타

코드 샘플

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

병렬 읽기

터치 컨트롤 및 터치 컨트롤 디스플레이 UI를 활성화하고 비활성화하는 데 사용됩니다. 기본값은 true입니다.

메서드

CloseInspectMenu

void

이 함수는 LocalScript에서 실행할 때 검사 메뉴를 닫습니다.

또한 참조하십시오.

  • 아바타 검사 메뉴, 검사 및 구매 기능에 대한 자세한 설명을 제공하는 기사입니다.
  • GuiService:InspectPlayerFromHumanoidDescription() , 개발자가 이 HumanoidDescription 개체에 나열된 자산을 보여주는 검사 메뉴를 표시하는 개발 도구를 사용하여 플레이어의 아바타에 착용되는 것이 아닌 경우 특히 유용합니다. 이 경우 플레이어의 모습
  • GuiService:InspectPlayerFromUserId() , 검사 메뉴가 표시되어 사용자가 지정된 UserId 를 가지고 있음을 표시합니다. 이 경우 현재 게임에 있지 않는 플레이어를 검사하려는 경우 특히 유용합니다.

반환

void

DismissNotification

매개 변수

notificationId: string

반환

GetEmotesMenuOpen

플레이어 이모티콘 메뉴가 열려 있는지 여부를 나타내는 Boolean을 반환합니다.

개발자는 GuiService:SetEmotesMenuOpen() 함수를 호출하여 이모티콘 메뉴를 열거나 닫을 수 있습니다.


반환

Emotes 메뉴가 열려 있는지 여부를 나타냅니다.

GetGameplayPausedNotificationEnabled

이 함수는 개발자가 게임 플레이 일시 중지|게임 플레이 일시 중지> 알림을 비활성화했는지 여부를 반환합니다.

개발자는 GuiService:SetGameplayPausedNotificationEnabled() 함수를 호출하여 알림을 활성화하거나 비활성화할 수 있습니다.

또한 참조하십시오.


반환

Class.Player.GameplayPaused|gameplaypause 알림이 비활성화되었는지 여부.

GetGuiInset

화면의 왼쪽 상단 모서리와 화면의 오른쪽 하단 모서리를 각각 대표하는 두 개의 Vector2 값을 반환합니다.

이 함수가 제공하는 인서트 값은 ScreenGuis 의 속성 집합을 가진 IgnoreGuiInset 에만 적용됩니다.


반환

현재 지정된 Gui 인서트에 대한 벡터 2 값 튜플.

GetInspectMenuEnabled

이 함수는 검사 및 구매 메뉴 기능이 현재 활성화되어 있는지 여부를 반환합니다. 기능은 기본적으로 활성화되어 있으며 GuiService:SetInspectMenuEnabled() 함수를 사용하여 설정할 수 있습니다.

또한 참조하십시오.

  • 아바타 검사 메뉴, 검사 및 구매 기능에 대한 자세한 설명을 제공하는 기사입니다.
  • GuiService:InspectPlayerFromHumanoidDescription() , 개발자가 이 HumanoidDescription 개체에 나열된 자산을 보여주는 검사 메뉴를 표시하는 개발 도구를 사용하여 플레이어의 아바타에 착용되는 것이 아닌 경우 특히 유용합니다. 이 경우 플레이어의 모습
  • GuiService:InspectPlayerFromUserId() , 검사 메뉴가 표시되어 사용자가 지정된 UserId 를 가지고 있음을 표시합니다. 이 경우 현재 게임에 있지 않는 플레이어를 검사하려는 경우 특히 유용합니다.

반환

Inspect 메뉴 기능이 활성화되었는지 여부를 나타내는 부울입니다.

InspectPlayerFromHumanoidDescription

void

이 함수는 개발자가 이 HumanoidDescription 개체에 나열된 자산을 표시하는 검사 메뉴를 표시하도록 합니다.

이렇게 하면 플레이어가 다른 플레이어를 검사할 때 검사 메뉴에 표시되는 내용과 일치하는 자세한 사용자 지정이 가능합니다. 게임이 플레이어가 착용하고 있는 것을 수정하면 대신 검사 메뉴에 인간oidDescription 개체를 표시하여 플레이어가 착용하고 있는 것과 동일한

또한 참조하십시오.

매개 변수

humanoidDescription: Instance

Inspect 메뉴에 표시할 자산을 포함하는 HumanoidDescription 개체.

name: string

Inspect 메뉴에 표시하려는 플레이어의 이름입니다.


반환

void

코드 샘플

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

이 함수는 사용자에게 주어진 UserId 을 표시하는 검사 메뉴를 표시합니다. 이 은 특히 현재 게임에 있지 않은 플레이어를 검사할 때 유용합니다.

이 부분은 지정된 사용자의 프로필에 있는 "현재 착용 중" 탭과 동일한 정보를 표시합니다.

또한 참조하십시오.

매개 변수

userId: number

검사할 플레이어의 UserId입니다.


반환

void

코드 샘플

Opening the Inspect Menu for a UserId

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

IsTenFootInterface

Roblox10피트 인터페이스를 사용하는 경우 사용자가 콘솔에 있는지 여부는 확인하는 데 유일한 방법입니다. 이것은 사용자가 콘솔에 있는지 여부를 보장하는 유일한 방법입니다.


반환

Select

void

Select 는 PlayerGui 또는 PlayerGui의 하위인 선택 가능한 모든 인스턴스 선택Parent에 호출되면 엔진은 선택Parent와 하위인 모든 선택 가능한 표시 및 온-스크린 GuiObjects를 검색하고 GuiService.SelectedObject 를 GuiObject로 설정합니다. 가장 작은 GuiService.SelectionOrder .

매개 변수

selectionParent: Instance

내손자가 검색된 선택의 부모입니다.


반환

void

코드 샘플

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

매개 변수

notificationInfo: Dictionary

반환

SetEmotesMenuOpen

void

플레이어 이모티콘 메뉴를 엽니다.

매개 변수

isOpen: bool

반환

void

SetGameplayPausedNotificationEnabled

void

이 메서드를 사용하면 플레이어의 게임 플레이가 일시 중지된 경우 내장 알림을 비활성화할 수 있습니다. 그런 다음 원하는 경우 사용자 인터페이스를 사용자 정의할 수 있습니다.

개발자는 GuiService:GetGameplayPausedNotificationEnabled() 함수를 호출하여 알림이 활성화되었는지 여부를 쿼리할 수 있습니다.

또한 참조하십시오.

매개 변수

enabled: bool

내장 알림 가이드가 비활성화되었는지 여부.


반환

void

SetInspectMenuEnabled

void

이 함수는 개발자가 기본 검사 및 구매 기능을 활성화하거나 비활성화할 수 있게 합니다. 이 기능은 게임에서 특정 부분 또는 절차(예: 절단 장면)를 사용하는 경우 유용합니다. 이 기능은 기본적으로 활성화됩니다.

아래 코드 샘플은 게임에 대한 검사 메뉴를 비활성화하는 방법을 보여줍니다.


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

또한 참조하십시오.

  • 아바타 검사 메뉴, 검사 및 구매 기능에 대한 자세한 설명을 제공하는 기사입니다.
  • GuiService:InspectPlayerFromHumanoidDescription() , 개발자가 이 HumanoidDescription 개체에 나열된 자산을 보여주는 검사 메뉴를 표시하는 개발 도구를 사용하여 플레이어의 아바타에 착용되는 것이 아닌 경우 특히 유용합니다. 이 경우 플레이어의 모습
  • GuiService:InspectPlayerFromUserId() , 검사 메뉴가 표시되어 사용자가 지정된 UserId 를 가지고 있음을 표시합니다. 이 경우 현재 게임에 있지 않는 플레이어를 검사하려는 경우 특히 유용합니다.

매개 변수

enabled: bool

Inspect 메뉴 기능을 활성화하거나 비활성화하는 Boolean 표시.


반환

void

이벤트

사용자가 Roblox 코어 가이드 탈출 메뉴를 닫을 때 화재됩니다.


사용자가 Roblox 코어 가이드 탈출 메뉴를 엽니 시작합니다 면 화면이 나타납니다.