Clases serializables

Clase 6 de 24 • Curso de Introducción a Unity: Scripting

Contenido del curso

Introducción

Causar cambios

Tiempo

Interacción

Comunicación

Arquitectura

Cierre

24
Despedida del curso
02:05 min

Tomar examen

Resumen

Guardar el progreso del jugador y lograr que dos scripts se hablen entre sí son habilidades fundamentales para cualquier proyecto en Unity. Aquí se explica paso a paso cómo conectar componentes mediante variables públicas, cómo convertir objetos en JSON gracias a las clases serializables y cómo almacenar esa información con PlayerPrefs para que sobreviva incluso al cerrar el juego.

¿Cómo se comunican dos componentes propios en Unity?

La forma más directa de conectar dos scripts es a través de una variable pública cuyo tipo sea el componente destino. En el ejemplo, el script María declara una variable pública de tipo Bob llamada esposo [0:43]. Esto crea un campo en el inspector donde se puede asignar el objeto de la escena que contiene el componente Bob.

Existen dos maneras de asignar esa referencia:

Hacer clic en el círculo selector del campo, que muestra todos los objetos con ese componente [1:23].
Arrastrar directamente el objeto desde la jerarquía hasta el campo del inspector [1:33].

Un detalle importante es el candado del inspector [1:55]. Al activarlo, el panel queda fijo en el objeto seleccionado sin importar qué se seleccione después. Olvidar desactivarlo es un error frecuente que provoca confusión al asignar componentes a objetos equivocados [2:10].

Una vez que María tiene la referencia a Bob, puede modificar sus propiedades. En el método OnEnable, María asigna su antojo a la propiedad almuerzo de Bob [2:50]. Al activar el script en tiempo de ejecución, el valor cambia de inmediato: Bob pasa de planear lentejas a preparar hamburguesas [3:25].

¿Qué es una clase serializable y cómo se convierte en JSON?

Una clase serializable es una clase marcada con el atributo [System.Serializable] que Unity puede mostrar en el inspector y, sobre todo, puede transformar en una cadena de texto con formato JSON [4:15]. JSON (JavaScript Object Notation) es un estándar de comunicación usado tanto en videojuegos como en servidores y páginas web.

El script Mascota tiene tres campos: nombre, juguetePreferido y aburrimiento [4:05]. María declara una variable pública de tipo Mascota llamada Pepito. Al jugar, se le asignan valores: nombre "Pepito", juguete "pelota" y un nivel de aburrimiento.

¿Cómo se genera el JSON de un objeto?

Para convertir el objeto en texto se usa JsonUtility.ToJson(pepito) dentro del método OnDisable [5:30]. Esto devuelve un string con la estructura del objeto:

csharp string jsonDePepito = JsonUtility.ToJson(pepito);

El JSON resultante contiene cada campo con su valor: el nombre como string, el juguete como string y el aburrimiento como número [5:55].

¿Cómo se reconstruye el objeto a partir del JSON?

El proceso inverso se realiza con JsonUtility.FromJson<Mascota>(json) [6:15]. Es un método genérico: entre los signos <> se indica el tipo original del objeto. Solo se ejecuta si el string no está vacío, evitando errores cuando aún no hay datos guardados.

csharp if (jsonDePepito != "") pepito = JsonUtility.FromJson<Mascota>(jsonDePepito);

¿Cómo persistir datos con PlayerPrefs entre sesiones de juego?

PlayerPrefs es un sistema de almacenamiento integrado en Unity que guarda pares de clave-valor en la memoria de la computadora o dispositivo [7:45]. Funciona en builds para Android, PC o cualquier consola.

Soporta tres tipos de datos:

Strings con SetString / GetString.
Enteros con SetInt / GetInt.
Flotantes con SetFloat / GetFloat.

Para guardar el JSON de la mascota, en OnDisable se escribe:

csharp PlayerPrefs.SetString("mascotaDeMaria", jsonDePepito);

La clave sigue la convención Pascal Case sin espacios ni tildes [8:10]. Para recuperar el dato en OnEnable, primero se verifica que la clave exista con PlayerPrefs.HasKey("mascotaDeMaria") [8:45]. Solo si existe se lee el string y se reconstruye el objeto:

csharp if (PlayerPrefs.HasKey("mascotaDeMaria")) pepito = JsonUtility.FromJson<Mascota>(PlayerPrefs.GetString("mascotaDeMaria"));

Al detener y volver a iniciar el juego, la mascota de María reaparece con los mismos datos que tenía antes [9:25]. Si se necesita simular un inicio limpio, basta con ir a Edit → Clear All PlayerPrefs para borrar todos los datos almacenados [9:50].

Estas tres herramientas —comunicación por referencia, serialización a JSON y almacenamiento con PlayerPrefs— forman la base para manejar estado y persistencia en proyectos Unity. ¿Has probado combinar varias clases serializables en un solo JSON? Comparte tu experiencia en los comentarios.

Comentarios

Sebastian Carballo

student•

Veremos:

- 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:

Por dentro de la variable presentada en el Inspector apretar el ícono circular que aparece en su extremo, el cual desplegará un menú de los objetos aplicables. ||
Arrastrar el objeto desde Hierarchy hasta ese mismo sitio.

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

Declarando una variable pública string llamada antojo en Maria; para luego
Asignar antojo como la re-asignación de la variable almuerzo en Bob, desde la activación (OnEnable) de María.

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:

una variable pública string de nombre jsonPepito
Y a esta, dentro de un OnDisable le vamos a asignar el método para transformar a Json, con la variable pepito como parámetro:
void OnDisable () { jsonPepito = JsonUtility.ToJson(pepito); }
De esta forma, las modificaciones en pepito quedan guardadas como texto JSON.. Ahora tenemos que

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

Sobrescribir el OnDisable, esta vez invocando PlayerPrefs para guardar el Json de pepito como string.

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.

GAEL CABRERA DEL HIERRO

student•

Clase #6 - Clases serializables

Comunicación entre Componentes en Unity

1. Uso de Variables Públicas

Comunicación: Podemos comunicar dos componentes creando una variable pública en un script y asignándole el objeto con el que queremos interactuar.
Ejemplo:

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

Serialización: Los objetos serializables pueden transformarse en JSON, lo que permite convertir un objeto en una cadena de texto que describe su estado.
Ejemplo de Serialización:

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

Persistencia: Para que la información persista entre sesiones de juego, podemos usar PlayerPrefs para guardar y recuperar datos.
Ejemplo:

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.

GAEL CABRERA DEL HIERRO

student•

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

- 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.

using UnityEngine;
using System.Collections;
using System.Collections.Generic;

public class Maria : Monobehaviour {
	public Bob esposo;
	public string antojo;
	
	void OnEnable () {
		esposo.almuerzo = antojo;
	}

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

Clases serializables

Introducción

Bienvenida al curso

Introducción a los Scripts en Unity: Ciclo de vida y métodos

OnDisable, OnDestroy, OnMouseDown

Usando la consola de una forma muy pro

Propiedades públicas y privadas, [SerializeField], [Header] y [HideInInspector]