Angelfg: /* Funcionamiento */

2023-11-21T15:15:28Z

Funcionamiento

Angelfg: Coroutine Unity

2022-03-04T09:24:01Z

Coroutine Unity

Página nueva

==Introducción==

Una corutina es un método que permite ejecutarse en cada frame o, si queremos, que espere un cierto número de segundos antes de continuar su ejecución.

Recordar que cuando Unity llama al método Update de cualquier script, lo está llamando cada x milisegundos, indicado por el valor de Time.deltaTime.

Esto quiere decir, que si la máquina funciona a 60 frames por segundo (60fps) está llamando 60 veces al método y por consiguiente a cualquier método que llamemos desde update.

Una corutina me va a permitir que la ejecución se 'pare' durante un frame o durante un tiempo indicado por nosotros.

Normalmente una corutina se emplea para generar gameobjects a partir de un prefab de forma continua cada cierto tiempo, por ejemplo, enemigos que aparecen durante el juego, como ya vimos en los [https://wiki.cifprodolfoucha.es/index.php?title=Unity_Prefabs#Estableciendo_el_tiempo_para_crear_un_Prefab Prefabs].

'''IMPORTANTE:'''
:* Una corutina no es un hilo de ejecución separado del hilo principal. Si programamos un bucle infinito y no escribimos la orden para que salga de la corutina, Unity quedará bloqueado.
:* No llamar a una corutina de forma continua dentro del método Update de un script.

 
==Funcionamiento==

Para hacer uso de una corutina debemos de seguir estos pasos:
:* Definir un método que va a ser la corutina de la forma: private IEnumerator nombre_metodo { }
:: Para ello es necesario importar el espacio de nombres System.Collection: using System.Collections;

:::<syntaxhighlight lang="java">
private IEnumerator Corutina()
{
}
</syntaxhighlight>

:* Ahora, dentro del método siempre debemos de tener la orden: yield '''opción'''
:: Normalmente las opciones que se ponen son:
::* '''yield return null;''' => No continúa la ejecución hasta el siguiente frame.
::* '''yield return WaitForSeconds(num_segundos);''' => No continúa la ejecución hasta que pasen el número de segundos indicados.
::* '''yield break;''' => Sale de la corutina.
::* Otras opciones de Wait aparecen y son bastante sencillas de entender.

:* Se llama al [https://docs.unity3d.com/ScriptReference/MonoBehaviour.StartCoroutine.html método StartCoroutine] enviando como parámetro el nombre del procedimiento que devuelve un IEnumerator. Este método está sobrecargado, y podemos llamarlo de varias formas:
::* StartCoroutine(Corutina()) => Va el nombre del método con paréntesis.
::* StartCoroutine("Corutina") => Va el nombre del método entre comillas y sin paréntesis.

 
==Ejemplos==

'''Ejemplo 1:''' Empleo de yield return null.
<syntaxhighlight lang="java" enclose="div" highlight="1,5,13,18">
using System.Collections;

......

private IEnumerator Corutina()
{

int cont = 0;
while (true)
{
Debug.Log("Contador:" +cont);
cont++;
yield return null;
}
}
void Start()
{
StartCoroutine(Corutina());
}
void Update()
{
Debug.Log("UPDATE");
}
</syntaxhighlight>

: Fijarse que por consola aparecen los dos debug (UPDATE y CONTADOR).
: Lo que está haciendo la corutina es sacar por pantalla un contador que se va incrementando, pero dicho incremento lo hace cada frame por segundo de la máquina.
: Si no tuviéramos la orden yield, Unity quedaría bloqueado, ya que nunca saldría del bucle infinito.

 
'''Ejemplo 2:''' Cambio de color.
: Para mostrar la diferencia de ejecutar un código dentro de una corutina, voy a hacer que el script cambie el color de un gameobject. Para ello tenéis que asociar el script a un gameobject de la escena que tenga material.

<syntaxhighlight lang="java" line enclose="div" highlight="">
private IEnumerator CambiarColorCorutine()
{
Renderer renderer = GetComponent<Renderer>();
Color c = renderer.material.color;
for (float valor = 0f; valor <= 200; valor += 0.1f)
{
c.r = valor;
c.g = valor;
renderer.material.color = c;
yield return null;
}
}

void Start()
{
StartCoroutine("CambiarColorCorutine");
}

</syntaxhighlight>

* Al ejecutar el script podéis comprobar como se cambia el color del gameobject y lo hace rápidamente pero no de forma 'instantánea'.
: Si vuestra máquina (CPU) funciona a 60fps, cada vez que el método ejecuta la orden yield return null; sale y al siguiente frame continúa la ejecución.
: Por lo tanto, si el contador va desde 200 hasta 0, tarda 200 frames en terminar de ejecutarse, por lo tanto 200/60 => 3,3 segundos.

* Se ejecutáis el mismo código sin emplear una corutina, podéis comprobar como el cambio es instantáneo, ya que dentro del mismo frame ejecuta el bucle completo:
<syntaxhighlight lang="java" line enclose="div" highlight="">
private void CambiarColorCorutine()
{
Renderer renderer = GetComponent<Renderer>();
Color c = renderer.material.color;
for (float valor = 0f; valor <= 200; valor += 0.1f)
{
c.r = valor;
c.g = valor;
renderer.material.color = c;
}
}
void Start()
{
CambiarColorCorutine();
}

</syntaxhighlight>

 
'''Ejemplo 3:''' Esperar un número de segundos.
Como comenté anteriormente, este recurso se suele emplear para crear enemigos (instanciar prefabs) cada cierto número de segundos.
En este ejemplo podemos ver como el log aparece cada 3 segundos.
Ejemplo de uso con prefabs lo tenéis [https://wiki.cifprodolfoucha.es/index.php?title=Unity_Prefabs#Estableciendo_el_tiempo_para_crear_un_Prefab en esta sección de la WIKI].
<syntaxhighlight lang="java" line enclose="div" highlight="7,14">
private IEnumerator CadaSegundos(float segundos)
{
int cont = 0;
while (true)
{
Debug.Log("Contador:" + cont);
yield return new WaitForSeconds(segundos);
cont++;
}
}

void Start()
{
StartCoroutine(CadaSegundos(3)); // Enviamos un parámetro a la coroutine
}

</syntaxhighlight>

* Por consola aparecerá el mensaje cada 3 segundos.

 
'''Ejemplo 4:''' Esperar un número de segundos y cuando llegue a 5 segundos sale de la corutina.
<syntaxhighlight lang="java" line enclose="div" highlight="9-10">
private IEnumerator CadaSegundos(float segundos)
{
int cont = 0;
while (true)
{
Debug.Log("Contador:" + cont);
yield return new WaitForSeconds(segundos);
cont++;
if(cont==5)
yield break;
}
}
void Start()
{
StartCoroutine(CadaSegundos(3)); // Enviamos un parámetro a la coroutine
}

</syntaxhighlight>

 
'''[https://wiki.cifprodolfoucha.es/index.php?title=Programacion_de_videojuegos_con_UNITY3D#UNIDAD_4:_Scripts Enlace a la página principal del curso]'''
 

 -- [[Usuario:angelfg|Ángel D. Fernández González]] -- (2018).

@@ Línea 35: / Línea 35: @@
 :: Normalmente las opciones que se ponen son:
 ::* '''yield return null;''' => No continúa la ejecución hasta el siguiente frame.
-::* '''yield return WaitForSeconds(num_segundos);''' => No continúa la ejecución hasta que pasen el número de segundos indicados.
+::* '''yield return new WaitForSeconds(num_segundos);''' => No continúa la ejecución hasta que pasen el número de segundos indicados.
 ::* '''yield break;''' => Sale de la corutina.
 ::* Otras opciones de Wait aparecen y son bastante sencillas de entender.
@@ Línea 47: / Línea 47: @@
 <br />
 ==Ejemplos==

UNITY Coroutines - Historial de revisiones

Angelfg: /* Funcionamiento */

Angelfg: Coroutine Unity