GuiService

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Não criável
Serviço
Não 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.

Resumo

Propriedades

  • Si se activa, el botón Select en un Gamepad o Backslash establecerá automáticamente un GUI como el objeto seleccionado.

  • Oculto
    Não replicado
    Ler Parallel

    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.

  • Somente leitura
    Não replicado
    Ler Parallel

    Regresa true si se abre cualquier menú de CoreGui.

  • Somente leitura
    Não replicado
    Ler Parallel
  • Oculto
    Somente leitura
    Não replicado
    Ler Parallel

    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
    Somente leitura
    Não replicado
    Ler Parallel

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

  • Somente leitura
    Não replicado
    Ler Parallel

    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

Propriedades

AutoSelectGuiEnabled

Ler Parallel

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
Não replicado
Ler Parallel

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

GuiNavigationEnabled

Ler Parallel

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

Somente leitura
Não replicado
Ler Parallel

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

PreferredTextSize

Somente leitura
Não replicado
Ler Parallel

PreferredTransparency

Oculto
Somente leitura
Não replicado
Ler Parallel

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.

Amostras 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
Somente leitura
Não replicado
Ler Parallel

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.

Amostras 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

Ler Parallel

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 .

Amostras 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

Somente leitura
Não replicado
Ler Parallel

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

Amostras 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

Ler Parallel

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

Devolução

void

DismissNotification

Parâmetros

notificationId: string

Devolução

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


Devolução

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:


Devolução

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.


Devolução

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

Devolução

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.


Devolução

void

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


Devolução

void

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


Devolução

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.


Devolução

void

Amostras 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

Devolução

SetEmotesMenuOpen

void

Abre o cierra el menú de Emotes del jugador.

Parâmetros

isOpen: bool

Devolução

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.


Devolução

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


Devolução

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.