Détruire

Fait partie de la section Les bases du scripting dans Unity du Journey Unity de Coddy. Leçon 67 sur 85.

Destroy(obj) supprime un GameObject de la scène, enfants inclus. Un deuxième argument permet de retarder la suppression : Destroy(obj, 2f) le supprime dans 2 secondes, et le script qui a appelé cette fonction continue immédiatement son exécution. Ce canon tire lorsque tu appuies sur Espace, et chaque balle qu’il crée disparaît 2 secondes plus tard :

public GameObject bulletPrefab;

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

Passe la copie, pas le prefab : Destroy(bulletPrefab) est refusé avec Destroying assets is not permitted to avoid data loss. Et passe un GameObject lorsque tu désignes l’objet. Dans un script, gameObject est l’objet auquel le script est attaché. Ainsi, Destroy(gameObject) supprime cet objet, tandis que Destroy(this) supprime uniquement le script et laisse l’objet en place.

La destruction n’a jamais lieu sur-le-champ. Unity supprime l’objet à la fin de la frame en cours, après les appels à Update() et à LateUpdate() de cette frame. Les lignes qui suivent Destroy s’exécutent donc quand même, et l’objet reste accessible jusqu’à la fin de la frame.

Défi

Moyen

Élimine les anciennes pièces, et laisse la barre de la touche Espace supprimer le distributeur.

Conserve la nouvelle pièce, GameObject coin = Instantiate(...);, puis appelle Destroy(coin, 3f);.
Sur Input.GetKeyDown(KeyCode.Space), appelle Destroy(gameObject);. Destroy(this) supprimerait uniquement le script.

Appuie sur « Jouer » : chaque pièce disparaît après 3 secondes, et la barre d’espace empêche l’apparition de nouvelles pièces. Puis appuie sur « Vérifier ».

Essayez vous-même

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;
        }

        // Espace : détruire la goulotte
    }
}

Toutes les leçons de Les bases du scripting dans Unity

3L’inspecteur

Champs de l’inspecteur SerializeField Flottants et Mathf Attributs de l’inspecteur Récapitulatif : ascenseur

6Transformations et hiérarchie

Parents et enfants Hissez le drapeau Échelle Regarder les objets Se déplacer vers un point Récapitulatif : la lune en orbite

9Projet : Attrape l’étoile

Le receveur Une étoile filante

12Le cycle de vie d’un script

Awake et Start Update et LateUpdate OnEnable et OnDisable L’ordre du cycle de vie Récapitulatif : journal du cycle de vie

Entraînez-vous par vous-même : Playground Unity