C# para Unity · Sección 4

Inspector, atributos y serialización

Atributos que vuelven el Inspector legible y seguro, visibilidad de campos, validación en edición y dependencias obligatorias entre componentes.

3: lecciones
3: ejercicios resueltos

CONTENIDO ORIGINAL

Avanza en orden. Cada lección está redactada para Palta es Cool, utiliza ejemplos propios y termina con una actividad cuya respuesta puedes desplegar.

ANTES DE EMPEZAR

Ubícate antes de avanzar

01 / PUNTO DE PARTIDA

Conviene haber comprendido Ciclo de vida y tiempo en Unity.

02 / META OBSERVABLE

Al terminar deberías poder relacionar Inspector legible con Serialización y encapsulación y resolver un caso nuevo.

03 / TIEMPO SUGERIDO

Reserva entre 35 y 55 minutos para lectura, ejemplos, tres comprobaciones y cierre.

04 / PREPARA EL LABORATORIO

Instala Unity Hub, una versión LTS compatible y un IDE con integración para C#. Conserva un proyecto de laboratorio separado.

Abrir la guía de herramientas →

Diagnóstico rápido: ¿cómo se relacionan Inspector legible y Serialización y encapsulación? ＋

No necesitas acertar todavía. Escribe una hipótesis de dos líneas y compárala con tu respuesta al finalizar; si puedes corregirla y justificar el cambio, hubo aprendizaje.

Ruta guiada · 3 lecciones

Aprende el tema paso a paso

Usarás metadatos y validación para mejorar la autoría sin confundir una interfaz bonita con un diseño de código correcto.

Al terminar podrás

Header, Space, Tooltip y campos de texto explican el Inspector
SerializeField no convierte un campo en API pública
Range, Min, OnValidate y RequireComponent protegen capas distintas

Organizar la edición

Header, Space, Tooltip y campos de texto explican el Inspector

Los atributos pueden agrupar valores, añadir ayuda contextual y presentar texto largo. Son útiles para quien configura una escena, pero demasiados grupos en un componente suelen revelar responsabilidades mezcladas.

Header y Space separan grupos visuales.

Tooltip explica unidades, rango o intención.

TextArea y Multiline facilitan contenido extenso.

Ejemplo cotidiano

Configuración legible de un enemigo

Movimiento, combate y presentación aparecen separados; si cada bloque sigue creciendo, se convierten en componentes distintos.

[Header("Movimiento")]
[Tooltip("Unidades de Unity por segundo")]
[SerializeField, Min(0f)] private float velocidad = 3f;

Comprueba lo aprendido · 01

¿Un Header soluciona que un script controle movimiento, audio, inventario y guardado?

Mostrar respuesta ＋

No. Solo organiza su presentación. Las razones de cambio siguen mezcladas y probablemente convenga separar componentes.

Separar accesos

SerializeField no convierte un campo en API pública

La visibilidad en C# y la serialización son decisiones diferentes. Un campo privado serializado puede configurarse en Inspector sin permitir que cualquier script lo modifique. HideInInspector oculta presentación, pero no corrige un acceso público innecesario.

Mantén campos privados por defecto.

Expón propiedades o métodos que protejan invariantes.

Los datos serializados pueden sobrevivir cambios de código y requieren migración cuidadosa.

Ejemplo cotidiano

Vida editable pero protegida

El diseñador configura vidaMaxima y otros scripts solo leen Vida o llaman a RecibirDanio.

[SerializeField, Min(1)] private int vidaMaxima = 100;
public int Vida { get; private set; }

private void Awake() => Vida = vidaMaxima;

Comprueba lo aprendido · 02

¿Por qué public int vida facilita estados inválidos?

Mostrar respuesta ＋

Porque cualquier script podría asignar valores negativos o saltarse reglas. Un método controlado puede validar y notificar el cambio.

Prevenir fallos

Range, Min, OnValidate y RequireComponent protegen capas distintas

Range y Min guían la edición; OnValidate comprueba o normaliza cambios; RequireComponent declara una dependencia estructural; y las guard clauses protegen la ejecución. ContextMenu agrega acciones de prueba o mantenimiento que deben ser deterministas y seguras.

La ayuda del Inspector no reemplaza validación en runtime.

RequireComponent agrega la dependencia, pero aún debes obtenerla.

Una acción de editor debe soportar Undo cuando modifica datos.

Ejemplo cotidiano

Controlador que necesita Rigidbody

Unity agrega el cuerpo requerido y Awake obtiene la referencia una sola vez.

[RequireComponent(typeof(Rigidbody))]
public class Movimiento : MonoBehaviour
{
    private Rigidbody cuerpo;
    private void Awake() => cuerpo = GetComponent<Rigidbody>();
}

Comprueba lo aprendido · 03

¿Range impide que otro script asigne un valor fuera de rango?

Mostrar respuesta ＋

No. Controla la edición desde Inspector. La lógica debe validar cualquier dato crítico cuando se usa o se modifica por código.

Resumen de la sección

Tu recorrido en tres ideas

Header, Space, Tooltip y campos de texto explican el Inspector
SerializeField no convierte un campo en API pública
Range, Min, OnValidate y RequireComponent protegen capas distintas

CIERRE DE LA SECCIÓN

Comprueba que puedes usarlo

Antes de continuar, revisa estos tropiezos frecuentes y resuelve un caso sin copiar los ejemplos.

ERROR 01

Usar campos públicos solo para verlos en Inspector.

ERROR 02

Confiar en Range, Min o RequireComponent como sustitutos de validación en ejecución.

DESAFÍO INTEGRADOR

Ahora hazlo sin guía

Diseña el Inspector de un arma con campos privados serializados, unidades, límites, ayuda, validación y una acción segura para restablecer valores.

Mostrar pauta de corrección ＋

Una respuesta sólida:

La presentación ayuda sin ocultar responsabilidades mezcladas.
La API pública protege invariantes.
Los datos incorrectos se detectan tanto en edición como al ejecutar.