El proyecto siguiente trata de un juego de matemáticas en donde se presentan una serie de operaciones elementales -sumas o restas- y el usuario debe ir contestando correctamente los resultados. Se tiene un límite máximo de segundos para contestar la mayor cantidad posible de preguntas. Al consumirse el tiempo se dice los puntos obtenidos y se muestra el record que se ha obtenido en el dispositivo. Si se ha logrado un nuevo record, éste se almacena como el nuevo valor máximo. Para esto, y es uno de los propósitos del proyecto, se usa una base de datos local. A continuación se muestra el diseño:
Y de la pantalla inicial:
Diseño
Al igual que en ocasiones anteriores simularemos dos pantallas. Una pantalla que se muestra al inicio de la app y también al finalizar un juego para mostrar el puntaje. Con la posibilidad de comenzar un juego nuevo. Una "segunda pantalla" en donde se presenta un juego consistente en, dada una operación generada aleatoriamente, escribir el resultado correcto. El resultado se escribe oprimiendo el teclado presentado en la pantalla. Si el resultado es correcto se genera y presenta una nueva operación, si es incorrecto se sigue presentando la misma operación hasta que se escriba la respuesta correcta o bien se termine el tiempo. El tiempo se presenta en segundos, decrementandose cada instante que trascurre.
Los componentes de la primera pantalla son:
Una 'Disposición Horizontal' y dentro:
Un 'Botón' para comenzar un nuevo juego
Una 'Disposición Vertical' que servirá como el fondo de la pantalla, y dentro dos etiquetas:
Una 'Etiqueta' para escribir el record.
Otra 'Etiqueta' para escribir los puntos del último juego.
Estos componente horizontales se ponen visibles al inicio de la aplicación. La segunda pantalla está formada por:
Una sola 'Disposición Vertical' de, podríamos llamar, primer nivel; es solamente como un "contenedor", en el sentido de que todos los demás componentes (visibles) se colocan dentro de esta disposición vertical. La ventaja con ello es que solo se necesita poner este componente como no-visible o visible para pasar a la primera pantalla o a la segunda, respectivamente. Dentro de ella:
Una 'Disposición horizontal' que agrupa:
Una 'Etiqueta' para escribir el tiempo restante (en segundos).
Otra 'Etiqueta' para indicar si el resultado proporcionado es correcto o no.
Una 'Disposición horizontal' que contiene:
Una 'Etiqueta' para mostrar la operación a resolver y que ha sido generada aleatoriamente.
Una 'Etiqueta' a que contiene el número que el usuario va formando para escribir su resultado propuesto.
Una 'Matriz' de tres renglones y cuatro columnas, de botones con los dígitos. Los componentes de la matriz son todos botones.
En el primer renglón cuatro 'botones' correspondientes a los dígitos 1, 2, 3, 4.
En el segundo renglón cuatro 'botones' correspondientes a los dígitos 5, 6, 7, 8.
En el tercer renglón cuatro 'botones'. Dos correspondientes a los dígitos 9, 0. Otro correspondiente al signo menos y otro correspondiente al símbolo para Borrar.
Finalmente, pero no menos importantes, hay tres componentes no-visibles:
Un sensor Temporizador, o 'Reloj', llamado Clock1. Permite estar monitoreando el resultado que ha escrito el usuario para saber si en algún momento coincide con el resultado correcto de la operación. Este temporizador va a monitorear la respuesta escrita cada 10 ms (milisegundos) por eso su propiedad 'IntervaloDelTemporizador' se pone a 10.
Otro sensor 'Reloj', llamado Timer, quien lleva la cuenta de los segundos restantes del juego. Para que cuente segundos, su propiedad 'IntervaloDelTemporizador' se pone a 1000 (milisegundos, igual a 1 segundo).
Un componente de almacenamiento local, 'TinyDB', para almacenar, de manera local, el record alcanzado en el juego, en el dispositivo.
Bloques
Cuando la aplicación se inicia se realiza una petición a la base da datos propia de la app, TinyDB, para obtener el valor guardado bajo la llave con etiqueta "MaxPuntos". Si esta etiqueta existe, el valor asociado e ella -que es el record del juego- se asigna a la variable global globalMax. Por el contrario, si la etiqueta no existe previamente -digamos porque es la primera vez que se ejecuta el juego en la app-, la petición regresa el valor 0 (o bien cualquier otro que se quiera definir, 0 en este caso tiene sentido). Expliquemos de paso el uso de las variables globales:
a, uno de los dos operandos de la operación que se planteará como pregunta, su valor es generado aleatoriamente.
op, indica la operación a realizar: 0 si es suma, 1 si es resta.
b, el otro operando de la operación.
resultado, el resultado correcto de la operación generada.
opTxt, el símbolo de la operación generada, es decir, '+' o '-'
puntaje, el número de aciertos del usuario en este juego.
globalMax, el record del juego en toda su historia.
tiempoRestante, el tiempo restante del juego en segundos, con valor de 10 al inicio.
Nuevo juego
Lo único que se puede hacer al comenzar la app es dar un clic en el botón de 'Juego nuevo'. Al ocurrir este evento se pasa a la segunda pantalla poniendo visible éste, es decir, 'VerticalArrangementJuego'. Se pone no-visible la primera, es decir, haciendo 'HorizontalArrangementInicio' y 'PantallaFinal' como no visibles. Se da reset a los relojes. El tiempo que dura una partida se inicia en 10 (segundos). El puntaje se inicia en 0 y se llama al procedimiento 'nuevaPregunta' que es el encargado de generar la nueva operación de manera aleatoria y escribir en la pantalla esta operación. Se ha definido esto como procedimiento por claridad, con el fin de que no queden bloques muy grandes.
Procedimiento nuevaPregunta
En este procedimiento primero: la etiqueta en donde se va presentando el resultado propuesto por el usuario se pone como "vacía", es como empezar de la "nada". Después, se generan los dos operandos, a y b (en el rando 1 a 19), y la operación, op. Si op=0 se trata de una suma, de aquí que el signo '+' se guarda en opTxt o se guarda '-' si es resta. En la etiqueta 'OperacionLbl' se guarda (como texto) esta operación para ser presentada en la pantalla. Por último, el resultado (real) de la operación se almacena en resultado (por supuesto, tomando en cuenta si es suma o resta):
¿Cómo se forma el número escrito por el usuario?
Es una pregunta interesante ésta. El usuario aprieta los botones tratando de "formar" el número del resultado. Cada vez que se apriete el botón de un dígito, este dígito se pone a la derecha del subresultado que se había formado antes (en la etiqueta 'ResultadoLbl'). Si se aprieta el botón del 0, por supuesto que hay que agregar un '0', si se aprieta el botón del 1 se debe agregar un '1', etc., de tal manera que es conveniente definir un procedimiento para hacer esto. Este procedimiento, llamado 'agregaDid' tiene precisamente un parámetro 'd' que indica el dígito a agregar y lo que hace es concatenar por la derecha del resultado guardado en 'ResultadoLbl' el nuevo dígito tecleado 'd'. Todos los eventos 'clic' de los botones de dígitos realizan la misma acción, llamar al procedimiento 'agregaDig' con el valor del dígito correspondiente.
Cuando se da clic en 'Borra' se borra todo el resultado parcial. Cuando se da clic en el 'Menos' se pone el signo '-' al inicio del resultado (y no al final). Estos bloques aquí van:
¿Cómo saber si un resultado es correcto?
Cada 10 milisegundos se está monitorendo lo que se ha escrito como resultado en la etiqueta 'ResultadoLbl'. Esto se hace mediante el evento 'Clock1.Temporizador'. Si en algún momento el resultado que ha escrito el usuario coincide con el resultado real de la operación entonces se da por válido y así lo anuncia poniendo el mensaje 'Correcto'. El puntaje se incrementa en 1 y también se da como bonus un segundo extra. Después se genera una nueva pregunta:
Recordemos que hay un tiempo máximo del juego y, por tanto, cada segundo cuenta. El componente encargado de llevar el tiempo es el sensor de tiempo 'Timer', en su evento 'Timer.Temporizador', Si todavía no se ha acabado el tiempo entonces se debe decrementar en 1 el tiempo disponible. Como medida de aviso el tiempo restante se escribe en color azul si aún falta "mucho" (más de 5 segundos) tiempo pero, si restan pocos segundos (5 o menos) entonces el tiempo restante se escribe en color rojo para que el jugador sepa que está por acabarse su tiempo. Una vez seleccionado el color a utilizar, escribe el tiempo restante. Pero, si ya se acabó el tiempo entonces llama a un procedimiento para finalizar el juego. Nuevamente este proceso de fin de juego se ha puesto como un procedimiento por claridad.
Finalizando un juego
Al finalizar un juego se regresa a la pantalla inicial y se escribe el puntaje obtenido. Si este puntaje representa un nuevo record, este valor se registra en la base de datos de la aplicación. Este proceso lo realiza el procedimiento llamado precisamente 'finalizaJuego' y lo que hace es poner el componente 'VerticalArrangementJuego' como falso (oculta la segunda pantalla), deshabiita los relojes y pone los componentes de la primera pantalla como visibles haciendo 'HorizontalArrangementInicio' y 'PantallaFinal' como visibles.
Se escribe el record histórico del juego y también los puntos obtenidos en el juego que acaba de concluir. Se escribe que el tiempo restante es cero y se llama a otro procedimiento, 'veRecord' para revisar si se ha alcanzado un nuevo record.
El procedimiento 'veRecord' pregunta si el puntaje obtenido en el último juego es un nuevo record para, de ser así, actualizar el valor de la variable 'globalMax' que lleva el record y también guarda este nuevo record en la base de datos de la app llamando al método de TinyDB1 llamado GuardarValor, con llave 'MaxPuntos' y valor 'puntaje'. Finalmente, escribe en la pantalla el nuevo record.