GuiService

Mostrar obsoleto

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

No creable
Servicio
No replicado

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.

  • Oculto
    No replicado
    Leer paralelo

    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.

  • Solo lectura
    No replicado
    Leer paralelo

    Regresa true si se abre cualquier menú de CoreGui.

  • Solo lectura
    No replicado
    Leer paralelo
  • Oculto
    Solo lectura
    No replicado
    Leer paralelo

    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.

  • Oculto
    Solo lectura
    No replicado
    Leer paralelo

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

  • Solo lectura
    No replicado
    Leer paralelo

    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

Eventos

Propiedades

AutoSelectGuiEnabled

Leer paralelo

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

Oculto
No replicado
Leer paralelo

Alterna si los objetos en el CoreGui se pueden navegar o no usando un Gamepad.

GuiNavigationEnabled

Leer paralelo

Se utiliza para habilitar y deshabilitar la navegación por el GUI del controlador por defecto.

Solo lectura
No replicado
Leer paralelo

Regresa true si algún menú de CoreGui está abierto.

PreferredTextSize

Solo lectura
No replicado
Leer paralelo

PreferredTransparency

Oculto
Solo lectura
No replicado
Leer paralelo

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

Use 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

Oculto
Solo lectura
No replicado
Leer paralelo

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

Use Reduced Motion

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

Leer paralelo

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

Printing When Gamepad Selection Changes

local GuiService = game:GetService("GuiService")
local function printChanged(value)
if value == "SelectedObject" then
print("The SelectedObject changed!")
end
end
GuiService.Changed:Connect(printChanged)

TopbarInset

Solo lectura
No replicado
Leer paralelo

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

Responsive Frame Within Available Top Bar Space

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

Leer paralelo

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

void

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

void

DismissNotification

Parámetros

notificationId: string

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:


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

void

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

humanoidDescription: Instance

Un objeto HumanoidDescription que contiene los recursos para mostrar en el menú Inspeccionar.

name: string

El nombre del jugador que se está Inspeccionando para mostrar en el menú Inspeccionar.


Devuelve

void

Muestras de código

Opening an Inspect Menu with a HumanoidDescription

local GuiService = game:GetService("GuiService")
local humanoidDescription = Instance.new("HumanoidDescription")
humanoidDescription.HatAccessory = "3339374070"
humanoidDescription.BackAccessory = "3339363671"
GuiService:InspectPlayerFromHumanoidDescription(humanoidDescription, "MyPlayer")

InspectPlayerFromUserId

void

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:

Parámetros

userId: number

El UserId del jugador para inspeccionar.


Devuelve

void

Muestras de código

Opening the Inspect Menu for a UserId

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

void

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

selectionParent: Instance

El padre de la selección cuyos descendientes se buscan.


Devuelve

void

Muestras de código

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

SendNotification

Parámetros

notificationInfo: Dictionary

Devuelve

SetEmotesMenuOpen

void

Abre o cierra el menú de Emotes del jugador.

Parámetros

isOpen: bool

Devuelve

void

SetGameplayPausedNotificationEnabled

void

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:

Parámetros

enabled: bool

Si la interfaz de notificación de construcción está desactivada o no.


Devuelve

void

SetInspectMenuEnabled

void

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

enabled: bool

Un valor deBooleano que indica si habilitar o deshabilitar la función de Inspeccionar Menú.


Devuelve

void

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.