Reproduce el problema antes de corregirlo | Curso de desarrollo de videojuegos con IA

220. Identidad de la lección

Módulo: 1.4 — Controles y entrada
Lección: Reproduce el problema antes de corregirlo
Tipo académico: Laboratorio de depuración
Tipo de esquema: Práctica
Orden: 2 del módulo
Tiempo estimado: Unos 30 minutos, incluida la evaluación

221. Objetivo de aprendizaje

Al terminar esta lección, podrás escribir una reproducción precisa mediante pasos del jugador que registre el contexto de ejecución pertinente y el comportamiento observado sin adivinar la causa.

222. Por qué importa

Un informe sobre los controles es evidencia, no una explicación. Si corriges la primera causa que sospechas, podrías modificar el modo, la acción o la ruta del dispositivo equivocados. Una reproducción fiable proporciona un punto de partida estable para investigar: otra persona debería poder realizar la misma acción en el mismo contexto pertinente y comprobar el mismo resultado.

223. Conocimientos previos

Debes haber completado 1.4 L1 — Los modos controlan el dispositivo. Debes poder identificar el modo de entrada activo y las acciones que controla. También necesitas el lenguaje del bucle de la Etapa 1: ACTUAR → RESPONDER → CAMBIAR → OTRA VEZ.

224. Concepto central

Una reproducción es un procedimiento, no una teoría.

Una reproducción útil indica el contexto inicial, la acción exacta del jugador y el resultado observable. No afirma por qué ocurrió el resultado.

“Al pulsar una vez el control de confirmar en el modo Diálogo, el aviso actual sigue visible” es una observación. “El gestor del diálogo está roto” es una suposición sobre la causa.

Mantén separados estos registros:

Campo	Qué registrar	Ejemplo
Contexto inicial	Estado y datos pertinentes del dispositivo o la ejecución	Modo Diálogo; aviso visible; mando; compilación probada identificada
Paso del jugador	Acción y secuencia exactas	Pulsar una vez el control asignado a confirmar
Respuesta observada	Lo que el jugador puede ver u oír	El aviso actual sigue visible
Cambio esperado	Qué debería haber ocurrido y según qué fuente	El diálogo debería avanzar, según la regla de interacción indicada
Hipótesis	Una explicación posible marcada como no verificada	No verificada: puede que el modo activo no controle confirmar

Registra los datos del dispositivo o de la ejecución solo cuando puedan afectar a la reproducción. Entre los datos pertinentes pueden estar el dispositivo de entrada o la asignación de controles, la compilación o plataforma, el navegador y el modo activo. No añadas información del sistema que no influya en la prueba.

El resultado esperado también necesita una referencia: una regla de diseño, una especificación, un criterio de aceptación, un comportamiento ya establecido u otra fuente indicada. Si no hay una fuente disponible, etiqueta la expectativa como provisional en lugar de presentar una suposición personal como comportamiento establecido.

225. Modelo mental

Usa Observado → Esperado → Hipótesis.

Observado: ¿Qué ocurrió después de una acción concreta del jugador?
Esperado: ¿Qué cambio visible o audible debería haber ocurrido y qué fuente respalda esa expectativa?
Hipótesis: ¿Qué podría explicar la diferencia? Márcalo como no comprobado.

Una reproducción está completa cuando otra persona puede partir del contexto indicado, realizar la acción exacta y comprobar la misma observación. La hipótesis es opcional y nunca sustituye a los pasos.

Para el bucle de la Etapa 1, documenta la secuencia así:

ACTUAR: Realiza una acción concreta del jugador.
RESPONDER: Registra la respuesta visible o audible inmediata.
CAMBIAR: Registra el cambio que ocurrió o que no ocurrió.
OTRA VEZ: Restablece el mismo contexto inicial y repite para comprobar la consistencia.

226. Ejemplo concreto

Informe débil:

Confirmar está roto porque el sistema de diálogo ignora el botón.

Reproducción mejorada:

Contexto: El modo Diálogo está activo; se ve un aviso con una instrucción para confirmar; la prueba usa un mando con su asignación actual; la compilación probada está identificada.

Desde el contexto indicado, pulsa una vez el control asignado a confirmar.
Observa que la línea actual sigue visible y no aparece la siguiente.
Vuelve al mismo aviso con el mismo modo, dispositivo, asignación y compilación.
Pulsa otra vez el mismo control una sola vez.
Registra si el resultado vuelve a ocurrir.

Resultado esperado y fuente: El diálogo avanza después de una acción de confirmar, según la regla de interacción indicada. Si no se puede localizar esa regla, escribe: “Expectativa provisional: el diálogo avanza después de una acción de confirmar”.

Hipótesis no verificada: Puede que el modo activo no esté recibiendo o controlando la acción de confirmar.

La hipótesis queda fuera de la reproducción numerada.

227. Errores comunes

Nombrar una causa en lugar de proporcionar pasos del jugador.
Omitir un dato del dispositivo, la asignación, el modo, la compilación, la plataforma o el navegador que podría cambiar el resultado.
Tratar una suposición personal como el comportamiento esperado ya establecido.
Repetir desde un estado distinto y afirmar que el resultado es consistente.
Modificar el código antes de conservar la observación original.

228. Práctica guiada

Crea una reproducción para este informe inventado: “Al pulsar el botón de acción cerca de una puerta cerrada, no ocurre nada.” No edites código ni nombres todavía una causa.

Escribe estas partes:

Contexto inicial: Modo activo, posición del jugador, estado visible de la puerta y cualquier dato del dispositivo, la asignación, la compilación o la plataforma que pueda afectar a la prueba.
ACTUAR: La acción exacta, incluida la diferencia entre pulsar una vez, mantener pulsado o realizar una secuencia.
RESPONDER y CAMBIAR: Lo que observa el jugador y qué cambio no se produce.
Resultado esperado y fuente: Cita la regla o especificación disponible. Si no hay ninguna, marca la expectativa como provisional.
OTRA VEZ: Explica cómo restablecer el mismo contexto y repetir la prueba.
Hipótesis: Escribe una causa posible, márcala como no verificada y mantenla fuera de los pasos numerados.

229. Evaluación práctica

Transforma esta queja ambigua sobre los controles en una reproducción completa:

“A veces el botón del menú no hace nada.”

Formato de entrega

Entrega un informe breve con esta estructura:

Contexto inicial:
Pasos numerados del jugador:
Resultado observado:
Resultado esperado y fuente:
Procedimiento para restablecer y repetir:
Hipótesis no verificadas:

No propongas ni apliques una corrección.

Rúbrica: 6 puntos

Asigna un punto por cada criterio:

Contexto inicial: Indica el modo o la pantalla inicial e incluye únicamente los datos pertinentes del dispositivo, control, asignación, compilación, plataforma o navegador.
Acción exacta: Usa pasos numerados y especifica la acción de control y su secuencia exactas.
Resultado observado: Registra un resultado visible o audible sin inferir una causa.
Resultado esperado: Indica el cambio esperado y nombra su fuente, o deja claro que la expectativa es provisional.
Restablecer y repetir: Explica cómo recuperar el mismo contexto y repetir la acción para comprobar la consistencia.
Separación de hipótesis: Mantiene las causas posibles fuera de la reproducción y las etiqueta como no verificadas.

Umbral: Una reproducción completa obtiene 6 de 6 puntos. Revisa cualquier criterio ausente antes de pasar al diagnóstico.

Autoevaluación con un modelo

Compara tu trabajo con este modelo para otra queja inventada:

“Confirmar no hace avanzar el aviso.”

Contexto inicial: Modo Diálogo; aviso visible; asignación del teclado sin cambios; compilación probada identificada.
Pasos: 1. Abre el aviso indicado. 2. Pulsa una vez la tecla asignada a confirmar. 3. Observa el aviso. 4. Restablece el mismo aviso y repite una vez.
Resultado observado: El aviso actual sigue visible después de cada pulsación.
Resultado esperado y fuente: El aviso avanza después de una acción de confirmar, según la regla de interacción indicada. Si esa regla no está disponible, la expectativa es provisional.
Restablecer y repetir: Vuelve a abrir el mismo aviso con el mismo modo, asignación, dispositivo y compilación; después, repite la acción.
Hipótesis no verificada: Puede que el modo activo no controle la acción de confirmar.

Usa el modelo para comprobar la estructura; no copies sus detalles en tu informe sobre el botón del menú.

230. Lista de comprobación

Antes de entregar, confirma que tu informe:

ofrece a otra persona un contexto inicial repetible;
registra solo los datos de contexto que podrían afectar al resultado;
usa acciones numeradas del jugador;
distingue la observación de la expectativa;
identifica la fuente de la expectativa o la marca como provisional;
restablece el mismo contexto antes de repetir;
mantiene todas las causas propuestas fuera de la reproducción.

231. Ideas clave

Una reproducción describe lo que hace el jugador y lo que observa.
El dispositivo y el contexto de ejecución pertinentes pueden ser necesarios para repetir el resultado.
El comportamiento esperado necesita una fuente indicada; una expectativa sin respaldo es provisional.
El comportamiento observado, el comportamiento esperado y las causas posibles son registros distintos.
Usa ACTUAR → RESPONDER → CAMBIAR → OTRA VEZ para conservar la secuencia antes de proponer una corrección.

232. Próxima lección

Continúa con 1.4 L3 — Bloqueo del puntero frente a opciones pulsables.