Contenido del curso
Guardar progreso en Unity con PlayerPrefs
Guardar el progreso del jugador en Unity es una de esas funciones que parecen mágicas hasta que entiendes cómo funcionan. Con clases serializables, JSON y PlayerPrefs puedes hacer que tu juego recuerde lo que pasó antes de cerrarse, sin que el jugador tenga que apuntar nada en un papel.
Esta guía es para ti si ya manejas propiedades públicas y privadas en Unity y quieres dar el siguiente paso: comunicar componentes entre sí y persistir información entre sesiones de juego.
¿Cómo se comunican dos componentes en Unity?
La forma más directa de que un componente le hable a otro es mediante variables públicas que referencian al otro componente. En el ejemplo de la clase, tenemos a María (un cubo) y a Bob (una esfera), cada uno con su propio script.
María declara una variable pública de tipo Bob llamada esposo. En el inspector de Unity, ese campo aparece vacío hasta que le dices a quién apunta. Tienes dos formas de asignarlo:
¿Para qué sirve el candado del inspector en Unity? Bloquea la vista del inspector en un objeto específico, así puedes arrastrar otros objetos sin perder de vista el script que estás configurando. Si arrastras objetos y el inspector cambia, probablemente olvidaste activar el candado.
Una vez referenciado, María puede modificar propiedades de Bob desde su propio script. Por ejemplo, en el método OnEnable, María asigna su antojo al campo almuerzo de Bob: esposo.almuerzo = antojo. Cuando activas el componente de María, Bob cambia su plan de lentejas a hamburguesas al instante [05:20].
¿Qué es OnEnable y cuándo se ejecuta?
OnEnable es un método de Unity que se ejecuta cada vez que el componente se activa. Si lo desactivas y lo vuelves a activar, el código dentro de OnEnable corre de nuevo, lo cual lo hace perfecto para inicializar valores o cargar datos guardados.
¿Qué es una clase serializable y cómo se convierte en JSON?
Una clase serializable es aquella que Unity puede convertir en un formato de texto plano para guardarla, enviarla o reconstruirla después. En el ejemplo, la clase Mascota es serializable y tiene tres campos: nombre, juguete preferido y un nivel de aburrimiento que, al llegar al 20%, hace que la mascota destroce un mueble [07:45].
El truco está en que cualquier objeto serializable puede transformarse en un JSON, que es básicamente una cadena de texto estructurada. Los JSON se usan en todas partes: páginas web los envían a servidores, servidores los devuelven a páginas web, y los videojuegos los usan para guardar estados.
Para convertir un objeto a JSON en Unity usas:
csharp jsonDePepito = JsonUtility.ToJson(pepito);
Esto te devuelve un string con el nombre, juguete y aburrimiento de la mascota. Para hacer el camino inverso, es decir, reconstruir el objeto desde el texto, usas el método genérico FromJson:
csharp if (jsonDePepito != "") { pepito = JsonUtility.FromJson<Mascota>(jsonDePepito); }
El if es importante porque si el string está vacío, no tiene sentido intentar deserializarlo.
¿Qué es un JSON en Unity? Es una cadena de texto que representa un objeto serializable. Permite guardar, enviar o reconstruir el objeto manteniendo todos sus valores originales.
¿Cómo persistir datos con PlayerPrefs?
Guardar el JSON en una variable está bien mientras el juego corre, pero en cuanto cierras Unity, ese dato se pierde. Aquí entra PlayerPrefs, una especie de base de datos clave-valor que vive en la memoria persistente del dispositivo y funciona en builds de Android, computadora y consolas [13:30].
PlayerPrefs acepta tres tipos de datos:
SetString y GetString.SetInt y GetInt.SetFloat y GetFloat.Para guardar el JSON de la mascota en OnDisable:
csharp PlayerPrefs.SetString("MascotaDeMaria", jsonDePepito);
La clave (MascotaDeMaria) puede llevar tildes o espacios, pero la convención entre programadores es escribirla en PascalCase, sin espacios, para evitar errores y mantener consistencia.
¿Cómo leer un PlayerPrefs sin que arroje error?
Antes de leer una clave, necesitas confirmar que existe. Si intentas leer una clave inexistente, Unity puede comportarse de forma inesperada. Para eso usas HasKey:
csharp if (PlayerPrefs.HasKey("MascotaDeMaria")) { string json = PlayerPrefs.GetString("MascotaDeMaria"); pepito = JsonUtility.FromJson<Mascota>(json); }
Este flujo completo hace que cuando el jugador cierre el juego, abra de nuevo y María ya tenga a Pepito con su hamburguesa chillona y su nivel exacto de aburrimiento, igualito a como lo dejó.
¿Cómo borro los PlayerPrefs en Unity para hacer pruebas? Ve al menú Edit y selecciona Clear All PlayerPrefs. Esto reinicia toda la memoria persistente como si el juego se ejecutara por primera vez.
Conceptos y habilidades clave de la clase
Dominar estos elementos te da las bases para sistemas de guardado más complejos:
¿Qué tipo de progreso te gustaría guardar primero en tu juego: inventarios, posiciones de personajes o configuraciones del jugador? Cuéntame en los comentarios.
Sebastian Carballo
Estudiante
GAEL CABRERA DEL HIERRO
EstudianteGAEL CABRERA DEL HIERRO
EstudianteVeremos:
- Cómo crear clases serializables - Crear dos componentes y comunicarlos entre sí; - Crear un JSON para almacenar datos mediante clases serializables y - guardarlo en PlayerPrefs.
Clases serializables
nos permiten
Guardar/persistir datos de objetos, incluso después de cerrar el juego.
Para entrar en este concepto primero vamos a ver
cómo dos objetos se comunican entre sí a través de variables públicas;
en este caso María le quiere pedir hamburguesas como almuerzo a Bob. Para lograr la comunicación vamos a:
BASE: Crear y conectar los objetos
- Crear un script Bob y declarar una variable pública almuerzo de tipo string ; - Crear un script Maria y declarar una variable pública esposo de tipo Bob, que podrá ser asignada con algún objeto existente. - Crear GameObject para cada uno y añadirle su script respectivo.
"Para seleccionar el objeto que cubra la variable esposo de Maria, podríamos elegir:
Nota: para evitar tropiezos con el click del arrastre, podemos BLOQUEAR la selección del Objeto (Maria) con el botón del candado en la esquina superior derecha del Inspector y maniobrar todo el editor con la seguridad de que no se irá a deseleccionar accidentalmente. Ahora podemos
CONFIGURACIÓN del envío del mensaje
El script de María:
using UnityEngine; using System.Collections; using System.Collections.Generic; public class Maria : Monobehaviour { public Bob esposo; public string antojo; void OnEnable () { esposo.almuerzo = antojo; }
El script de Bob:
using UnityEngine; using System.Collections; using System.Collections.Generic; public class Bob : Monobehaviour { public string almuerzo; }
Persistencia conPlayerPrefs
"María tiene Mascota"
-agregamos una variable pública del tipo Mascota llamada pepito en el script de Maria;
-Mascota es la siguiente clase:
using UnityEngine; using System.Collections; using System.Collections.Generic; [System.Serializable] public class Mascota { public string nombre; public string juguetePreferido; [Range(0,1)] public float aburrimiento; }
X Nuestro problema es que las modificaciones en pepito no persisten al reinicio del juego … Pero la clase Mascota esta decorada para ser serializable, y todo obj. serializable puede convertirse en un
Archivo JSON (Javascript Object Notation)
Los JSON se suelen utilizar para enviar distintos tipos de datos "traducidos" a puro texto entre una página/app y un server. . A su vez el server puede enviar un JSON y la página/aplicación traducir su texto de vuelta a objetos de su lenguaje (p.e JavaScript).
Para implementarlo podríamos agregar en el script de María:
Recuperar el JSON para aplicarlo a pepito, cuando reactivemos su objeto
Para esto
Dentro del OnEnable re-asignamos a la variable pepito = con el método genérico que reciba el tipo de dato que este fue antes de convertirse a JSON (instancia de la clase Mascota) y el dicho JSON como objeto parámetro a convertir (jsonPepito)
Toda esta conversión la vamos a condicionar, para que suceda solo si jsonPepito no está vacio
void OnEnable () { esposo.almuerzo = antojo; if (jsonPepito != " ") { pepito = JsonUtility.FromJson<Mascota>(jsonPepito);
pero…
X El problema con esto es que las modificaciones sobreviven a la desactivación del objeto, más no se guardan. Por suerte contamos con:
PlayerPrefs
Esta utilidad de Unity permite persistir el estado de los objetos, guardándolos en la consola o PC que ejecuta el juego. Es como una base de datos almacenados en formato clave : valor.
La clave sirve para identificar el valor a guardar. El valor puede ser string, integer, float
Para implementarlo vamos a
sintáxis del método:
(1er parametro:"nombreDeClave", 2do parametro: el valor a guardar):
void OnDisable () { PlayerPrefs.SetString("mascotaDeMaria", JsonUtility.ToJson(pepito)) }
Finalmente modificamos la llamada al JSON en el OnEnable y su respectivo if Para adaptarla al uso de PlayerPrefs:
void OnEnable () { esposo.almuerzo = antojo; if (PlayerPrefs.HasKey("mascotaDeMaria")) { pepito = JsonUtility.FromJson<Mascota>(PlayerPrefs.GetString("mascotaDeMaría"));
Si quisiéramos reiniciar estos valores podemos hacerlo desde la pestaña Edit y Clear all PlayerPrefs.
Clase #6 - Clases serializables
Comunicación entre Componentes en Unity
1. Uso de Variables Públicas
Objeto 1 (Maria):
using UnityEngine;
public class Maria : MonoBehaviour { public Bob esposo; // Referencia al objeto con el que se comunica public string antojo;
void OnEnable() { esposo.almuerzo = antojo; // Modifica la variable en el otro objeto } }
Objeto 2 (Bob):
using UnityEngine;
public class Bob : MonoBehaviour { public string almuerzo; // Variable que se va a modificar
Guardando Datos con JSON
csharpCopiar código using UnityEngine;
public class Maria : MonoBehaviour { public Mascota pepito; public string jsonPepito;
void OnEnable() { if (jsonPepito != "") { pepito = JsonUtility.FromJson<Mascota>(jsonPepito); // Deserializa el JSON a un objeto } }
void OnDisable() { jsonPepito = JsonUtility.ToJson(pepito); // Serializa el objeto a JSON } }
Explicación: Este código permite que las variables de un objeto se mantengan consistentes cuando el objeto se desactiva y se vuelve a activar.
Persistencia de Datos con PlayerPrefs
PlayerPrefs para guardar y recuperar datos.csharpCopiar código using UnityEngine;
public class Maria : MonoBehaviour { public Mascota pepito;
void OnEnable() { if (PlayerPrefs.HasKey("mascotaDeMaria")) { pepito = JsonUtility.FromJson<Mascota>(PlayerPrefs.GetString("mascotaDeMaria")); } }
void OnDisable() { PlayerPrefs.SetString("mascotaDeMaria", JsonUtility.ToJson(pepito)); } }
Explicación: Aquí, se utiliza PlayerPrefs para almacenar el estado del objeto pepito en formato JSON, permitiendo que la información persista incluso después de cerrar y abrir el juego.
csharpCopiar código using UnityEngine;
public class Maria : MonoBehaviour { public Mascota pepito;
void OnEnable() { if (PlayerPrefs.HasKey("mascotaDeMaria")) { pepito = JsonUtility.FromJson<Mascota>(PlayerPrefs.GetString("mascotaDeMaria")); } }
void OnDisable() { PlayerPrefs.SetString("mascotaDeMaria", JsonUtility.ToJson(pepito)); } }