Introducción a AndEngine (Parte I)

Qué es AndEngine

AndEngine es un Engine 2d usando Opengl para juegos para la plataforma Android.

En AndEngine se usa una terminología propia, explico aquí los conceptos más básicos

• BaseGameActivity: El BaseGameActivity es la raiz del juego, que contiene el motor y crea la vista donde se va a dibujar todo. Hay siempre exactamente un solo Engine por cada BaseGameActivity.
• Engine: El Engine es el motor interno del juego, se encarga de ir dibujando en pantalla y actualizando objetos en la escena, que contiene todo el contenido que tu juego lleva. Normalmente hay una escena por por Engine, a menos que vayas a usar un SplitScreenEngines.
• IResolutionPolicy: Una implementacion de IResolutionPolicy interface es parte del EngineOptions. Te hace abstraerte de la resolución del terminal, tú trabajas para una resolución y el AndEngine se encarga del resto.
• Camera: Un objeto Camera define el rectangulo visible actualmente de la escena actual, no tiene porqué ser la escena completa. Normalmente hay una cámara por escena. Hay subclases específicas que permiten hacer zoom y mover la cámara suavemente.
• Scene: La clase Scene es el contenedor para todos los objetos que se van a dibujar en la escena. Una escena puede tener Layers, que son capas para ordenar objetos. Hay subclases de la Scene como CameraScene/HUD/MenuScene que tienen comportamientos específicos.
• Entity: Una entidad es un objeto que puede ser dibujado, como Imagenes, rectángulos, Texto, Líneas. Una entidad tiene posición/rotación/zoom/color...
• Texture: Una textura es una imagen que se guarda en memoria. En Android, las imágenes deben ser una potencia de 2.
• ITextureSource: Una implementacion de ITextureSource-interface se encarga de cargar una imagen en una posición en la textura.
• TextureRegion: Una TextureRegion define un rectangulo en una imagen. Las TextureRegion se usan por Sprites para usar una imagen grande en la que guardamos muchas imagenes pequeñicas.
• PhysicsConnector: Motor de físicas integrado en el Engine

Obteniendo AndEngine

Para obtener andEngine, puedes bajar los fuentes de su página y también puedes bajar un jar preparadito, que es lo que yo he usado para esta introducción.

Primero bajamos este archivo y lo guardamos en el equipo.

Creación del proyecto en Eclipse

Comenzamos como siempre File -> New Project.

Siguiente y Finish. Ahora creamos una carpeta lib en la raiz del proyecto

Ahora arrastramos el archivo descargado a la carpeta lib de eclipse. Se queda algo así.

Ahora botón derecho en el archivo andengine.jar y le damos a Build Path -> Add to Build Path.

Ahora vamos al archivo Main.java y cambiamos Activity por BaseGameActivity. Eliminamos el constructor, organizamos los imports, implementamos los métodos de BaseGameActivity y nos queda algo como esto.

package com.pruebas.andengine;

import org.anddev.andengine.engine.Engine;
import org.anddev.andengine.entity.scene.Scene;
import org.anddev.andengine.ui.activity.BaseGameActivity;
import android.os.Bundle;

public class Main extends BaseGameActivity {
 @Override
 public void onLoadComplete() {
  // TODO Auto-generated method stub
  
 }

 @Override
 public Engine onLoadEngine() {
  // TODO Auto-generated method stub
  return null;
 }

 @Override
 public void onLoadResources() {
  // TODO Auto-generated method stub
  
 }

 @Override
 public Scene onLoadScene() {
  // TODO Auto-generated method stub
  return null;
 }
}

Ahora cambiamos un poco la estructura del archivo para que se vea todo un poco más claro

package com.pruebas.andengine;

import org.anddev.andengine.engine.Engine;
import org.anddev.andengine.entity.scene.Scene;
import org.anddev.andengine.ui.activity.BaseGameActivity;

public class Main extends BaseGameActivity {
 // ===========================================================
 // Constants
 // ===========================================================
 
 // ===========================================================
 // Fields
 // ===========================================================
 
 // ===========================================================
 // Constructors
 // ===========================================================

 // ===========================================================
 // Getter & Setter
 // ===========================================================

 // ===========================================================
 // Methods for/from SuperClass/Interfaces
 // ===========================================================
 
 @Override
 public void onLoadComplete() {
  // TODO Auto-generated method stub
  
 }

 @Override
 public Engine onLoadEngine() {
  // TODO Auto-generated method stub
  return null;
 }

 @Override
 public void onLoadResources() {
  // TODO Auto-generated method stub
  
 }

 @Override
 public Scene onLoadScene() {
  // TODO Auto-generated method stub
  return null;
 }
 
 // ===========================================================
 // Methods
 // ===========================================================

 // ===========================================================
 // Inner and Anonymous Classes
 // =========================================================== 
}

Empezando

Ahora vamos a crear una cámara necesaria para el funcionamiento del juego. Creamos variables para definir sobre que resolucion vamos a trabajar y una variable para el TAG que vamos a usar para los mensajes de Log

 // ===========================================================
 // Constants
 // ===========================================================
 static final int CAMERA_WIDTH = 480;
 static final int CAMERA_HEIGHT = 320;
 
 private static final String TAG = "AndEngineTest";

 // ===========================================================
 // Fields
 // ===========================================================
 
 private ZoomCamera mCamera;

Ahora implementamos el procedimiento onLoadEngine()

 @Override
 public Engine onLoadEngine() {
  this.mCamera = new ZoomCamera(0, 0, CAMERA_WIDTH, CAMERA_HEIGHT);
  return new Engine(new EngineOptions(true, ScreenOrientation.LANDSCAPE, new RatioResolutionPolicy(CAMERA_WIDTH, CAMERA_HEIGHT), this.mCamera));
 }

Así definimos la cámara, esencial para poder ver algo. Ahora implementamos el procedimiento onLoadScene() y le ponemos un color de fondo.

       @Override
        public Scene onLoadScene() {
                this.mEngine.registerUpdateHandler(new FPSLogger());

                final Scene scene = new Scene(1);
                scene.setBackground(new ColorBackground(0, 0, 0.8784f));
 
                return scene;
        }

Después de organizar los imports y dejarlo todo bonico nos queda así:

package com.pruebas.andengine;

import org.anddev.andengine.engine.Engine;
import org.anddev.andengine.engine.camera.ZoomCamera;
import org.anddev.andengine.engine.options.EngineOptions;
import org.anddev.andengine.engine.options.EngineOptions.ScreenOrientation;
import org.anddev.andengine.engine.options.resolutionpolicy.RatioResolutionPolicy;
import org.anddev.andengine.entity.scene.Scene;
import org.anddev.andengine.entity.scene.background.ColorBackground;
import org.anddev.andengine.entity.util.FPSLogger;
import org.anddev.andengine.ui.activity.BaseGameActivity;

public class Main extends BaseGameActivity {
 // ===========================================================
 // Constants
 // ===========================================================
 static final int CAMERA_WIDTH = 480;
 static final int CAMERA_HEIGHT = 320;
 
 private static final String TAG = "AndEngineTest";
 
 
 // ===========================================================
 // Fields
 // ===========================================================
 
 private ZoomCamera mCamera;
 
 // ===========================================================
 // Constructors
 // ===========================================================

 // ===========================================================
 // Getter & Setter
 // ===========================================================

 // ===========================================================
 // Methods for/from SuperClass/Interfaces
 // ===========================================================
 
 @Override
 public void onLoadComplete() {
  // TODO Auto-generated method stub
  
 }

 @Override
 public Engine onLoadEngine() {
  this.mCamera = new ZoomCamera(0, 0, CAMERA_WIDTH, CAMERA_HEIGHT);
  return new Engine(new EngineOptions(true, ScreenOrientation.LANDSCAPE, new RatioResolutionPolicy(CAMERA_WIDTH, CAMERA_HEIGHT), this.mCamera));
 }

 @Override
 public void onLoadResources() {
  // TODO Auto-generated method stub
  
 }

 @Override
 public Scene onLoadScene() {
  this.mEngine.registerUpdateHandler(new FPSLogger());

        final Scene scene = new Scene(1);
        scene.setBackground(new ColorBackground(0, 0, 0.8784f));

        return scene;
 }
 
 // ===========================================================
 // Methods
 // ===========================================================

 // ===========================================================
 // Inner and Anonymous Classes
 // =========================================================== 
}

Ahora vamos a arrancar la aplicación para ver un color de fondo. Vamos a run Configurations

Apply -> Run y ya podemos ver en nuestro terminal nuestro primer programa con AndEngine.

Con esto termina la primera parte del tutorial, en la segunda entrega el objetivo es pintar objetos en pantalla, definir una escena mayor que lo que se puede ver en pantalla y moverse por la pantalla con TouchEvents