Tutorial avanzado de QML 2: rellenar el lienzo del juego
Generación de los bloques en JavaScript
Ahora que ya hemos definido algunos tipos, empecemos a programar el juego.
La primera tarea consiste en generar los bloques del juego. Cada vez que se hace clic en el botón «Nueva partida», el lienzo del juego se rellena con un nuevo conjunto aleatorio de bloques. Dado que necesitamos generar dinámicamente nuevos bloques para cada nueva partida, no podemos utilizar ` Repeater ` para definir los bloques. En su lugar, crearemos los bloques en JavaScript.
Aquí está el código JavaScript para generar los bloques, incluido en un nuevo archivo, « samegame.js ». A continuación se explica el código.
var blockSize = 40;
var maxColumn = 10;
var maxRow = 15;
var maxIndex = maxColumn * maxRow;
var board = new Array(maxIndex);
var component;
//Index function used instead of a 2D array
function index(column, row) {
return column + (row * maxColumn);
}
function startNewGame() {
//Delete blocks from previous game
for (var i = 0; i < maxIndex; i++) {
if (board[i] != null)
board[i].destroy();
}
//Calculate board size
maxColumn = Math.floor(background.width / blockSize);
maxRow = Math.floor(background.height / blockSize);
maxIndex = maxRow * maxColumn;
//Initialize Board
board = new Array(maxIndex);
for (var column = 0; column < maxColumn; column++) {
for (var row = 0; row < maxRow; row++) {
board[index(column, row)] = null;
createBlock(column, row);
}
}
}
function createBlock(column, row) {
if (component == null)
component = Qt.createComponent("Block.qml");
// Note that if Block.qml was not a local file, component.status would be
// Loading and we should wait for the component's statusChanged() signal to
// know when the file is downloaded and ready before calling createObject().
if (component.status == Component.Ready) {
var dynamicObject = component.createObject(background);
if (dynamicObject == null) {
console.log("error creating block");
console.log(component.errorString());
return false;
}
dynamicObject.x = column * blockSize;
dynamicObject.y = row * blockSize;
dynamicObject.width = blockSize;
dynamicObject.height = blockSize;
board[index(column, row)] = dynamicObject;
} else {
console.log("error loading block component");
console.log(component.errorString());
return false;
}
return true;
}La función ` startNewGame() ` elimina los bloques creados en la partida anterior y calcula el número de filas y columnas de bloques necesarios para llenar la ventana de juego de la nueva partida. A continuación, crea una matriz para almacenar todos los bloques del juego y llama a ` createBlock() ` para crear los bloques suficientes para llenar la ventana de juego.
La función ` createBlock() ` crea un bloque a partir del archivo ` Block.qml ` y coloca el nuevo bloque en su posición en el lienzo del juego. Esto implica varios pasos:
- Qt.createComponentSe llama a () para generar un tipo a partir de `
Block.qml`. Si el componente está listo, podemos llamar a `createObject()` para crear una instancia del elemento `Block`. - Si
createObject()devuelve null (es decir, si se ha producido un error al cargar el objeto), se muestra la información del error. - Coloca el bloque en su posición en el tablero y establece su anchura y altura. Además, guárdalo en la matriz de bloques para futuras consultas.
- Por último, muestra la información del error en la consola si el componente no se ha podido cargar por algún motivo (por ejemplo, si falta el archivo).
Conexión de componentes de JavaScript a QML
Ahora necesitamos llamar al código JavaScript de samegame.js desde nuestros archivos QML. Para ello, añadimos esta línea a samegame.qml, que importa el archivo JavaScript como módulo:
import "samegame.js" as SameGameEsto nos permite hacer referencia a cualquier función de samegame.js utilizando «SameGame» como prefijo: por ejemplo, SameGame.startNewGame() o SameGame.createBlock(). Esto significa que ahora podemos conectar el controlador onClicked del botón «New Game» a la función startNewGame(), de la siguiente manera:
Button {
anchors { left: parent.left; verticalCenter: parent.verticalCenter }
text: "New Game"
onClicked: SameGame.startNewGame()
}Así pues, al hacer clic en el botón «Nueva partida», se invoca startNewGame() y se genera un campo de bloques, de esta forma:

Ahora tenemos una pantalla llena de bloques y podemos empezar a añadir la mecánica del juego.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.