Détruire

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

Destroy(obj) supprime un GameObject de la scène, enfants compris. Un deuxième argument retarde 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 avec la barre d’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 quand tu veux désigner l’objet. Dans un script, gameObject désigne l’objet sur lequel se trouve le script, donc 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

La goulotte fait tomber une pièce chaque seconde ; cette partie est déjà écrite. Modifie-la pour que :

chaque pièce disparaisse 3 secondes après son apparition, afin qu’il n’y ait jamais plus de 3 pièces à la fois ;
la barre d’espace détruise la goulotte elle-même, afin qu’aucune autre pièce ne tombe. Les pièces déjà sorties disparaissent toujours à temps.

Appuie sur Jouer, observe pendant quelques secondes, appuie sur la barre d’espace, puis 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;
        }

        // Space : détruire la goulotte
    }
}

Testez-vous

Cette leçon comprend un petit quiz. Commencez la leçon pour y répondre et suivre votre progression.

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

2L’inspecteur

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

5Transformations et hiérarchie

Parents et enfants Échelle Regarder les objets Se déplacer vers un point Récapitulatif : Lune en orbite

8Rechercher des objets

Rechercher par nom Tags Rechercher par type Les références plutôt que Find Le null de Unity Récapitulatif : la pièce la plus proche

11Projet : Esquivez les blocs

Le coureur Blocs qui tombent

Nettoyage

Touché !

Survivre et marquer des points