Zachowaj między scenami

Wczytanie sceny niszczy wszystkie obiekty z poprzedniej sceny, ale niektóre rzeczy muszą przetrwać całą grę, na przykład monety, które gracz zbiera na kolejnych poziomach. DontDestroyOnLoad(gameObject) przenosi obiekt poza jego scenę, do osobnej sceny o nazwie DontDestroyOnLoad, widocznej w Hierarchy podczas gry, której wczytywanie nie narusza. Działa tylko na obiekcie głównym: w przypadku obiektu podrzędnego Unity wyświetla ostrzeżenie i niczego nie zachowuje. Obiekty podrzędne zachowanego obiektu również zostają zachowane, ale obiekty, do których tylko wskazuje, już nie: po wczytaniu pole wskazujące na obiekt ze starej sceny przechowuje zniszczony obiekt, który jest równy null.

public class GameSession : MonoBehaviour
{
    public static GameSession Instance;
    public int coins;

    void Awake()
    {
        if (Instance != null)
        {
            Destroy(gameObject);
            return;
        }
        Instance = this;
        DontDestroyOnLoad(gameObject);
    }
}

Ten GameSession znajduje się w scenie Menu. Gra przechodzi z Menu do Level1, a następnie wraca do Menu, które ponownie tworzy wszystkie swoje obiekty, w tym nowy GameSession, podczas gdy zachowany obiekt nadal istnieje. Bez sprawdzenia w Awake istniałyby dwa obiekty, a nowy przejąłby Instance z 0 monetami. Dzięki temu sprawdzeniu nowy obiekt wykrywa, że Instance jest już ustawione, niszczy siebie i kończy działanie, a sesja, która przetrwała kolejne poziomy, pozostaje.

return ma znaczenie, ponieważ Destroy czeka do końca klatki. Bez niego reszta Awake nadal wykonałaby się dla nowego obiektu: Instance = this; wskazywałoby wszystkie skrypty na obiekt, który za chwilę zostanie zniszczony.