UNITY - Introdução às Coroutines e "yield WaitForSeconds"

Coroutines são funções que podem ser executadas de forma concorrente com o ciclo principal de execução do jogo...

---

---

Olá a todos!

Bem-vindos a este tutorial básico sobre o uso de Coroutines no Unity.

Coroutines são funções que podem ser executadas de forma concorrente com o ciclo principal de execução do jogo.

Neste tutorial, vou usar um exemplo prático para explicar o conceito e também apresentar a função WaitForSeconds, que permite aguardar a execução de uma operação por um número específico de segundos.

Este tutorial pressupõe que você tenha um conhecimento básico de programação em C# no Unity. Ele foi gravado usando a versão 2022 do Unity, mas Coroutines estão disponíveis em muitas linguagens de programação e em versões anteriores do Unity.

Nosso objetivo é fazer com que o canhão dispare automaticamente um Prefab de bala de canhão, que é uma esfera preta simples, a cada 3 segundos, até que ocorra um evento externo que interrompa essa rotina.

Neste caso, o evento externo será o usuário pressionando a tecla S, de "Stop".

Para começar, precisamos criar um script para o canhão e chamá-lo de "autoshoot".

Dentro da classe principal, defino três variáveis para especificar o ponto inicial da bala em relação ao canhão:

public GameObject spawnPrefab;

Vou vincular o prefab da bala de canhão no Unity Editor a esta variável pública.

Vector3 spawnPosition;

Quaternion spawnRotation;

Calculei esse ponto e a orientação inicial, então inicializo esses dois valores dentro da função Start:

spawnPosition = transform.position + new Vector3(-1.2f, 1.8f, 0f);

spawnRotation = Quaternion.Euler(-10f, -90f, 0f);

É claro que precisamos implementar um loop que se repita indefinidamente, a menos que um evento externo o interrompa, e que inclua uma instrução de espera de 3 segundos antes de passar para a próxima iteração.

OBSERVAÇÃO: o prefab da bala de canhão vem com um script que, ao iniciar, aplica um impulso inicial para frente na bala e define o objeto para se autodestruir após 3 segundos, para não encher nem o universo virtual nem a memória do sistema com balas de canhão.

A instrução WaitForSeconds nos permite pausar por uma quantidade específica de tempo, que no nosso caso é de 3 segundos.

Agora precisamos criar um bloco WHILE para executar o loop principal, que estou escrevendo neste momento em um espaço vazio do script.

while(true) {

GameObject cannonBall = Instantiate(spawnPrefab, spawnPosition, spawnRotation, null);

yield return new WaitForSeconds(3);

}

Então, onde devemos colocar esse bloco WHILE?

Ele não pode ser colocado em Start, pois não podemos usar yield WaitForSeconds ali. Além disso, colocá-lo em Update não geraria atraso, já que Update é chamado a cada frame do jogo.

Portanto, devemos criar uma função chamada "shoot" que retorne o tipo IEnumerator e inclua o bloco WHILE.

Essa função permitirá iniciar uma Coroutine usando a instrução StartCoroutine com o nome da função como parâmetro entre aspas duplas.

Como o canhão precisa começar a atirar imediatamente, escrevemos:

StartCoroutine("shoot");

dentro de Start, imediatamente após inicializar spawnPosition e spawnRotation.

Vamos salvar o script e ir para o editor testar o script definido até este ponto.

Para poder parar ou reiniciar a Coroutine, vamos voltar ao script e adicionar duas instruções.

Podemos parar a Coroutine verificando se a tecla S foi pressionada e então chamando a função StopCoroutine com a Coroutine "shoot" como parâmetro.

Da mesma forma, podemos reiniciar a Coroutine verificando se a tecla R foi pressionada e chamando a função StartCoroutine com "shoot" como parâmetro.

Então, vamos escrever, dentro de Update:

if(Input.GetKeyDown(KeyCode.S)) StopCoroutine("shoot");

if(Input.GetKeyDown(KeyCode.R)) StartCoroutine("shoot");

Depois de adicionar essas instruções, vamos salvar o script e voltar ao Unity Editor para testá-lo.

Isso é tudo para este breve tutorial. Espero que tenha sido útil para você! Até breve!