GuiService
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
GUIService は、ゲームパッドナビゲーターが現在 GuiObject を選択していること、また、Roblox のメインメニューが現在開いているかどうかを確認することができます。
概要
プロパティ
有効にすると、Gamepad または Backslash 上の Select ボタンは自動的に GUI を選択したオブジェクトに設定します。
ゲームパッドを使用してオブジェクトをナビゲートできるかどうかを切り替えます。
デフォルトのコントローラーGUI ナビゲーションを有効におよび無効にします。
コアGUI のメニューが開いている場合、返します。
0 から 1 の間のユーザーの透明度を取得し、特定の UI 要素の背景を不明瞭にするためのオプションの一つを示します。推奨は、要素の背景を不明瞭にするための要素の背景透明度の乗数です。デフォルトは 1 です。
ユーザーが減速モーションを有効にした場合、true が返されます。デフォルトは false です。
GUI ナビゲーター (ゲームパッド用) に焦点が合っている GuiObject を設定します。
上部のバーのスペース内のアンオブストラクトエリアの相対サイズと位置を決定します。
タッチコントロールとタッチコントロールディスプレイ UI を有効にするために使用されます。デフォルトは、「はい」です。
方法
Inspect メニューを閉じます。
プレイヤーのエモートメニューが開いているかどうかをチェックします。
開発者がgameplay paused通知を無効にしたかどうかを返します。
スクリーンの左上隅から画面の右下隅まで、ユーザーGUIのインセットを表示する 2つの Vector2 値を返します。
Inspect と Buy メニュー機能が有効かどうかを返します。
この HumanoidDescription オブジェクトにリストされているアセットを示すインスペクトメニューを開発者が表示できるようにします。
ユーザーに与えられた UserId を表示するために、Inspect メニューを表示するようにします。
クライアントが 10 フィートインターフェイスを使用している場合、これは Roblox's UI の特別なバージョンで、コンソール限定です。これは、ユーザーがコンソールにいるかどうかを確認する唯一の保証された方法です。
Set GuiService.SelectedObject to a child of provided instance selectionParent がプレイヤーギュイをその子にする。
プレイヤーのエモートメニューを開くまたは閉じます。
プレイヤーのゲームプレイを一時停止したときに、開発者が内蔵の通知を無効にすることができます。
開発者がデフォルトの Inspect と Buy 機能を有効にまたは無効にすることができます。
イベント
ユーザーが Roblox コアGUIエスケープメニューを 閉じる ときに発動します。
ユーザーが Roblox コアGUI エスケープメニューを開く ときにファイア。
プロパティ
AutoSelectGuiEnabled
有効にすると、ゲームパッドの Select ボタンや Backslash を自動的にGUIに設定します。これをオフにすると、GUIナビゲーションが有効になりますが、GuiService.GuiNavigationEnabled を手動で設定する必要があります。
PreferredTextSize
PreferredTransparency
0 から 1 の数字の間のユーザーの透明度を取得し、UI 要素の背景をどれだけ不明瞭にしたいかを示します。デフォルトは 1 です。
コードサンプル
Uses the user's value for GuiService.PreferredTransparency by combining it with the desired default background transparency. Also automatically updates the background transparency whenever the user changes their 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 です。
この返却値は、アプリの設定またはインエクスペリエンスの設定メニューを介して、ユーザーの側から設定できる設定を反映します。この値は、モーションを減少 を通じて、ユーザーがモーションエフェクトとアニメーションを減少または完全に削除したいと望んでいることを示します。
コードサンプル
Uses the user's value for GuiService.ReducedMotionEnabled by instantly transitioning the frame instead of animating it, if the value of Reduced Motion is 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
SelectedObject
GUI ナビゲーター (ゲームパッド用) に焦点が合っている GuiObject を設定します。オブジェクトが画面外の場合、これは零にリセットされます。
このプロパティは GuiObject.SelectionGained と GuiObject.SelectionLost イベントによって変更されます。
Class.Object.Changed|Changed イベントを追跡しないで、選択取得済み および 選択損失 イベントを監視なしで、このプロパティが変更されるときを特定したい場合は、1>Class.Object.Changed|Changed1> イベントを使用できます。
コードサンプル
The code below demonstrates how to handle when the SelectedObject changes. For instance, this event fires when the Gamepad navigates to another GUI element.
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()、Roblox UI コントロールのサイズと位置の変更など、期待される値の変更に対応するた
コードサンプル
This code snippet creates a new ScreenGui with a Frame that automatically adapts its size and position to a top bar space unoccupied by Roblox UI.
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)
方法
CloseInspectMenu
この関数は、LocalScript から実行するとき、Inspect Menu を閉じます。
参照してください:
- アバターの調べるメニュー、Inspect と Buy 機能の詳細な説明と、作動方法を提供する記事
- GuiService:InspectPlayerFromHumanoidDescription() により、開発者はこの HumanoidDescription のアセットを示すアセットリストを表示するインスペクトメニューを開くことができます。これは特に、Roblox プラットフォームのプレイヤーのアバターの上に着用されているアイテムが必外見
- GuiService:InspectPlayerFromUserId() により、UserId が与えられたユーザーを表示するようになります。これは、現在のゲームでないプレイヤーを調べるときに特に便利です。
戻り値
GetEmotesMenuOpen
プレイヤーのエモートメニューが開いているかどうかを示すBooleanを返します。
開発者は、GuiService:SetEmotesMenuOpen() 関数を呼び出すことで、エモートメニューを開くか閉じることができます。
戻り値
エモートメニューが開いているかどうかを示します。
GetGameplayPausedNotificationEnabled
この関数は、 Class.Player.GameplayPaused|ゲームプレイを一時停止した|ゲームプレイを一時停止した] 通知が開発者によって無効にされているかどうかを返します。
開発者は、GuiService:SetGameplayPausedNotificationEnabled() 関数を呼び出して通知を有効にまたは無効にすることができます。
参照してください:
- Workspace.StreamingIntegrityMode と Enum.StreamingIntegrityMode は、ゲームプレイを一時停止するときの詳細について説明します。
戻り値
Class.Player.GameplayPaused|ゲームプレイを一時停止しました通知が無効になっているかどうか。
GetGuiInset
スクリーンの左上隅から画面の右下隅まで、ユーザーGUIのインセットを表示する 2つの Vector2 値を返します。
この関数によって提供されるインセット値は、 ScreenGuis のみに IgnoreGuiInset のプロパティセットを設定している場合にのみ有効になります。
戻り値
現在の Gui インセットを記述するベクトル 2 値のツープ。
GetInspectMenuEnabled
この関数は、Inspect と Buy メニュー機能が現在有効であるかどうかを返します。機能はデフォルトで有効になっており、GuiService:SetInspectMenuEnabled() 機能を使用して設定できます。
参照してください:
- アバターの調べるメニュー、Inspect と Buy 機能の詳細な説明と、作動方法を提供する記事
- GuiService:InspectPlayerFromHumanoidDescription() により、開発者はこの HumanoidDescription のアセットを示すアセットリストを表示するインスペクトメニューを開くことができます。これは特に、Roblox プラットフォームのプレイヤーのアバターの上に着用されているアイテムが必外見
- GuiService:InspectPlayerFromUserId() により、UserId が与えられたユーザーを表示するようになります。これは、現在のゲームでないプレイヤーを調べるときに特に便利です。
戻り値
Inspect メニュー機能が有効かどうかを示すブーレット。
InspectPlayerFromHumanoidDescription
この機能は、開発者がこの HumanoidDescription オブジェクトにリストされたアセットを表示するインスペクトメニューを表示することを許可します。
これにより、プレイヤーがゲームの他のプレイヤーを調べるときに示すものと、そのプレイヤーが着用しているものとのさらに多くのカスタマイズが可能になります。ゲームがプレイヤーが着用しているものを変更すると、代わりに Inspect メニューにヒューマノイドの説明オブジェクトを渡すことができます。これにより、プレ
参照してください:
- アバターの調べるメニュー、Inspect と Buy 機能の詳細な説明と、作動方法を提供する記事
- GuiService:SetInspectMenuEnabled() は、開発者がデフォルトの Inspect と Buy 機能を有効にまたは無効にすることができます
- GuiService:InspectPlayerFromUserId() により、UserId が与えられたユーザーを表示するようになります。これは、現在のゲームではないプレイヤーを調べるときに特に便利です。
パラメータ
Inspect メニューに表示するアセットを含むClass.HumanoidDescriptionオブジェクト。
Inspect メニューに表示するプレイヤーの名前。
戻り値
コードサンプル
This example demonstrates how to show an Inspect Menu containing two items (Midnight Antlers and Mid-Summer Starry Wings), for a player named MyPlayer using GuiService:InspectPlayerFromHumanoidDescription.
local GuiService = game:GetService("GuiService")
local humanoidDescription = Instance.new("HumanoidDescription")
humanoidDescription.HatAccessory = "3339374070"
humanoidDescription.BackAccessory = "3339363671"
GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")
InspectPlayerFromUserId
この関数は、ユーザーが UserId を持っていることを示すインスペクトメニューを表示することができます。これは、現在のゲームでないプレイヤーを調べるときに特に便利です。
これは、指定されたユーザーのプロフィールの「現在着用中」タブと同じ情報を表示します。
参照してください:
- アバターの調べるメニュー、Inspect と Buy 機能の詳細な説明と、作動方法を提供する記事
- GuiService:SetInspectMenuEnabled() は、開発者がデフォルトのInspect と Buy 機能を有効にまたは無効にすることができます。これは、Roblox プラットフォームのプレイヤーのアバターに装備されているものと同じではありませんが、特にゲーム内の見た外見と同じではありません。
- GuiService:InspectPlayerFromHumanoidDescription() により、開発者はこの HumanoidDescription オブジェクトにリストされたアセットを表示するインスペクトメニューを開くことができます
パラメータ
Class.Player.UserId|userId のプレイヤーを調べる。
戻り値
コードサンプル
The code sample below demonstrates how to use GuiService:InspectPlayerFromUserId() to open the Inspect Menu for the Roblox user with the id 772462.
local GuiService = game:GetService("GuiService")
GuiService:InspectPlayerFromUserId(772462)
IsTenFootInterface
クライアントが 10 フィートインターフェイスを使用している場合、これは Roblox's UI の特別なバージョンで、コンソール限定です。これは、ユーザーがコンソールにいるかどうかを確認する唯一の保証された方法です。
戻り値
Select
Select は、PlayerGui または PlayerGui の子孫である選択可能な子グリッドオブジェクトのインスタンス選択Parent を呼び出すと、エンジンは選択可能な子グリッドオブジェクトをすべて検索し、GuiService.SelectedObject を GuiObj に最小限の GuiService.SelectionOrder を設定します。
パラメータ
検索の子孫である選択の親。
戻り値
コードサンプル
Uses the user's value for GuiService.PreferredTransparency by combining it with the desired default background transparency. Also automatically updates the background transparency whenever the user changes their 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()
SetGameplayPausedNotificationEnabled
このメソッドは、プレイヤーのゲームプレイを一時停止するときに、ディスクトラクトされた通知を無効にすることができます。その後、プレイヤーがカスタマイズしたい場合は、自分の UI を追加できます。
開発者は、GuiService:GetGameplayPausedNotificationEnabled() 関数を呼び出して通知を有効にするかどうかをクエリーできます。
参照してください:
- Workspace.StreamingIntegrityMode と Enum.StreamingIntegrityMode は、ゲームプレイを一時停止するときの詳細について説明します。
パラメータ
内蔵の通知GUI を無効にするかどうか。
戻り値
SetInspectMenuEnabled
この機能は、開発者がデフォルトの Inspect と Buy 機能を有効にまたは無効にすることができます。これは、ゲーム内の機能を完全にまたは特定の部分で無効にしたいときに便利です (例えば、カットシーン)。この機能はデフォルトで有効になっています。
下のコードサンプルでは、ゲームのインスペクトメニューを無効にする方法を示しています:
local GuiService = game:GetService("GuiService")GuiService:SetInspectMenuEnabled(false)
参照してください:
- アバターの調べるメニュー、Inspect と Buy 機能の詳細な説明と、作動方法を提供する記事
- GuiService:InspectPlayerFromHumanoidDescription() により、開発者はこの HumanoidDescription のアセットを示すアセットリストを表示するインスペクトメニューを開くことができます。これは特に、Roblox プラットフォームのプレイヤーのアバターの上に着用されているアイテムが必外見
- GuiService:InspectPlayerFromUserId() により、UserId が与えられたユーザーを表示するようになります。これは、現在のゲームでないプレイヤーを調べるときに特に便利です。
パラメータ
Inspect メニュー機能を有効にするかどうかを示すブーレット。
戻り値
イベント
MenuClosed
ユーザーが Roblox コアGUIエスケープメニューを 閉じる ときに発動します。
MenuOpened
ユーザーが Roblox コアGUI エスケープメニューを開く ときにファイア。