GuiService
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
GuiService permite a los desarrolladores controlar qué GuiObject está siendo seleccionado actualmente por el navegador de la plataforma de juegos, así como verificar si el menú principal de Roblox está actualmente abierto.
Resumen
Propiedades
Si se activa, el botón Select en un Gamepad o Backslash establecerá automáticamente un GUI como el objeto seleccionado.
Alterna si los objetos en el CoreGui se pueden navegar o no usando un Gamepad.
Se utiliza para habilitar y deshabilitar la navegación por el GUI del controlador por defecto.
Regresa true si se abre cualquier menú de CoreGui.
Obtiene la transparencia preferida del usuario como un número entre 0 y 1, lo que indica qué tan opacos quieren que sean los fondos de ciertos elementos de la interfaz de usuario. El uso recomendado es como multiplicador de la Transparencia de Fondo de un elemento. Por defecto, 1.
Devuelve true si el usuario tiene habilitado el movimiento reducido. Por defecto, es false .
Establece el GuiObject que se enfoca actualmente por el GUI Navigator (usado para Gamepads).
Se utiliza para determinar el tamaño y la posición absoluta del área no obstruida dentro del espacio de la barra superior.
Se usa para habilitar y deshabilitar controles táctiles y la interfaz de usuario de controles táctiles. Se pregunta por defecto.
Métodos
Cierra el menú de inspección, si está abierto.
Comprueba si el menú de Emotes del jugador está abierto.
Regresa si la notificación gameplay paused ha sido desactivada por el desarrollador.
Restaura dos valores Vector2 que representan el inserto de las interfaces de usuario en píxeles, desde la esquina superior izquierda de la pantalla y la esquina inferior derecha de la pantalla respectivamente.
Regresa si la funcionalidad de Inspeccionar y Comprar está habilitada.
Permite a un desarrollador mostrar el menú de Inspección que muestra los recursos listados en este objeto HumanoidDescription .
Permite que el menú de inspección aparezca mostrando al usuario que tiene el dado UserId .
Regresa true si el cliente está usando la interfaz de diez pies, que es una versión especial de la interfaz de usuario de Roblox, exclusiva para consolas. Esta es la única forma de garantizar si el usuario está en una consola o no.
Establece GuiService.SelectedObject como hijo de la selección de instancia proporcionadaPadre que es PlayerGui o sus descendientes.
Abre o cierra el menú de Emotes del jugador.
Permite a los desarrolladores desactivar la notificación incorporada cuando se detiene el juego del jugador.
Permite a los desarrolladores habilitar o deshabilitar la funcionalidad de Inspeccionar y Comprar predeterminada.
Eventos
Se activa cuando el usuario cierra el menú de escape del núcleo de Roblox.
Se activa cuando el usuario abre el menú de escape del núcleo de Roblox.
Propiedades
AutoSelectGuiEnabled
Si se activa, el botón Select en un Gamepad o Backslash configurará automáticamente un GUI como el objeto seleccionado. Desactivar esto significa que la navegación de Gui seguirá funcionando si se activa GuiService.GuiNavigationEnabled pero deberá configurar manualmente 1> Class.GuiService.Selected
CoreGuiNavigationEnabled
Alterna si los objetos en el CoreGui se pueden navegar o no usando un Gamepad.
GuiNavigationEnabled
Se utiliza para habilitar y deshabilitar la navegación por el GUI del controlador por defecto.
PreferredTextSize
PreferredTransparency
Obtiene la transparencia preferida del usuario como un número entre 0 y 1, lo que indica cuán más opacos quieren que sean los elementos de fondo de la interfaz de usuario. Por defecto, es 1.
Muestras de código
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
Devuelve true si el usuario tiene habilitado el movimiento reducido. Por defecto, es false .
Este valor de regreso refleja una configuración que se puede establecer desde el lado del usuario en las configuraciones de la aplicación o en el menú de configuración de la experiencia a través de reducir el movimiento . Un valor de true indica que el usuario quiere que los efectos y animaciones de movimiento se reduzcan o se eliminen completamente.
Muestras de código
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
Establece el GuiObject que se está enfocando actualmente en el GUI Navigator (usado para Gamepads). Esto puede restablecer a nulo si el objeto está fuera de la pantalla.
Esta propiedad se cambia por los eventos GuiObject.SelectionGained y GuiObject.SelectionLost.
Si desea determinar cuándo cambia esta propiedad sin rastrear los eventos SeleccionadoGanado y SeleccionadoPerdido para todos los elementos de GUI, puede usar el evento Changed .
Muestras de código
local GuiService = game:GetService("GuiService")
local function printChanged(value)
if value == "SelectedObject" then
print("The SelectedObject changed!")
end
end
GuiService.Changed:Connect(printChanged)
TopbarInset
Devuelve un objeto Rect que representa el espacio no ocupado entre los controles de Roblox de izquierda a la izquierda y la parte superior de la zona segura del dispositivo.
El valor es dinámico y se espera que cambie según la visibilidad de los controles de la interfaz de usuario, como cambiar la propiedad Health del jugador local, el uso de StarterGui:SetCoreGuiEnabled() y el cambio de tamaño y posición de los controles de la interfaz de usuario de Roblox y
Muestras de código
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
Se usa para habilitar y deshabilitar controles táctiles y la interfaz de usuario de controles táctiles. Se pregunta por defecto.
Métodos
CloseInspectMenu
Esta función cierra el menú de inspección, si se abre, cuando se ejecuta desde un LocalScript .
Véase también:
- Menú de Inspección de Avatar , un artículo que proporciona una explicación más detallada de la función Inspeccionar y Comprar y cómo funciona
- GuiService:InspectPlayerFromHumanoidDescription() , permite a un desarrollador traer el menú de Inspección mostrando los activos que se listan en este objeto HumanoidDescription . Esto es especialmente útil cuando lo que se lleva puesto en el avatar de un jugador en la plataforma Roblox no es necesariamente el mismo que su aspecto, looken el juego.
- GuiService:InspectPlayerFromUserId() , permite que el menú de inspección aparezca mostrando el usuario que tiene el UserId dado. Esto es especialmente útil cuando quieres inspeccionar a los jugadores que no están en el juego actual
Devuelve
GetEmotesMenuOpen
Regresa un valor deBooleano que indica si el menú de Emotes del jugador está abierto o no.
Los desarrolladores pueden abrir o cerrar el menú de Emotes al llamar la función GuiService:SetEmotesMenuOpen().
Devuelve
Indica si el menú de Emotes está abierto.
GetGameplayPausedNotificationEnabled
Esta función devuelve si la notificación gameplay paused ha sido desactivada por el desarrollador.
Los desarrolladores pueden habilitar o deshabilitar la notificación al llamar la función GuiService:SetGameplayPausedNotificationEnabled() .
Véase también:
- Workspace.StreamingIntegrityMode y Enum.StreamingIntegrityMode para más información sobre la interrupción del juego.
Devuelve
Si la notificación gameplay paused ha sido desactivada.
GetGuiInset
Restaura dos valores Vector2 que representan el inserto de las interfaces de usuario en píxeles, desde la esquina superior izquierda de la pantalla y la esquina inferior derecha de la pantalla respectivamente.
Los valores de inserción proporcionados por esta función solo tienen efecto en ScreenGuis que tengan su propiedad IgnoreGuiInset establecida en falso.
Devuelve
Un tutorial de dos valores de Vector2 que describen el inserto actual de Gui.
GetInspectMenuEnabled
Esta función返回 whether the Inspect and Buy menu functionality is currently enabled. La función está habilitada por defecto y se puede configurar using the GuiService:SetInspectMenuEnabled() function.
Véase también:
- Menú de Inspección de Avatar , un artículo que proporciona una explicación más detallada de la función Inspeccionar y Comprar y cómo funciona
- GuiService:InspectPlayerFromHumanoidDescription() , permite a un desarrollador traer el menú de Inspección mostrando los activos que se listan en este objeto HumanoidDescription . Esto es especialmente útil cuando lo que se lleva puesto en el avatar de un jugador en la plataforma Roblox no es necesariamente el mismo que su aspecto, looken el juego.
- GuiService:InspectPlayerFromUserId() , permite que el menú de inspección aparezca mostrando el usuario que tiene el UserId dado. Esto es especialmente útil cuando quieres inspeccionar a los jugadores que no están en el juego actual
Devuelve
Un valor deBooleano que indica si la función Inspeccionar Menú está habilitada.
InspectPlayerFromHumanoidDescription
Esta función le permite a un desarrollador agregar el menú de Inspeccionar que muestra los recursos listados en este objeto HumanoidDescription .
Esto permite una mayor personalización con lo que se muestra en el menú Inspeccionar cuando los jugadores inspeccionan a otros jugadores en tu juego. Si tu juego modifica lo que los jugadores están usando, puedes darle al menú Inspeccionar un objeto de descripción humana que representa lo que lleva un jugador y esos elementos se mostrarán. Deberías pasar un nombre también para representar el nombre del jugador que se inspeccionará.
Véase también:
- Menú de Inspección de Avatar , un artículo que proporciona una explicación más detallada de la función Inspeccionar y Comprar y cómo funciona
- GuiService:SetInspectMenuEnabled() , permite a los desarrolladores habilitar o deshabilitar la funcionalidad de Inspección y Compra predeterminada
- GuiService:InspectPlayerFromUserId() , permite que el menú de inspección aparezca mostrando el usuario que tiene el dado UserId . Esto es especialmente útil cuando quieres inspeccionar a los jugadores que no están en el juego actual.
Parámetros
Un objeto HumanoidDescription que contiene los recursos para mostrar en el menú Inspeccionar.
El nombre del jugador que se está Inspeccionando para mostrar en el menú Inspeccionar.
Devuelve
Muestras de código
local GuiService = game:GetService("GuiService")
local humanoidDescription = Instance.new("HumanoidDescription")
humanoidDescription.HatAccessory = "3339374070"
humanoidDescription.BackAccessory = "3339363671"
GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")
InspectPlayerFromUserId
Esta función permite que el menú de inspección aparezca mostrando al usuario que tiene el dado UserId . Esto es especialmente útil cuando quieres inspeccionar a los jugadores que no están en el juego actual.
Esto muestra la misma información que la pestaña "Actualmente usando" en el perfil del usuario especificado.
Véase también:
- Menú de Inspección de Avatar , un artículo que proporciona una explicación más detallada de la función Inspeccionar y Comprar y cómo funciona
- GuiService:SetInspectMenuEnabled() , permite a los desarrolladores habilitar o deshabilitar la funcionalidad de inspección y compra predeterminada. Esto es especialmente útil cuando se trata de lo que se lleva puesto en un avatar del jugador en la plataforma Robloxaspecto, look
- GuiService:InspectPlayerFromHumanoidDescription() , permite a un desarrollador mostrar el menú de Inspección mostrando los recursos listados en este objeto HumanoidDescription
Parámetros
Devuelve
Muestras de código
local GuiService = game:GetService("GuiService")
GuiService:InspectPlayerFromUserId(772462)
IsTenFootInterface
Regresa true si el cliente está usando la interfaz de diez pies, que es una versión especial de la interfaz de usuario de Roblox, exclusiva para consolas. Esta es la única forma de garantizar si el usuario está en una consola o no.
Devuelve
Select
Cuando Selecciona se llama en un padre de selección que es PlayerGui o un descendiente de PlayerGui, el motor busca todos los GuiObjetos seleccionables, visibles y en la pantalla que son descendientes de SelecciónPadre y establece el GuiService.SelectedObject en el GuiObjeto con el menor GuiService.SelectionOrder .
Parámetros
El padre de la selección cuyos descendientes se buscan.
Devuelve
Muestras de código
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
Este método permite a los desarrolladores desactivar la notificación incorporada cuando se detiene el juego del jugador. Luego pueden agregar su propia interfaz de usuario si lo desean.
Los desarrolladores pueden consultar si la notificación está habilitada al llamar la función GuiService:GetGameplayPausedNotificationEnabled() .
Véase también:
- Workspace.StreamingIntegrityMode y Enum.StreamingIntegrityMode para más información sobre la interrupción del juego.
Parámetros
Si la interfaz de notificación de construcción está desactivada o no.
Devuelve
SetInspectMenuEnabled
Esta función permite a los desarrolladores habilitar o deshabilitar la funcionalidad de Inspeccionar y Comprar predeterminada. Esto es útil cuando quieres desactivar la función en tu juego, por completo o durante ciertas partes de tu juego (como una escena de corta duración). La función está habilitada por defecto.
El código de ejemplo a continuación muestra cómo desactivar el menú de inspección para su juego:
local GuiService = game:GetService("GuiService")GuiService:SetInspectMenuEnabled(false)
Véase también:
- Menú de Inspección de Avatar , un artículo que proporciona una explicación más detallada de la función Inspeccionar y Comprar y cómo funciona
- GuiService:InspectPlayerFromHumanoidDescription() , permite a un desarrollador traer el menú de Inspección mostrando los activos que se listan en este objeto HumanoidDescription . Esto es especialmente útil cuando lo que se lleva puesto en el avatar de un jugador en la plataforma Roblox no es necesariamente el mismo que su aspecto, looken el juego.
- GuiService:InspectPlayerFromUserId() , permite que el menú de inspección aparezca mostrando el usuario que tiene el UserId dado. Esto es especialmente útil cuando quieres inspeccionar a los jugadores que no están en el juego actual
Parámetros
Un valor deBooleano que indica si habilitar o deshabilitar la función de Inspeccionar Menú.
Devuelve
Eventos
MenuClosed
Se activa cuando el usuario cierra el menú de escape del núcleo de Roblox.
MenuOpened
Se activa cuando el usuario abre el menú de escape del núcleo de Roblox.