Cómo reinventamos el trabajo con escenas en Unity

Unity, como motor, tiene una serie de desventajas que, gracias a sus capacidades de personalización y herramientas de generación de código, se pueden solucionar.

Ahora les contaré cómo escribimos un complemento para Unity basado en proyectos de posprocesamiento y el generador de código CodeDom.

Problema

En Unity, la carga de escenas se realiza mediante un identificador de cadena. No es estable, lo que significa que se puede cambiar fácilmente sin consecuencias obvias. Por ejemplo, cuando cambia el nombre de una escena, todo volará, pero se revelará solo al final de la etapa de ejecución.

El problema aparece rápidamente en escenas de uso frecuente, pero puede ser difícil de detectar cuando se trata de escenas aditivas pequeñas o escenas que se usan con poca frecuencia.

Decisión

Al agregar una escena a un proyecto, se genera una clase del mismo nombre con el método Load.

Si agregamos una escena de Menú, se generará la clase de Menú en el proyecto, y en el futuro podemos iniciar la escena de la siguiente manera:

Menu.Load();

Sí, el método estático no es el mejor diseño. Pero me pareció un diseño lacónico y conveniente. La generación ocurre automáticamente, el código fuente de esta clase:

//------------------------------------------------------------------------------
// <auto-generated>
//     This code was generated by a tool.
//     Runtime Version:4.0.30319.42000
//
//     Changes to this file may cause incorrect behavior and will be lost if
//     the code is regenerated.
// </auto-generated>
//------------------------------------------------------------------------------

namespace IJunior.TypedScenes
{   
    public class Menu : TypedScene
    {
        private const string GUID = "a3ac3ba38209c7744b9e05301cbfa453";
        
        public static void Load()
        {
            LoadScene(GUID);
        }
    }
}

De manera amistosa, la clase debe ser estática, ya que no se supone que se instancia a partir de ella. Este es un error que arreglaremos. Como puede ver en este fragmento, el código no nos aferramos al nombre, sino al GUID de la escena, que es más confiable. La clase base en sí se ve así:

namespace IJunior.TypedScenes
{
    public abstract class TypedScene
    {
        protected static void LoadScene(string guid)
        {
            var path = AssetDatabase.GUIDToAssetPath(guid);
            SceneManager.LoadScene(path);
        }

        protected static void LoadScene<T>(string guid, T argument)
        {
            var path = AssetDatabase.GUIDToAssetPath(guid);

            UnityAction<Scene, Scene> handler = null;
            handler = (from, to) =>
            {
                if (to.name == Path.GetFileNameWithoutExtension(path))
                {
                    SceneManager.activeSceneChanged -= handler;
                    HandleSceneLoaders(argument);
                }
            };

            SceneManager.activeSceneChanged += handler;
            SceneManager.LoadScene(path);
        }

        private static void HandleSceneLoaders<T>(T loadingModel)
        {
            foreach (var rootObjects in SceneManager.GetActiveScene().GetRootGameObjects())
            {
                foreach (var handler in rootObjects.GetComponentsInChildren<ISceneLoadHandler<T>>())
                {
                    handler.OnSceneLoaded(loadingModel);
                }
            }
        }
    }
}

- .

- ( , ), .

, .

, Game , .

.

using IJunior.TypedScenes;
using System.Collections.Generic;
using UnityEngine;

public class GameLoadHandler : MonoBehaviour, ISceneLoadHandler<IEnumerable<Player>>
{
    public void OnSceneLoaded(IEnumerable<Player> players)
    {
        foreach (var player in players)
        {
            //make avatars
        }
    }
}

, .

//------------------------------------------------------------------------------
// <auto-generated>
//     This code was generated by a tool.
//     Runtime Version:4.0.30319.42000
//
//     Changes to this file may cause incorrect behavior and will be lost if
//     the code is regenerated.
// </auto-generated>
//------------------------------------------------------------------------------

namespace IJunior.TypedScenes
{
    public class Game : TypedScene
    {
        private const string GUID = "976661b7057d74e41abb6eb799024ada";
        
        public static void Load(System.Collections.Generic.IEnumerable<Player> argument)
        {
            LoadScene(GUID, argument);
        }
    }
}

. .. N , N . - .

, , , .

N?

YouTube .

. , , , .

, ?

. :

public class GameArguments
{
    public IEnumerable<Player> Players { get; set; }
}

, , , .

, : , . , .

ID .

PlayerPerfs

. , PlayerPrefs . , , .

ASPNet

- View ASPNet Core. ViewData ViewModel. Unity - .

Unity , - , View ASPNet. Additive ( , , ), .

, , , , .

Proof-of-concept. , .

Repositorio de GitHub: https://github.com/HolyMonkey/unity-typed-scenes

Si está interesado, le pediré a Vladislav en el próximo artículo que cuente cómo trabajó con Code Dom en Unity y cómo trabajar con el posprocesamiento usando el ejemplo de lo que discutimos hoy.