Es el momento de añadir sonido a nuestros proyectos. Todo juego necesita sonido y ahora veremos como se hace en Lua. Empecemos.

Aplicando sonido

LuaPlayer puede reproducir los siguientes formatos: UNI, IT, XM, S3M, MOD, MTM, STM, DSM, MED, FAR, ULT o 669 para música. Los archivos WAV pueden usarse para sonido. Es posible convertir archivos MIDI a alguno de los formatos anteriormente mencionados. Un programa que puede hacerlo es Modplug Tracker. Ten presente que LuaPlayer no soporta archivos MP3.

Después de aprender unos pocos comandos de sonido los aplicaremos junto a lo aprendido anteriormente para crear un pequeño programa.

Miremos el primer comando, el cual reproducirá un archivo de música:

Musica.playFile(nombre_archivo, bucle_infinito)

En nombre_archivo pondrás el nombre del archivo que quieras reproducir, por ejemplo cancion.xm. En bucle_infinito pondrás true (verdadero) o false (falso). True reproducirá la canción una y otra vez y false sólo una vez. Ej:

Musica.playFile("miCancion.mod", true)

Ahora miremos los siguientes comandos, que pueden usarse una vez iniciada la reproducción del archivo de música:

Musica.pause()
Musica.stop()
Musica.resume()

El primero pausará la canción, el segundo parará la canción y el último volverá a reproducir la canción si la has parado temporalmente.

También hay un comando que puede usarse para comprobar si una canción se está reproduciendo o no. Devolverá true (verdadero) o false (falso):

Musica.playing()

Supongamos que queremos probar si nuestra canción se está reproduciendo y si es así entonces mostraremos un mensaje por pantalla. Podemos hacer:

if Musica.playing() == true then
screen:print(10,10,"La musica esta sonando",blanco)
end

También hay un comando para ajustar el volumen del archivo de música. Dentro del paréntesis simplemente pon un número entre 0 y 128:

Musica.volume(numero)

Ahora aprendamos un poquito más sobre archivos de sonido para usarlos como efectos de sonido, concretamente los archivos WAV. El uso es un poco diferente a lo que acabamos de ver. Así es como se carga un sonido:

miSonido = Sound.load("miSonido.wav",false)

El archivo WAV se carga en una variable que más tarde podremos usar para referirnos al sonido. Usamos false para que no suene una y otra vez. Si usásemos true haríamos un bucle, si es lo que necesitas.

Algo muy importante respecto a los archivos WAV en Lua es que deben ser mono y no stereo. Puedes comprobar si un archivo es mono o stereo pinchando con el botón derecho del ratón sobre el archivo, elegir propiedades y luego resumen, ahí lo pone.

El siguiente comando reproducirá el archivo. Usa el nombre de la variable en la que has cargado el sonido. Ej:

miSonido:play()

No recomiendo usar esta forma de reproducir el archivo porque puede conducir a un error muy común, el cual muestra el mensaje loop ingettable. Así es como yo reproduzco mi archivo. Lo único que necesitarás cambiar en el código es:

local sonido = miSonido
voz = sonido:play()

Para detener el sonido:

voz:stop()

También podemos usar un comando para saber si el sonido se está reproduciendo, al igual que con la música:

voz:playing()

Hay más comandos para los sonidos y la música, por si quieres mirarlos, pero éstos son suficientes para manejarnos.

Pongámoslo en práctica

hora vamos a crear un pequeño programa. Empezará en una pantalla de menú donde seremos capaces de seleccionar un fondo azul o negro. Cuando presionemos la X, el programa pasará a la siguiente pantalla con el color de fondo que hayamos seleccionado y mostrará cuantas veces el programa ha sido ejecutado. Bien, cada vez que presionemos la X en la pantalla del menú, se abrirá un archivo que crearemos en breve y escribirá un número en él. El programa también necesitará leer el número del archivo y almacenarlo en una variable. Si sales completamente del programa y posteriormente vuelves a iniciarlo, seguirá mostrando cuantas veces se ha iniciado, ya que está almacenado en un archivo. Vamos allá.

Lo primero que vamos a hacer es crear un fichero de texto normal con el bloc de notas o con cualquier programa que uses. Dentro del archivo de texto escribe el número 0. Salva el contenido con el nombre contador.txt.

Empecemos con el fichero script.lua. Primero crearemos objetos color que usaremos posteriormente:

blanco = Color.new(255,255,255)
azul = Color.new(0,0,255)
negro = Color.new(0,0,0)

Ahora algunas variables:

oldpad = Controls.read()
colorInicio = negro
estadoJuego = "menu"

olpad almacenará el último botón que hayamos pulsado; colorInicio guarda el color que usaremos en la siguiente pantalla, empezaremos con el negro; estadoJuego lo usaremos para ver qué función usar. Haremos dos funciones, una lanzará el menú y la otra lanzará el resto del programa. El valor inicial es menu porque nuestro juego empezará mostrando un menú.

Lo próximo es utilizar sonidos. Descarga estos dos pequeños archivos WAV a la carpeta donde tengas el programa.

Beep y Goodbye

Carguemos esos archivos WAV en nuestro programa. No queremos que se reproduzcan indefinidamente, por lo que usaremos false.

sonidoMenu = Sound.load ("beep.wav",false)
adios = Sound.load("goodbye.wav",false)

Es muy sencillo. Llegados a este punto abriremos nuestro archivo contador.txt, leeremos el valor que contiene y lo guardaremos en la variable contador.

archivo = io.open("contador.txt", "r")
contador = archivo:read("*n")
archivo:close()

Fíjate que usamos "*n" para leer un número.

Ahora crearemos una tabla para nuestra pantalla inicial, que contendrá una imagen que creamos para usarla como selector, así como sus valores x e y (coordenadas).

selector = { imagen = Image.createEmpty(145,15), x = 147,y = 77 }
selector.imagen:clear(azul)

Ahora crearemos una función llamada dibujaMenu() que realizará todas las tareas necesarias del menú. Este es su encabezado:

function dibujaMenu()

Usaremos esta función para limpiar la pantalla y leer los controles en cada bucle. Añade este código:

screen:clear()
pad = Controls.read()

Ahora vamos a mostrar nuestro selector en la pantalla e imprimir dos líneas de texto:

screen:blit(selector.x,selector.y,selector.imagen)
screen:print(150,80,"Iniciar Juego (Negro)",blanco)
screen:print(150,100,"Iniciar Juego (Azul)",blanco)

Fíjate cómo hemos usado los valores de nuestras tablas para mostrar el selector en pantalla. La imagen del selector se moverá arriba y abajo para resaltar la opción de menú seleccionada. Nuestras dos líneas de texto mostrado serán las opciones del menú, empezamos el juego con una pantalla negra o una azul.

Nuestras siguientes secciones dentro de la función comprobarán los botones que presionemos:

if pad:up() and oldpad:up() ~= pad:up() then
selector.y = 77
colorInicio = negro
local sonido = sonidoMenu
voz = sonido:play()
end

Este trozo de código dice que si presionamos arriba y si arriba no fue el último botón presionado entonces ponemos el valor "y" del selector a 77. Hacemos esto para superponer la imagen sobre el texto para que parezca que está seleccionado. A continuación ponemos el color de inicio en negro y reproducimos el sonidoMenu.

Ahora para el botón abajo. Se hace exactamente igual excepto que pondremos la imagen un poco más baja y pondremos el color en azul:

if pad:down() and oldpad:down() ~= pad:down() then
selector.y = 97
colorInicio = azul
local sonido = sonidoMenu
voz = sonido:play()
end

Ahora para el botón X:

if pad:cross() and oldpad:cross() ~= pad:cross() then
estadoJuego = "juego"
contador = contador + 1
archivo = io.open("contador.txt","w")
archivo:write(contador)
archivo:close()
end
end

Hemos puesto el estado de juego en juego para que el código del menú no se siga ejecutando. Incrementamos la variable contador en 1. Abrimos nuestro fichero TXT y escribimos el nuevo valor del contador, reemplazando el valor anterior. Cerramos el archivo y el último end cierra la función.

En la siguiente función vamos a escribir el resto del juego después de que dejemos el menú. Esta función es pequeña y sencilla, por lo que la pongo completa:

function iniciarJuego()
screen:clear(colorInicio)
pad = Controls.read()
 
screen:print(100,100,"Este programa ha sido iniciado " .. contador .. " veces.",blanco)
screen:print(100,110,"Pulsa Start para salir al Menu",blanco)
 
if pad:start() then
estadoJuego = "menu"
local sonido = adios
voz = sonido:play()
end
end

En esta función hemos limpiado la pantalla con el color que hemos seleccionado en el menú usando la variable colorInicio. Se muestran dos mensajes y se comprueba el botón Start, si es pulsado estadoJuego pasará a menu y sonará el archivo WAV.

Ahora empezaremos nuestro bucle principal. Es muy corto y sencillo gracias a nuestras funciones. En el bucle comprobaremos en qué estado está el juego y ejecutaremos la función para ese estado:

while true do
 
if estadoJuego == "menu" then
dibujaMenu()
end
 
if estadoJuego == "juego" then
iniciarJuego()
end
 
screen.flip()
oldpad = pad
end

Pruébalo!!!