StarterGui

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

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

Métodos

Métodos herdados de BasePlayerGui

Propriedades

ProcessUserInput

Oculto
Não replicado
Segurança do plugin
Ler Parallel

Permite que StarterGui procese la entrada como PlayerGui y CoreGui lo hacen. El valor predeterminado es 1> false1> .

RtlTextSupport

Não scriptável
Ler Parallel

ScreenOrientation

Ler Parallel

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 .

ShowDevelopmentGui

Ler Parallel

Esta propiedad determina si el contenido de StarterGui es visible en Studio.

VirtualCursorMode

Não scriptável
Ler Parallel

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

coreGuiType: Enum.CoreGuiType

Devolução

Si el dado Enum.CoreGuiType está habilitado.

Amostras de código

Checking if a Core GUI is Enabled

local StarterGui = game:GetService("StarterGui")
print(StarterGui:GetCoreGuiEnabled("PlayerList"))

SetCore

void

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>
NombreTipoPor defectoDescripció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>
NombreTipoPor defectoDescripció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>
NombreTipoPor defectoDescripció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>
NombreTipoPor defectoDescripció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>
NombreTipoPor defectoDescripció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>
NombreTipoPor defectoDescripció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>
NombreTipoPor defectoDescripció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>
NombreTipoPor defectoDescripció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>
NombreTipoPor defectoDescripció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>
NombreTipoPor defectoDescripció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>
NombreTipoPor defectoDescripció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>
NombreTipoPor defectoDescripció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>
NombreTipoPor defectoDescripció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>
NombreTipoPor defectoDescripció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>
NombreTipoPor defectoDescripció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>
NombreTipoPor defectoDescripció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>
NombreTipoPor defectoDescripció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>
NombreTipoPor defectoDescripció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

parameterName: string

Selecciona la funcionalidad con la que interactuará la llamada.

value: Variant

Devolução

void

Amostras de código

StarterGui Setting Core GUI

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

void

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

coreGuiType: Enum.CoreGuiType
enabled: bool

Si habilitar o deshabilitar el Enum.CoreGuiType dado.


Devolução

void

GetCore

Variant
Rendimentos

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

Parâmetros

parameterName: string

Devolução

Variant

Eventos