Pular para o conteúdo principal
Versão: 3.1.0

Criando Cenas de Carregamento

Durante a transição de cenas, você tem a opção de providenciar uma cena intermediária que pode ser utilizada como uma cena de carregamento. Isso pode ser uma splash screen animada ou uma barra de progresso, por exemplo. Esse pacote oferece implementações para te ajudar a desenvolver suas telas de carregamento mais rápido.

Exemplo​

Considere a hierarquia da seguinte cena de tela de carregamento como exemplo:

Por meio dessa hierarquia na sua cena de carregamento, seria possível realizar fade in/out e mostrar tanto a barra de progresso e um feedback em texto do progresso. Como essa cena tem o componente LoadingFader, lembre-se de habilitar tanto o toggle WaitForScriptedStart e WaitForScriptedEnd no componente LoadingBehavior. Além disso, se você não estiver utilizando cenas addressable, habilite o toggle ReducedLoadRatio`.

Você pode testar essa cena passando sua referência ILoadSceneInfo como o parâmetro intermediateSceneInfo em um método ISceneLoader.TransitionToScene.

Componentes de Carregamento​

O Loading Behavior​

O Loading Behavior é um componente MonoBehaviour, que você pode acoplar em GameObjects do Unity, que recebem um valor de progresso do scene manager. Você precisa adicionar um componente LoadingBehavior a um GameObject na sua cena de carregamento para poder mostrar feedback de carregamento de cenas. Ele expõe sua instância de LoadingProgress, que você pode usar para escutar aos eventos de carregamento:

public class LoadingProgress : IProgress<float>
{
  public event LoadingStateChangeDelegate StateChanged;
  public event SceneLoadProgressDelegate Progressed;

  public LoadingState State { get; }
}

O evento StateChanged espera um parâmetro LoadingState, para reportar o estado atual da operação de carregamento de cena, e você pode checar o estado atual a qualquer momento lendo o valor da propriedade State. O evento Progressed espera um parâmetro float, indo de 0 a 1 para reportar o progresso da operação de carregamento de cena.

De volta ao LoadingBehavior, ele tem algumas opções que você pode ajustar no Inspector do Unity:

  • Wait For Scripted Start: habilite se a transição de cenas terão um efeito de transition in, como um fade in.
  • Wait For Scripted End: habilite se a transição de cenas terão um efeito de transition out, como um fade out.

Os Estados de Carregamento​

A transição da cena de carregamento pode ser parametrizada para atrasar algumas partes da operação e entregar uma experiência visual fluida para o usuário. Isso significa que podemos utilizar fade in/out ou outros efeitos de transição e aguardar que completem para continuar a operação de carregamento de cena. O enum LoadingState reflete esses estados:

public enum LoadingState
{
  WaitingToStart,
  Loading,
  TargetSceneLoaded,
  TransitionComplete
}

Os estados são ordenados, o que significa que o primeiro estado sempre será WaitingToStart e o último será TransitionComplete. Eles representam:

  • WaitingToStart: está aguardando um gatilho para permitir que a operação de carregamento inicie. Isso pode aconteer se a cena de carregamento não aparecer instantaneamente, caso contrário causaria experiências estranhas com coisas desaparecendo. Você pode transitionar a tela de carregamento com um fade in ou efeito similar, por exemplo.
  • Loading: a transição da tela de carregamento já ocorreu e a operação de carregamento de cena está rodando. Durante esse estado, a instância do LoadingProgress receberá valores de progresso do scene manager.
  • TargetSceneLoaded: a cena alvo carregou, mas a tela de carregamento ainda está ativa. Você pode usar esse estado para fazer uma transição de saída da tela de carregamento, como um fade out ou efeito similar.
  • TransitionComplete: a cena alvo carregou e a tela de carregamento já saiu de cena. Logo após esse estado, a cena de carregamento será descarregada.

O Feedback de Carregamento​

Nesse ponto, você já deve ter sua cena de carregamento com um LoadingBehavior acoplado a um dos seus GameObjects. Agora você pode adicionar outros componentes para mostrar o feedback de carregamento. Esse pacote vem com três feedbacks:

  • LoadingFeedbackSlider: adicione a um UI Slider para mostrar o feedback de carregamento como uma barra de progresso.
  • LoadingFeedbackTextMeshPro: adicione a um UI Text Mesh Pro para mostrar o feedback de carregamento em forma de text normalizado de 0 a 100.
  • LoadingFeedbackText (também conhecido como Legacy): adicione a um UI Legacy Text para mostrar o feedback de carregamento em forma de text normalizado de 0 a 100.

Você pode usar uma combinação desses componentes de feedback em uma cena de carregamento. Lembre de associar o campo LoadingBehavior desses componentes ao componente LoadingBehavior que você criou antes.

Outro feedback que você pode fazer é um efeito de fade in/out. O componente LoadingFader faz exatamente isso. Adicione-o a um GameObject com UI Canvas Group para controlar o valor de alpha do grupo durante as transições visuais. Você também pode controlar o tempo de fade e parametrizar as curvas de animação do fade in/out de acordo com a sua preferência.

Para usar efetivamente o LoadingFader, você deve habilitar os toggles WaitForScriptedStart e WaitForScriptedEnd no seu componente LoadingBehavior.