StarterGui
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
StarterGui es un objeto de contenedor diseñado para contener LayerCollector objetos como ScreenGuis .
StarterGui también incluye una gama de funciones que le permiten interactuar con el CoreGui . Por ejemplo, StarterGui:SetCoreGuiEnabled() se puede usar para desactivar elementos del 0> Class.CoreGui0> y StarterGui3> puede realizar una g
Resumo
Propriedades
Permite que este servicio procese la entrada como PlayerGui y CoreGui lo hacen.
Establece el modo de orientación de pantalla predeterminado para los usuarios con dispositivos móviles.
Determina si el contenido de StarterGui es visible en Studio.
Métodos
Devuelve si el dado Enum.CoreGuiType está habilitado, o si ha sido deshabilitado usando StarterGui:SetCoreGuiEnabled() .
Te permite realizar ciertas interacciones con los scripts de Roblox.
Establece si el elemento CoreGui asociado con el dado Enum.CoreGuiType está habilitado o no.
Devuelve un valor que ha sido especificado por un script de núcleo de Roblox.
Retorna uma lista de todas as instâncias GuiObject ocupando o ponto dado na tela.
Propriedades
ProcessUserInput
Permite que StarterGui procese la entrada como PlayerGui y CoreGui lo hacen. El valor predeterminado es 1> false1> .
RtlTextSupport
ScreenOrientation
Esta propiedad establece el modo de orientación de pantalla preferido para los usuarios con dispositivos móviles. Para los diferentes modos disponibles, see Enum.ScreenOrientation .
Por defecto, esta propiedad se establece a Sensor , lo que significa que la experiencia se muestra dependiendo de la mejor coincidencia con la orientación actual del dispositivo, ya sea paisaje (izquierda/derecha) o retrato.
Cuando un Player se une a la experiencia en un dispositivo móvil, esta propiedad determina la orientación de inicio del dispositivo y establece la orientación de ese jugador según. Puedes también obtener la orientación de pantalla actual del jugador a través de PlayerGui.ScreenOrientation, útil cuando se usa una de las configuraciones de "Sensor"
Tenga en cuenta que cambiar esta propiedad no cambiará la orientación de la pantalla para Players ya en la experiencia. Para cambiar la orientación para un jugador existente, use su propiedad PlayerGui.ScreenOrientation .
VirtualCursorMode
Métodos
GetCoreGuiEnabled
Esta función devuelve si el dado Enum.CoreGuiType está habilitado, o si ha sido deshabilitado usando StarterGui:SetCoreGuiEnabled() . Esta función debe ser llamada en el cliente.
Nota que al establecer "TopbarEnabled" a false usando SetCore() se oculta todo 1> Class.CoreGuiType|CoreGuiTypes1> pero no afecta el resultado de esta función.
Parâmetros
El dado Enum.CoreGuiType .
Devolução
Si el dado Enum.CoreGuiType está habilitado.
Amostras de código
local StarterGui = game:GetService("StarterGui")
print(StarterGui:GetCoreGuiEnabled("PlayerList"))
SetCore
Este método (no confundirse con SetCoreGuiEnabled() ) expone una variedad de funcionalidades definidas por los scripts de núcleo de Roblox, como enviar notificaciones, alternar notificaciones para insignias/puntos, definir un llamado para restablecer el botón o alternar la barra superior.
El primer parámetro es una cadena que selecciona la funcionalidad con la que se interactuará la llamada. Puede ser necesario llamar a este método varias veces usando pcall() en caso de que el respectivo guión de núcleo no se haya cargado (o si ha sido desactivado por completo).
La siguiente tabla describe las cadenas que se pueden aceptar como el primer parámetro. Los parámetros que deben seguir son dependientes de la funcionalidad que se utilizará y se describen en sub-tablas.
Activo de chat
Controla si el chat está activo.
<tbody><tr><td><code>activo</code></td><td>booleano</td><td>(requerido)</td><td>Determina si el chat debe ser activado.</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
Notificaciones de puntos activas
Controla si las notificaciones para puntos de jugador ganados aparecen.
<tbody><tr><td><code>activo</code></td><td>booleano</td><td>(requerido)</td><td>Determina si las notificaciones para puntos de jugador ganados aparecerán.</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
Notificaciones de insignias activas
Controla si las notificaciones para insignias ganadas aparecerán.
<tbody><tr><td><code>activo</code></td><td>booleano</td><td>(requerido)</td><td>Determina si las notificaciones para insignias ganadas aparecerán.</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
RestablecerBotón de llamada
Determina el comportamiento, si se da el caso, del botón de reinicio dado a unBooleano o un BindableEvent para ser disparado cuando un jugador solicite restablecer.
<tbody><tr><td><code>habilitado</code></td><td>booleano</td><td>(requerido)</td><td>Determina si el botón de reinicio mantiene su comportamiento predeterminado.</td></tr><tr><td colspan="4"><b>O</b></td></tr><tr><td><code>llamar a la acción de retorno</code></td><td><code>Clase.BindableEvent</code></td><td>(requerido)</td><td>Un <code>Class.BindableEvent</code> para ser disparado cuando el jugador confirma que quiere restablecer.</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
Mensaje de chat
Muestra un mensaje formatado en el chat.
<tbody><tr><td><code>Configurar la mesa</code></td><td>diccionario</td><td>(requerido)</td><td>Un diccionario de información que describe el mensaje (ver abajo).</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
<tbody><tr><td><code>Texto</code></td><td>cadena</td><td>(requerido)</td><td>El mensaje para mostrar.</td></tr><tr><td><code>Color</code></td><td><code>Datatype.Color3</code></td><td><code>Datatype.Color3.fromRGB(255, 255, 243)</code></td><td>Color de texto del mensaje.</td></tr><tr><td><code>Fuente</code></td><td><code>Tipo de fuente</code></td><td><code>FuenteSansBold</code></td><td>Fuente del mensaje.</td></tr><tr><td><code>Tamaño de texto</code></td><td>entero</td><td><code>18</code></td><td>Tamaño del texto del mensaje.</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
Enviar notificación
Causa una notificación no intrusiva que aparece en la parte inferior derecha de la pantalla. La notificación puede tener hasta dos botones.
<tbody><tr><td><code>Configurar la mesa</code></td><td>diccionario</td><td>(requerido)</td><td>Un diccionario de información que describe la notificación (ver abajo).</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
<tbody><tr><td><code>Título</code></td><td>cadena</td><td>(requerido)</td><td>Título de la notificaciones.</td></tr><tr><td><code>Texto</code></td><td>cadena</td><td>(requerido)</td><td>El texto principal de la notificaciones.</td></tr><tr><td><code>Icono</code></td><td>cadena</td><td /><td>La imagen para mostrar con la notificaciones.</td></tr><tr><td><code>Duración</code></td><td>número</td><td><code>5</code></td><td>Duración (en segundos) la notificación debería seguir siendo visible.</td></tr><tr><td><code>Llamar a la acción de retorno</code></td><td><code>Función vinculable de clase</code></td><td /><td>Un <code>Class.BindableFunction</code> que debe invocarse con el texto del botón presionado por el jugador.</td></tr><tr><td><code>Botón1</code></td><td>cadena</td><td /><td>El texto para mostrar en el primer botón.</td></tr><tr><td><code>Botón 2</code></td><td>cadena</td><td /><td>El texto para mostrar en el segundo botón.</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
Barra superior activada
Determina si la barra superior se muestra o no. Desactivar la barra superior también desactivará todos los CoreGuis como el chat, el inventario y la lista de jugadores (por ejemplo, aquellos con SetCoreGuiEnabled).
Cuando esté desactivado, la región de la barra superior una vez ocupada todavía capturará eventos de mouse; sin embargo, los botones colocados allí no responderán a los clics. La ubicación original del espacio GUI todavía estará desplazada 36 píxeles desde la parte superior de la pantalla.
<tbody><tr><td><code>habilitado</code></td><td>booleano</td><td>(requerido)</td><td>Determina si la barra superior debe ser visible.</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
DevConsoleVisible
Determina si la Consola del Desarrollador es visible.
<tbody><tr><td><code>visibilidad</code></td><td>booleano</td><td>(requerido)</td><td>Determina si la consola es visible.</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
Solicitud de envío de amigos
Solicita al jugador actual que envíe una solicitud de amistad a la Player dada.
<tbody><tr><td><code>jugador</code></td><td><code>Clase.Player</code></td><td>(requerido)</td><td>El jugador al que debe enviarse la solicitud de amistad.</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
Eliminar amigo
Solicita al jugador actual que elimine un Player de su lista de amigos.
<tbody><tr><td><code>jugador</code></td><td><code>Clase.Player</code></td><td>(requerido)</td><td>El jugador que debería desbloquearse.</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
Jugador de bloques de prueba
Solicita al jugador actual que bloquee el Player dado.
<tbody><tr><td><code>jugador</code></td><td><code>Clase.Player</code></td><td>(requerido)</td><td>El jugador que debe bloquearse.</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
Jugador de bloqueo de emergencia
Solicita al jugador actual que desbloquee el Player dado.
<tbody><tr><td><code>jugador</code></td><td><code>Clase.Player</code></td><td>(requerido)</td><td>El jugador que debería desbloquearse.</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
Activar el menú contextual de Avatar
Determina si el Menú contextual de Avatar está habilitado.
<tbody><tr><td><code>habilitado</code></td><td>booleano</td><td>(requerido)</td><td>Determina si el menú contextual está habilitado.</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
Menú contextual de Avatar
Abre forzadamente el Menú contextual del Avatar .
<tbody><tr><td><code>jugador</code></td><td><code>Clase.Player</code></td><td>(requerido)</td><td>El jugador en el que se abrirá el menú contextual.</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
Añadir opción de menú contextual de avatar
Añade una opción al Menú contextual del Avatar .
<tbody><tr><td><code>opción</code></td><td><code>Enum.AvatarContextMenuOption</code></td><td>(requerido)</td><td>Opcion para añadir.</td></tr><tr><td colspan="4"><b>O</b></td></tr><tr><td><code>opción</code></td><td>mesa</td><td>(requerido)</td><td>Una tabla de dos elementos, donde el primero es el nombre de la acción personalizada, y el segundo es un <code>Class.BindableEvent</code> que se disparará con un jugador seleccionado cuando la opción esté activada.</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
Eliminar opción contextual de avatar
Elimina una opción del Menú contextual del avatar . El argumento option debe ser el mismo que se usó con "AddAvatarContextMenuOption" (ver arriba).
<tbody><tr><td><code>opción</code></td><td>Variante</td><td>(requerido)</td><td>El mismo valor proporcionado a <b>Añadir opción de menú contextual</b> .</td></tr></tbody>
Nombre | Tipo | Por defecto | Descripción |
---|
Menú de temas de Avatar
Configura el menú contextual personalizado Avatar Context Menu que es una función de opción que permite una fácil interacción entre jugadores a través de acciones personalizadas, como iniciar intercambios, batallas y más. Para obtener más información sobre cómo personalizar su tema, consulte el artículo Avatar Context Menu.
Conexiones de Chat de CoreGui
Establece una conexión de enlace vinculable entre el botón de chat de la barra superior de Class.CoreGui y el sistema de chat legado. El segundo parámetro debe ser una tabla de CoreGui y BindableEvents .
Parâmetros
Selecciona la funcionalidad con la que interactuará la llamada.
Una tabla de BindableEvents y BindableFunctions .
Devolução
Amostras de código
local StarterGui = game:GetService("StarterGui")
StarterGui:SetCore("AvatarContextMenuTheme", {
BackgroundImage = "",
BackgroundTransparency = 0.5,
BackgroundColor = Color3.fromRGB(111, 145, 242),
NameTagColor = Color3.fromRGB(0, 0, 200),
NameUnderlineColor = Color3.fromRGB(213, 233, 255),
ButtonFrameColor = Color3.fromRGB(15, 24, 65),
ButtonFrameTransparency = 0.2,
ButtonUnderlineColor = Color3.fromRGB(213, 233, 255),
Font = Enum.Font.SciFi,
})
SetCoreGuiEnabled
Esta función establece si el elemento CoreGui asociado con el dado Enum.CoreGuiType está habilitado o no.
La barra superior no se puede desactivar con esta función. Para desactivarlo, establece "TopbarEnabled" a false usando StarterGui:SetCore() .
Parâmetros
El dado Enum.CoreGuiType .
Si habilitar o deshabilitar el Enum.CoreGuiType dado.
Devolução
GetCore
Este método devuelve un conjunto de datos o los hace disponibles por los scripts básicos de Roblox. El primer y único parámetro es una cadena que selecciona la información para ser obtenida. Las siguientes secciones describen las cadenas y los datos que devuelve por esta función.
Llamar a este método puede producir. Muchos de estos también registran una función de SetCore() (estas están marcadas con un asterisco).
Notificaciones de puntos activos *
Devuelve si las notificaciones de puntos de jugador están habilitadas if player point notifications are enabled.
Insignias de notificación activas *
Devuelve true si las notificaciones de insignias están habilitadas.
ActivarMenú contextual de avatarActivado *
Devuelvetrue si el Menú contextual de Avatar está habilitado.
ChatActive *
Regresa si el chat está activo o no. Esto se indica por el estado de selección del íconode chat de la barra superior.
Tamaño de ventana de chat *
Regresa el tamaño de la ventana de chat como un UDim2 .
Posición de ventana de chat *
Regresa el tamaño de la ventana de chat como un UDim2 .
ChatBarDisabled *
Regresa true si la barra de chat está deshabilitada.
Obtener ID de usuario bloqueados
Devuelve una lista de UserIds asociados con los usuarios que han sido bloqueados por el jugador local.
JugadorBloqueadoEvento
Devuelve un Class.BindableEvent que se activa cada vez que un jugador es bloqueado por el jugador local.
JugadorDesbloqueadoEvento
Regresa un Class.BindableEvent que se activa cada vez que un jugador es desbloqueado por el jugador local.
Evento de jugador silenciado
Devuelve un Class.BindableEvent que se activa cada vez que un jugador es silenciado por el jugador local.
JugadorDesSilenciado
Devuelve un Class.BindableEvent que se activa cada vez que un jugador es deshabilitado por el jugador local.
Evento Amigable para Jugadores
Devuelve un Class.BindableEvent que se activa cada vez que un jugador es amistoso del jugador local.
JugadorDesAmistadoEvento
Regresa un Class.BindableEvent que se activa cada vez que un jugador es desamistado por el jugador local.
DevConsoleVisible *
Devuelve true si la consola de desarrollador es visible
VRotaciónIntensidad
Regresa una cadena que describe la sensibilidad de la rotación de la cámara en VR: Low , High y Smooth . Esto no estará disponible a menos que 1> Class.VRService.VREnabled1> esté 4> true4> .