GuiService
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
GuiService は、開発者がゲームパッドナビゲーターによって現在選択されているもの、および Roblox のメインメニューが現在開いているかどうかをチェックできるようにします。
概要
プロパティ
有効にすると、ゲームパッドまたは Backslash の Select ボタンが自動的に GUI を選択したオブジェクトとして設定します。
CoreGui にあるオブジェクトがゲームパッドを使用してナビゲートできるかどうかを切り替えます。
デフォルトのコントローラーGUIナビゲーションを有効化/無効化するために使用します。
CoreGui のメニューが開いている場合は、真を返します。
ユーザーの好ましい透明度を 0 から 1 の数値として取得し、特定の UI 要素の背景をどれほど不透明にしたいかを示します。推奨される使用法は、要素の背景透明度の倍数としてです。デフォルトは 1 です。
ユーザーが減少モーションを有効にした場合は、true を返します。デフォルトは false です。
GUI ナビゲーター (ゲームパッド用) によって現在焦点が当てられている GuiObject を設定します。
トップバースペース内の障害のない領域の絶対サイズと位置を決定するのに使用されます。
タッチコントロールとタッチコントロールディスプレイ UI を有効化/無効化するために使用します。デフォルトは true です。
方法
インスペクトメニューを閉じ、開いている場合は
プレイヤーのエモートメニュが開いているかどうかをチェックします。
開発者によって gameplay paused 通知が無効になっているかどうかを返します。
画面の左上隅と右下隅それぞれから、ユーザーGUIの挿入を表す 2 つの Vector2 を返します。
インスペクトと購入メニュー機能が有効かどうかを返します。
開発者がこの HumanoidDescription オブジェクトにリストされたアセットを表示するインスペクトメニューを表示できるようにします。
インスペクトメニューが表示され、指定された UserId を持つユーザーを示すことができます。
クライアントが Roblox の UI の特別版である 10フィートインターフェイスを使用している場合、真を返します。これは、コンソール専用のものです。これは、ユーザーがコンソールにいるかどうかを確認する唯一の保証方法です。
GuiService.SelectedObject を PlayerGui またはその子孫の提供されたインスタンス選択親に設定します。
プレイヤーのエモートメニューを開くか閉じる。
開発者がプレイヤーのゲームプレイが一時停止したときに内蔵通知を無効にすることを許可します。
開発者がデフォルトのインスペクトと購入機能を有効化または無効化できるようにします。
イベント
ユーザーが Roblox コアGUIエスケープメニューを閉じる ときに発火します。
ユーザーが Roblox コアGUIエスケープメニューを開く ときに発火する
プロパティ
AutoSelectGuiEnabled
CoreGuiNavigationEnabled
GuiNavigationEnabled
MenuIsOpen
PreferredTextSize
PreferredTransparency
コードサンプル
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
コードサンプル
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
コードサンプル
local GuiService = game:GetService("GuiService")
local function printChanged(value)
if value == "SelectedObject" then
print("The SelectedObject changed!")
end
end
GuiService.Changed:Connect(printChanged)
TopbarInset
コードサンプル
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
方法
CloseInspectMenu
戻り値
InspectPlayerFromHumanoidDescription
パラメータ
戻り値
コードサンプル
local GuiService = game:GetService("GuiService")
local humanoidDescription = Instance.new("HumanoidDescription")
humanoidDescription.HatAccessory = "3339374070"
humanoidDescription.BackAccessory = "3339363671"
GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")
InspectPlayerFromUserId
パラメータ
戻り値
コードサンプル
local GuiService = game:GetService("GuiService")
GuiService:InspectPlayerFromUserId(772462)
Select
パラメータ
戻り値
コードサンプル
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()