GuiService

Se attivato, il pulsante Select su una Gamepad o Backslash imposterà automaticamente un GUI come l'oggetto selezionato. Disattivando questo opzionerà che la navigazione Gui funzionerà ancora se GuiService.GuiNavigationEnabled è abilitato ma dovrai impostare manualmente 1> Class.GuiService.SelectedObject1> per avviare

Attiva/disattiva se gli oggetti nella CoreGui possono essere navigati usando un Gamepad.

Utilizzato per abilitare e disabilitare la navigazione della GUI del controller di base.

Restituisce vero se qualsiasi menu di CoreGui è aperto.

Ottiene la trasparenza preferita dell'utente come numero tra 0 e 1, che indica quanto più opachi vogliono che sia il background degli elementi UI. Predefinito a 1.

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

Restituisce true se l'utente ha abilitato la riduzione del movimento. Predefinito a false .

Questo valore di ritorno riflette una impostazione che può essere impostata dall'utente dalla parte dell'utente in either the app settings o within the in-experience settings menu via ridurre il movimento . Un valore di true indica che l'utente vuole che gli effetti e le animazioni di movimento siano ridotti o completamente rimossi.

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

Imposta il GuiObject attualmente in foco dal GUI Navigator (utilizzato per i Gamepads). Questo potrebbe essere ripristinato a zero se l'oggetto è off-screen.

Questa proprietà è cambiata dagli eventi GuiObject.SelectionGained e GuiObject.SelectionLost.

Se desideri determinare quando questa proprietà cambia senza tracciare gli eventi SelezionatiGained e SelectionLost per tutti gli elementi GUI, puoi utilizzare l'evento Changed .

local GuiService = game:GetService("GuiService")

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

GuiService.Changed:Connect(printChanged)

Restituisce un oggetto Rect che rappresenta l'area non occupata tra i controlli Roblox a sinistra e l'angolo della sicurezza del dispositivo.

Il valore è dinamico e può essere aspettato di cambiare in base alla visibilità dei controlli UI come la modifica della ProprietàHealth del Giocatorelocale, l'uso di StarterGui:SetCoreGuiEnabled() e la modifica della dimensione e della posizione dei controlli UI Roblox. Per questo motivo, si consiglia

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)

Utilizzato per abilitare e disabilitare i controlli touch e touch control display UI. Predefinito vero.

Questa funzione chiude il menu Ispeziona, se aperto, quando viene eseguito da un LocalScript .

Vedi anche:

• Avatar Inspect Menu , un articolo che fornisce un'esplanazione più dettagliata della funzione Ispeziona e Acquista e su come funziona
• GuiService:InspectPlayerFromHumanoidDescription() , consente a un sviluppatore di aprire il menu Ispeziona mostrando le risorse elencate in questo oggetto HumanoidDescription . Questo è particolarmente utile quando ciò che viene indossato su un avatar del Giocatoresulla piattaforma Roblox non è necessariamente lo stesso che la loro aspettoin gioco
• GuiService:InspectPlayerFromUserId() , consente al menu di ispezionare di apparire mostrando l'utente che ha il UserId . Questo è particolarmente utile quando vuoi ispezionare i giocatori che non sono nella Giocoattuale

Restituzioni

Parametri

Restituzioni

Restituisce un booleto che indica se o no il menu Emotes del giocatore è aperto.

Gli sviluppatori possono aprire o chiudere il menu Emotes chiamando la funzione GuiService:SetEmotesMenuOpen() .

Restituzioni

Questa funzione restituisce se la notifica gameplay paused è stata disabilitata dal sviluppatore.

Gli sviluppatori possono abilitare o disabilitare la notifica chiamando la funzione GuiService:SetGameplayPausedNotificationEnabled() .

Vedi anche:

• Workspace.StreamingIntegrityMode e Enum.StreamingIntegrityMode per maggiori dettagli su quando il gameplay è interrotto.

Restituzioni

Restituisce due valori Vector2 che rappresentano l'inserimento delle interfaccie utente in pixel, dall'angolo in alto a sinistra della schermata e dall'angolo in basso a destra della schermata rispettivamente.

I valori insetti forniti da questa funzione hanno effetto solo su ScreenGuis che hanno la loro proprietà IgnoreGuiInset impostata su false.

Restituzioni

Questa funzione restituisce se la funzione Inspect e Buy è attualmente abilitata. La funzione è abilitata per impostazione predefinita e può essere impostata utilizzando la funzione GuiService:SetInspectMenuEnabled().

Vedi anche:

• Avatar Inspect Menu , un articolo che fornisce un'esplanazione più dettagliata della funzione Ispeziona e Acquista e su come funziona
• GuiService:InspectPlayerFromHumanoidDescription() , consente a un sviluppatore di aprire il menu Ispeziona mostrando le risorse elencate in questo oggetto HumanoidDescription . Questo è particolarmente utile quando ciò che viene indossato su un avatar del Giocatoresulla piattaforma Roblox non è necessariamente lo stesso che la loro aspettoin gioco
• GuiService:InspectPlayerFromUserId() , consente al menu di ispezionare di apparire mostrando l'utente che ha il UserId . Questo è particolarmente utile quando vuoi ispezionare i giocatori che non sono nella Giocoattuale

Restituzioni

Questa funzione consente a un sviluppatore di generare il menu Ispeziona mostrando le risorse elencate in questo oggetto HumanoidDescription .

Questo consente ulteriori personalizzazioni con ciò che è mostrato nel menu Ispeziona quando i giocatori ispezionano altri giocatori nel tuo Gioco. Se il tuo gioco modifica ciò che indossa un giocatore, puoi invece dare un oggetto HumanoidDescription al menu Ispeziona che rappresenta ciò che indossa un giocatore e questi oggetti saranno mostrati. Dovresti passare anche un nome per rappresentare il nome del giocatore che sarà ispezionato.

Vedi anche:

• Avatar Inspect Menu , un articolo che fornisce un'esplanazione più dettagliata della funzione Ispeziona e Acquista e su come funziona
• GuiService:SetInspectMenuEnabled() , consente ai sviluppatori di abilitare o disabilitare la funzionalità di ispezione e acquisto predefinita
• GuiService:InspectPlayerFromUserId() , consente al menu di ispezionare di apparire mostrando l'utente che ha il UserId . Questo è particolarmente utile quando vuoi ispezionare i giocatori che non sono nel Giococorrente.

Parametri

Restituzioni

local GuiService = game:GetService("GuiService")

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

GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")

Questa funzione consente al menu di ispezionare di apparire mostrando l'utente che ha il UserId . Questo è particolarmente utile quando si vuole ispezionare i giocatori che non sono nel Giococorrente.

Questa mostra le stesse informazioni della scheda "Attualmente indossando" sul Profilodell'utente specificato.

Vedi anche:

• Avatar Inspect Menu , un articolo che fornisce un'esplanazione più dettagliata della funzione Ispeziona e Acquista e su come funziona
• GuiService:SetInspectMenuEnabled() , consente agli sviluppatori di abilitare o disabilitare la funzione di ispezione e acquisto predefinita. Questo è particolarmente utile quando ciò che viene indossato su un avatar del Giocatoresulla piattaforma Roblox non è necessariamente lo stesso della loro aspettoin gioco
• GuiService:InspectPlayerFromHumanoidDescription() , consente a un sviluppatore di aprire il menu Ispeziona mostrando le risorse elencate in questo oggetto HumanoidDescription

Parametri

Restituzioni

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

Restituisce vero se il client sta usando l'interfaccia a dieci piedi, che è una versione speciale dell'interfaccia utente Roblox, esclusiva per le console. Questo è l'unico modo garantito per verificare se l'utente è su una console o no.

Restituzioni

Quando Select viene chiamato su un'istanza SelectionParent che è PlayerGui o un discendente di PlayerGui, il motore cerca tutti i GuiObjects selezionabili, visibili e sullo schermo disponibili che sono discendenti di SelectionParent e imposta il GuiService.SelectedObject al GuiObject con il più piccolo GuiService.SelectionOrder .

Parametri

Restituzioni

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

Parametri

Restituzioni

Apre o chiude il menu Emotes del giocatore.

Parametri

Restituzioni

Questo metodo consente ai sviluppatori di disabilitare la notifica incorporata quando il gioco di un giocatore è in pausa. Possono quindi aggiungere la propria UI se lo desiderano.

Gli sviluppatori possono query se la notifica è abilitata chiamando la funzione GuiService:GetGameplayPausedNotificationEnabled() .

Vedi anche:

• Workspace.StreamingIntegrityMode e Enum.StreamingIntegrityMode per maggiori dettagli su quando il gameplay è interrotto.

Parametri

Restituzioni

Questa funzione consente agli sviluppatori di abilitare o disabilitare la funzione di ispezione e acquisto predefinita. Questa è utile quando si desidera disabilitare la funzione nel tuo Gioco, interamente o durante alcune parti del tuo gioco (ad esempio una cutscene). La funzione è abilitata per impostazione predefinita.

L'esempio di codice seguente mostra come disabilitare il menu Ispeziona per il tuo Gioco:

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

Vedi anche:

• Avatar Inspect Menu , un articolo che fornisce un'esplanazione più dettagliata della funzione Ispeziona e Acquista e su come funziona
• GuiService:InspectPlayerFromHumanoidDescription() , consente a un sviluppatore di aprire il menu Ispeziona mostrando le risorse elencate in questo oggetto HumanoidDescription . Questo è particolarmente utile quando ciò che viene indossato su un avatar del Giocatoresulla piattaforma Roblox non è necessariamente lo stesso che la loro aspettoin gioco
• GuiService:InspectPlayerFromUserId() , consente al menu di ispezionare di apparire mostrando l'utente che ha il UserId . Questo è particolarmente utile quando vuoi ispezionare i giocatori che non sono nella Giocoattuale

Parametri

Restituzioni

Si attiva quando l'utente chiude il menu di fuga del核 Roblox.

Si attiva quando l'utente apre il menu di fuga del coreguide Roblox.