O contêiner ScreenGui contém GuiObjects para exibir na tela de um jogador, incluindo quadros , rótulos , botões e muito mais.Todos os objetos e códigos de UI na tela são armazenados e alterados no cliente.
Para contêineres de UI que contêm GuiObjects que você deseja exibir dentro do mundo 3D, como na face de uma peça, veja Contêineres de UI na Experiência.
Para exibir um ScreenGui e seu filho GuiObjects para cada jogador que se junta à experiência, coloque-o dentro do contêiner StarterGui.Quando um jogador se junta a uma experiência e seu personagem primeiro aparece, o ScreenGui e seu conteúdo clonam no contêiner PlayerGui para aquele jogador, localizado dentro do contêiner Players.
Por padrão, GuiObjects dentro de um ScreenGui dentro de StarterGui aparece como uma sobreposição da janela de visualização 3D, simulando sua aparência e posição em uma experiência em andamento.Para ocultar todos esses sobrepositivos de tela, desative sobreposição de GUI do widget Opções de Visualização no canto superior direito do viewport 3D, ou desative visibilidade da interface do usuário da aba Visualização.
Se Players.CharacterAutoLoads estiver desativado, o conteúdo de StarterGui não será clonado até que Player:LoadCharacter() seja chamado.
À medida que uma experiência cresce em escopo, você pode precisar de várias interfaces de tela, como uma tela de título, menu de configurações, interface da loja e muito mais.Nesses casos, você pode colocar vários contêineres exclusivos ScreenGui dentro de StarterGui e alternar a propriedade de cada contêiner Enabled dependendo de se deve ser visível e ativo (enquanto false , os conteúdos não serão renderizar, processados ou atualizados em resposta a alterações).
A propriedade pode ser inicialmente alternada através da janela Propriedades e/ou você pode defini-la durante o tempo de jogo a partir de um script do lado do cliente, acessando o jogador's e definindo-o para ou para o contêiner desejado.
Ao usar várias interfaces ScreenGui múltiplas, você pode empilá-las por Z‑index através de sua propriedade DisplayOrder.Veja Ordem de Exibição para mais informações.
Propriedades de contêiner
As seguintes propriedades permitem que você personalize os insérts de tela em vários dispositivos, a ordem de exibição ao usar vários contêineres de tela e muito mais.
Inserções de tela
Telefones modernos aproveitam toda a tela, mas geralmente incluem notas, cortes e outros elementos que ocupam espaço na tela.Cada experiência do Roblox também inclui os controles da barra superior para acesso rápido ao menu principal, chat , tabela de classificação e muito mais.
Para garantir que os jogadores possam ver e acessar toda a interface de usuário facilmente e sem obstrução, o Roblox fornece a propriedade que controla os inserções da área segura para o conteúdo de um .
O padrão de CoreUISafeInsets mantém todos os descendentes GuiObjects dentro da área segura da interface do usuário principal, limpa dos botões da barra superior e de outros cortes de tela.Essa configuração é recomendada se o ScreenGui conter elementos interativos de UI.
Ordem de exibição
Ao usar várias interfaces ScreenGui múltiplas, você pode empilá-las por Z‑index através de sua propriedade DisplayOrder.Por exemplo, para exibir um menu de configurações modais em um ScreenGui à frente da interface principal do usuário da experiência em outro ScreenGui , atribua um maior DisplayOrder ao modal do que a interface subjacente.
Redefinir no Gerar
A propriedade booleana determina se os resets (se reinicia e clona de novo no personagem do jogador) ocorrem sempre que o personagem do jogador respawna.
| Condição | Reinicializações |
|---|---|
| ResetOnSpawn é true (padrão). | yes |
| O ScreenGui é um descendente indireto de **** de StarterGui ; por exemplo, é colocado dentro de um Folder localizado dentro de StarterGui . | yes |
| é e o é um descendente direto de . | no |
Acessar a interface do jogador
Como observado, cuidar de um ScreenGui para StarterGui cloná-lo e seu filho GuiObjects em um contêiner de jogador de PlayerGui quando eles se juntam à experiência e seu personagem primeiro aparece.
Se você precisar controlar o contêiner de UI de um jogador durante o tempo de jogo, por exemplo, para mostrar/ocultar um específico ScreenGui ou qualquer um de seus filhos, acesse-o da seguinte forma a partir de um LocalScript :
LocalScript - Acessando um Jogador's UI
Desabilitar UI padrão
Todas as experiências do Roblox incluem vários elementos de UI que são habilitados por padrão.Se você não precisar de nenhum desses elementos ou quiser substituí-los por suas próprias criações, você pode usar o método SetCoreGuiEnabled() na parte do script do lado do cliente com a opção Enum.CoreGuiType associada.
| Interface padrão | Enumeração associada |
|---|---|
| Lista dinamicamente atualizada Players lista, comumente usada como uma tabela de líderes. | Enum.CoreGuiType.PlayerList |
| A barra do personagem Health . Não aparece se a barra do personagem Humanoid estiver em plena saúde. | Enum.CoreGuiType.Health |
| O personagem Backpack que contém ferramentas na experiência . Não aparece se não houver Tools na mochila. | Enum.CoreGuiType.Backpack |
| A janela de bate-papo de texto. | Enum.CoreGuiType.Chat |
| Menu pop-up de personagem emotes. | Enum.CoreGuiType.EmotesMenu |
| Uma janela que exibe a perspectiva ou visão de um jogador de seu próprio personagem.Não aparece a menos que o jogador tenha ativado Visualização Automática no menu do Roblox. | Enum.CoreGuiType.SelfView |
| Um botão capturar captura de tela ao longo do lado direito da tela.Não aparece a menos que o jogador tenha ativado Capturas no menu Roblox. | Enum.CoreGuiType.Captures |
Script do Cliente - Desabilitar elementos de UI padrão
Além disso, dispositivos com capacidades de toque incluem um polegar virtual e um botão de pulo por padrão.Se desejar, você pode ocultar esses elementos definindo GuiService.TouchControlsEnabled para false em um script do lado do cliente.
Script do Cliente - Desabilitar Controles de Toque