GuiService

활성화되면 Gamepad 또는 의 버튼은 GUI를 선택한 개체로 자동으로 설정합니다.이를 끄면 GuiService.GuiNavigationEnabled 가 활성화되어 있지만 Gui 탐색이 여전히 작동하지만 GuiService.SelectedObject 를 수동으로 설정해야만 Gui 탐색을 시작할 수 있습니다.

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

기본 컨트롤러 GUI 네비게이션을 활성화하고 비활성화하는 데 사용됩니다.

CoreGui의 메뉴 중 하나라도 열려 있으면 진실을 반환합니다.

사용자가 선호하는 투명도를 0에서 1 사이의 숫자로 가져와 사용자가 UI 요소의 배경을 얼마나 불투명하게 원하는지 나타냅니다.기본값은 1입니다.

이 반환 값은 앱 설정 또는 경험 내 설정 메뉴를 통해 사용자 측에서 설정할 수 있는 설정을 반영합니다. 배경 투명도 를 통해.기본값은 1로, 사용자가 기본 배경 투명도를 선호한다는 것을 나타냅니다.가장 낮은 값은 0으로, 사용자가 배경을 완전히 불투명하게 선호하여 영향을 받는 UI의 가독성과 대비를 향상시킨다는 것을 나타냅니다.요소의 를 반환된 값으로 곱하는 것은 이 설정을 사용하는 권장되는 방법입니다; 배경은 0에 가까워질수록 불투명해집니다.이는 사용자가 기본 투명도를 변경할 때 자동으로 업데이트되도록 Object:GetPropertyChangedSignal()와 함께 사용해야 합니다.

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()

사용자가 감소된 모션을 활성화한 경우 true 를 반환하고, 기본값은 false 입니다.

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

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

GUI 탐색기(게임패드용)에서 현재 집중하고 있는 GuiObject 세트를 설정합니다. 개체가 화면 밖에 있으면 nil로 재설정될 수 있습니다.

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

모든 GUI 요소에 대한 SelectionGained 및 SelectionLost 이벤트를 추적하지 않고 이 속성이 언제 변경되는지 확인하려는 경우 Changed 이벤트를 사용할 수 있습니다.

local GuiService = game:GetService("GuiService")

local function printChanged(value)
	if value == "SelectedObject" then
		print("The SelectedObject changed!")
	end
end

GuiService.Changed:Connect(printChanged)

Roblox 최상위 컨트롤과 기기 보안 영역 가장자리 사이의 비어있는 영역을 나타내는 Rect 개체를 반환합니다.

값은 동적이며 로컬 플레이어의 Health 속성 변경, StarterGui:SetCoreGuiEnabled() 사용, Roblox UI 컨트롤의 크기와 위치 변경 및/또는 기타 요인에 따라 변경될 수 있습니다.이러한 이유로, 이 속성의 변경을 Object:GetPropertyChangedSignal()로 감지하고 반응하는 것이 좋습니다.

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)

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

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

참조하세요:

• 아바타 검사 메뉴, 검사 및 구매 기능에 대한 자세한 설명과 작동 방법을 제공하는 기사
• GuiService:InspectPlayerFromHumanoidDescription() , 개발자가 이 HumanoidDescription 개체에 나열된 자산을 보여주는 검사 메뉴를 표시할 수 있도록 허용합니다.Roblox 플랫폼에서 플레이어의 아바타에 착용되는 것이 반드시 게임 내 모습과 동일하지 않은 경우 특히 유용합니다
• GuiService:InspectPlayerFromUserId() , 검사 메뉴가 나타나 지정된 UserId 을 가진 사용자를 표시할 수 있습니다.현재 게임에 없는 플레이어를 검사하려는 경우 특히 유용합니다

반환

매개 변수

반환

플레이어 감정 표현 메뉴가 열려 있는지 여부를 나타내는 부울을 반환합니다.

개발자는 GuiService:SetEmotesMenuOpen() 함수를 호출하여 감정 표현 메뉴를 열거나 닫을 수 있습니다.

반환

이 함수는 개발자가 해당 알림을 비활성화했는지 여부를 반환합니다 gameplay paused.

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

참조하세요:

• Workspace.StreamingIntegrityMode 및 Enum.StreamingIntegrityMode 게임플레이가 일시 중지된 시기에 대한 자세한 내용.

반환

화면의 왼쪽 상단 모서리와 오른쪽 하단 모서리에서 각각 사용자 GUI의 삽입을 나타내는 두 가지 Vector2을 반환합니다.

이 함수에서 제공하는 삽입 값은 속성 ScreenGuis가 false로 설정된 IgnoreGuiInset에만 적용됩니다.

반환

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

참조하세요:

• 아바타 검사 메뉴, 검사 및 구매 기능에 대한 자세한 설명과 작동 방법을 제공하는 기사
• GuiService:InspectPlayerFromHumanoidDescription() , 개발자가 이 HumanoidDescription 개체에 나열된 자산을 보여주는 검사 메뉴를 표시할 수 있도록 허용합니다.Roblox 플랫폼에서 플레이어의 아바타에 착용되는 것이 반드시 게임 내 모습과 동일하지 않은 경우 특히 유용합니다
• GuiService:InspectPlayerFromUserId() , 검사 메뉴가 나타나 지정된 UserId 을 가진 사용자를 표시할 수 있습니다.현재 게임에 없는 플레이어를 검사하려는 경우 특히 유용합니다

반환

이 함수를 사용하면 개발자가 이 HumanoidDescription 개체에 나열된 자산을 보여주는 검사 메뉴를 표시할 수 있습니다.

이렇게 하면 플레이어가 게임에서 다른 플레이어를 검사할 때 검사 메뉴에 표시된 것으로 추가 사용자 지정이 가능해집니다.게임이 플레이어가 착용하는 것을 수정하면, 대신 플레이어가 착용하고 있는 것을 나타내는 인스펙트 메뉴 개체를 제공하고 해당 아이템이 표시됩니다.검사할 플레이어의 이름을 나타내기 위해 이름도 전달해야 합니다.

참조하세요:

• 아바타 검사 메뉴, 검사 및 구매 기능에 대한 자세한 설명과 작동 방법을 제공하는 기사
• GuiService:SetInspectMenuEnabled() , 개발자가 기본 검사 및 구매 기능을 활성화하거나 비활성화할 수 있게 함
• GuiService:InspectPlayerFromUserId() , 검사 메뉴가 나타나 지정된 UserId 을 가진 사용자를 표시할 수 있습니다.현재 게임에 없는 플레이어를 검사하려는 경우 특히 유용합니다.

매개 변수

반환

local GuiService = game:GetService("GuiService")

local humanoidDescription = Instance.new("HumanoidDescription")
humanoidDescription.HatAccessory = "3339374070"
humanoidDescription.BackAccessory = "3339363671"

GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")

이 함수는 검사 메뉴가 나타나도록 하여 사용자에게 지정된 UserId 을 보여줍니다.현재 게임에 없는 플레이어를 검사하려는 경우 특히 유용합니다.

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

참조하세요:

• 아바타 검사 메뉴, 검사 및 구매 기능에 대한 자세한 설명과 작동 방법을 제공하는 기사
• GuiService:SetInspectMenuEnabled() , 개발자가 기본 검사 및 구매 기능을 활성화하거나 비활성화할 수 있도록 합니다.Roblox 플랫폼에서 플레이어의 아바타에 착용되는 것이 반드시 게임 내 모습과 동일하지 않은 경우 특히 유용합니다
• GuiService:InspectPlayerFromHumanoidDescription() , 개발자가 이 HumanoidDescription 개체에 나열된 자산을 보여주는 검사 메뉴를 표시할 수 있게 합니다

매개 변수

반환

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

클라이언트가 Roblox의 UI인 10피트 인터페이스를 사용하고 있으면 true를 반환하며, 이는 콘솔에만 독점적인 특별 버전입니다.이는 사용자가 콘솔에 있는지 여부를 확인하는 유일한 보장된 방법입니다.

반환

선택이 플레이어GUI 또는 플레이어GUI의 후손인 인스턴스 선택부모에 호출되면 엔진은 선택부모의 모든 사용 가능한 선택 가능한, 가시적 및 화면에 표시되는 Gui개체를 검색하고 가장 작은 를 가진 Gui개체로 설정합니다.

매개 변수

반환

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()

매개 변수

반환

플레이어 이모트 메뉴를 엽니다 또는 닫습니다.

매개 변수

반환

이 메서드를 사용하면 개발자가 플레이어의 게임플레이가 일시 중지될 때 기본 알림을 비활성화할 수 있습니다.그런 다음 사용자 지정하려는 경우 자체 UI를 추가할 수 있습니다.

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

참조하세요:

• Workspace.StreamingIntegrityMode 및 Enum.StreamingIntegrityMode 게임플레이가 일시 중지된 시기에 대한 자세한 내용.

매개 변수

반환

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

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

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

참조하세요:

• 아바타 검사 메뉴, 검사 및 구매 기능에 대한 자세한 설명과 작동 방법을 제공하는 기사
• GuiService:InspectPlayerFromHumanoidDescription() , 개발자가 이 HumanoidDescription 개체에 나열된 자산을 보여주는 검사 메뉴를 표시할 수 있도록 허용합니다.Roblox 플랫폼에서 플레이어의 아바타에 착용되는 것이 반드시 게임 내 모습과 동일하지 않은 경우 특히 유용합니다
• GuiService:InspectPlayerFromUserId() , 검사 메뉴가 나타나 지정된 UserId 을 가진 사용자를 표시할 수 있습니다.현재 게임에 없는 플레이어를 검사하려는 경우 특히 유용합니다

매개 변수

반환

사용자가 Roblox 코어 구이 에스케이프 메뉴를 닫을 때 발생합니다. fires when the user closes the Roblox coregui escape menu.

사용자가 Roblox 코어 구이 에스케이프 메뉴를 열면 발생합니다 fires when the user opens the Roblox coregui escape menu .