Destruir

Parte de la sección Fundamentos de scripting en Unity del Journey de Unity de Coddy. Lección 67 de 85.

Destroy(obj) elimina un GameObject de la escena, incluidos sus hijos. Un segundo argumento lo retrasa: Destroy(obj, 2f) lo elimina dentro de 2 segundos, y el script que lo llamó continúa de inmediato. Este cañón dispara al pulsar la barra espaciadora, y cada bala que crea desaparece 2 segundos después:

public GameObject bulletPrefab;

void Update()
{
    if (Input.GetKeyDown(KeyCode.Space))
    {
        GameObject bullet = Instantiate(bulletPrefab, transform.position, Quaternion.identity);
        Destroy(bullet, 2f);
    }
}

Pasa la copia, no el prefab: Destroy(bulletPrefab) se rechaza con Destroying assets is not permitted to avoid data loss. Y pasa un GameObject cuando te refieras al objeto. Dentro de un script, gameObject es el objeto al que está asociado el script, así que Destroy(gameObject) elimina ese objeto, mientras que Destroy(this) elimina solo el script y deja el objeto en su sitio.

Destroy nunca ocurre en el acto. Unity elimina el objeto al final del fotograma actual, después de las llamadas a Update() y LateUpdate() de ese fotograma, por lo que las líneas posteriores a Destroy siguen ejecutándose y todavía se puede encontrar el objeto hasta que termine el fotograma.

Desafío

Intermedio

Retira las monedas antiguas y deja que la barra espaciadora elimine el conducto.

Conserva la moneda nueva, GameObject coin = Instantiate(...);, y después llama a Destroy(coin, 3f);.
Al pulsar Input.GetKeyDown(KeyCode.Space), llama a Destroy(gameObject);. Destroy(this) solo eliminaría el script.

Pulsa «Jugar»: cada moneda desaparece después de 3 segundos y la barra espaciadora detiene la aparición de monedas nuevas. Después, pulsa «Comprobar».

Pruébalo tú mismo

using UnityEngine;

public class CoinChute : MonoBehaviour
{
    public GameObject coinPrefab;
    public float interval = 1f;
    float timer;

    void Update()
    {
        timer += Time.deltaTime;
        if (timer >= interval)
        {
            Instantiate(coinPrefab, transform.position, Quaternion.identity);
            timer -= interval;
        }

        // Espacio: destruye el conducto
    }
}