ReplicatedFirst
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Um contêiner cujo conteúdo é replicado para todos os clientes (mas não de volta para o servidor) primeiro antes de qualquer outra coisa.
Para que serve o ReplicatedFirst?
ReplicatedFirst é mais comumente usado para armazenar LocalScripts e outros objetos que são essenciais para o iniciardo jogo.Como o conteúdo do ReplicatedFirst se replica para o cliente antes de qualquer outra coisa no jogo, é ideal para criar GUIs de carregamento ou tutoriais.
Para objetos que não precisam ser replicados primeiro, os desenvolvedores devem usar o contêiner ReplicatedStorage em vez disso.
Como posso usar ReplicatedFirst?
LocalScripts colocado dentro de ReplicatedFirst será executar.Isso significa que o código para telas de carregamento personalizado ou outros usos ReplicatedFirst replicados pode ser executado no ponto mais cedo possível.
Há uma série de considerações importantes que os desenvolvedores precisam lembrar ao executar LocalScripts em ReplicatedFirst.
- Seus conteúdos se replicam antes de qualquer outra coisa no jogo, significando que LocalScripts correndo em ReplicatedFirst precisará esperar por quaisquer objetos que eles precisem se replicar usando Instance:WaitForChild()
- Quaisquer objetos que devem ser usados por um LocalScript em ReplicatedFirst também devem ser parentados para ReplicatedFirst.Caso contrário, eles podem se replicar ao cliente tarde, gerando o script e negando o benefício do ReplicatedFirst.
ReplicatedFirst também inclui a função ReplicatedFirst:RemoveDefaultLoadingScreen(), que pode ser usada para remover imediatamente a tela de carregamento padrão do Roblox.Observe se algum objeto foi colocado em ReplicatedFirst, a tela de carregamento padrão será removida após 5 segundos, independentemente se essa função foi chamada ou não.
Amostras de código
Esta amostra demonstra uma tela de carregamento personalizada com um TextLabel.O código deve ser colocado em um LocalScript dentro de ReplicatedFirst .Para expandir este exemplo com animações de tela de carregamento, veja o artigo Custom Loading Screens .
local Players = game:GetService("Players")
local ReplicatedFirst = game:GetService("ReplicatedFirst")
local player = Players.LocalPlayer
local playerGui = player:WaitForChild("PlayerGui")
-- Crie uma tela de carregamento básica
local screenGui = Instance.new("ScreenGui")
screenGui.IgnoreGuiInset = true
local textLabel = Instance.new("TextLabel")
textLabel.Size = UDim2.new(1, 0, 1, 0)
textLabel.BackgroundColor3 = Color3.fromRGB(0, 20, 40)
textLabel.Font = Enum.Font.GothamMedium
textLabel.TextColor3 = Color3.new(0.8, 0.8, 0.8)
textLabel.Text = "Loading"
textLabel.TextSize = 28
textLabel.Parent = screenGui
-- GUI inteira do pai para a GUI do jogador
screenGui.Parent = playerGui
-- Remova a tela de carregamento padrão
ReplicatedFirst:RemoveDefaultLoadingScreen()
--wait(3) -- Opциональmente forçar a tela a aparecer por um número mínimo de segundos
if not game:IsLoaded() then
game.Loaded:Wait()
end
screenGui:Destroy()
Resumo
Métodos
Remove imediatamente a tela de carregamento padrão do Roblox.Observe se algum objeto foi colocado em ReplicatedFirst, a tela de carregamento padrão será removida após 5 segundos, independentemente se essa função foi chamada ou não.
Propriedades
Métodos
RemoveDefaultLoadingScreen
Remove imediatamente a tela de carregamento padrão do Roblox.Observe se algum objeto foi colocado em ReplicatedFirst, a tela de carregamento padrão será removida após 5 segundos, independentemente se essa função foi chamada ou não.
Os desenvolvedores devem executar essa função a partir de um LocalScript em ReplicatedFirst , como scripts em ReplicatedFirst executarão antes de qualquer outra coisa.
É aconselhável não remover a tela de carregamento padrão, a menos que o desenvolvedor queira exibir sua própria tela de carregamento como alternativa.Se a tela padrão for removida sem usuários de substituição, os usuários finais poderão ver o carregamento de geometria em segundo plano.
Devolução
Amostras de código
Esta amostra demonstra uma tela de carregamento personalizada com um TextLabel.O código deve ser colocado em um LocalScript dentro de ReplicatedFirst .Para expandir este exemplo com animações de tela de carregamento, veja o artigo Custom Loading Screens .
local Players = game:GetService("Players")
local ReplicatedFirst = game:GetService("ReplicatedFirst")
local player = Players.LocalPlayer
local playerGui = player:WaitForChild("PlayerGui")
-- Crie uma tela de carregamento básica
local screenGui = Instance.new("ScreenGui")
screenGui.IgnoreGuiInset = true
local textLabel = Instance.new("TextLabel")
textLabel.Size = UDim2.new(1, 0, 1, 0)
textLabel.BackgroundColor3 = Color3.fromRGB(0, 20, 40)
textLabel.Font = Enum.Font.GothamMedium
textLabel.TextColor3 = Color3.new(0.8, 0.8, 0.8)
textLabel.Text = "Loading"
textLabel.TextSize = 28
textLabel.Parent = screenGui
-- GUI inteira do pai para a GUI do jogador
screenGui.Parent = playerGui
-- Remova a tela de carregamento padrão
ReplicatedFirst:RemoveDefaultLoadingScreen()
--wait(3) -- Opциональmente forçar a tela a aparecer por um número mínimo de segundos
if not game:IsLoaded() then
game.Loaded:Wait()
end
screenGui:Destroy()