Руководство по libgdx

Время на прочтение
5 мин

Количество просмотров 31K

Эта статья — перевод первого туториала для проекта libGDX. Оригинал находится — здесь

От переводчика: недавно у меня появилось желание написать игру под Android. У меня есть некоторый опыт программирования на Java, но я почти не сталкивался с разработкой под Android. Тут я наткнулся на библиотеку libGDX, которая позволяет писать кросплатформенные игры. Также я наткнулся, что по ней не хватает русской документации, а конкретно — туториалов. Поэтому у меня появилось желание перевести туториалы. Это мой первый перевод, поэтому буду рад любым замечаниям и указаниям на неточности.

Настройка проекта

Примечание: есть проблемы с использованием Java 1.7 для Android-приложений. Убедитесь, что вы используете Java 1.6
Примечание: надо сделать несколько шагов для настройки приложения под Android. Смотрите ниже.

Эта статья описывает, как настроить Eclipse для разработки и запуска приложений как на настольном компьютере, так и на Android-устройствах.

Настройка главного проекта

1. Создайте новый Java-проект в Eclipse.
2. Перейдите к каталогу проекта в файловой системе и создайте в нем каталог с названием libs. Загрузите nightly zip (nightly zip — это архив из последней сборкой проекта — прим. переводчика) и положите gdx.jar и gdx-sourses.jar в каталог libs/
3. Щелкните правой кнопкой мыши на проекте в Eclipse, и нажмете Refresh. Снова щелкните правой кнопкой, выберите Properties -> Java Build Path -> Libraries -> Add JARs, выберите jdx.jar и нажмите OK.
4. Щелкните правой кнопкой мыши по файлу gdx.jar -> Properties -> Java source attachment. Нажмите Workspace, выберите gdx-sources.jar и нажмите ОК.
5. Щелкните по вкладке Order and Export, поставьте галочку напротив gdx.jar и нажмите ОК.
Примечание: пятый шаг сделает gdx.jar транзитивно зависимым. Это означает, что проекты, которые зависят от главного проекта, также будут иметь gdx.jar в своем classpath. Однако, это не касается Android-приложений.

Настройка приложения для настольного ПК.

1. Создайте новый проект в Eclipse. Назовите его соответствующим образом (gamename-desktop, например).
2. Перейдите к каталогу проекта в файловой системе и создайте в нем подкаталог с названием libs. Положите библиотеки gdx-natives.jar, gdx-backend-lwjgl.jar, gdx-backend-lwjgl-natives.jar в каталог libs.
3. Щелкните правой кнопкой мыши на проекте, нажмите Refresh. Снова щелкните правой кнопкой мыши -> Properties -> Java Build Path -> Libraries -> Add JARs, выберите три библиотеки из каталога libs и нажмите ОК.
4. Перейдите на вкладку Projects, нажмите Add, выберите созданный выше главный проект и нажмите ОК.

Настройка приложения для Android.

Перед тем, как делать следующие шаги, вам необходимо убедиться, что у вас есть установленный Android SDK.
1. Создайте новый Android-проект в Eclipse. Дайте ему подходящее название (например, gamename-android). В качестве версии Android выберите Android 1.5 или выше. Укажите название пакета (например, com.gamename). Дальше нажмите на «Create Activity» и введите «AndroidGame». Нажмите Finish.
2. Перейдите к каталогу проекта в файловой системе и создайте в нем подкаталог libs. Положите в него библиотеку gdx-backend-android-jar и каталоги armeabi и armeabi-v7a из nightly zip.
3. В Eclipse, нажмите правой кнопкой мыши на проекте, нажмите Refresh. Снова щелкните правой кнопкой мыши на проекте -> Properties -> Java Build Path -> Libraries -> Add JARs, выберите jdx-backend-android.jar и нажмите ОК.
4. Снова нажмите Add JARs, выберите jdx.jar из главного проекта и нажмите ОК.
5. Перейдите на вкладку Projects, нажмите Add, выберите главный проект и нажмите ОК.
6. Перейдите на вкладку Order and Export и поставьте галочку напротив главного проекта.
Примечание: подкаталог libs должен иметь строго такое название. Это связано с соглашениями именования, принятых в Android Eclipse Plugin.

Настройка каталога assets.

Android-проекты имеют подкаталог с названием assets, который создается автоматически. Файлы, которые будут доступны Android-приложению, должны быть размещены там. Это создает проблему, поскольку эти же файлы должны быть доступны для настольного приложения. Лучше настроить приложение для настольного ПК так, чтобы оно могло найти эти файлы в каталоге assets, чем поддерживать две копии файлов. Для этого нужно проделать следующие шаги:

1. Перейдите к свойствам проекта для настольного ПК, выберите Java Build Path, перейдите на вкладку Source и нажмите на Link Source -> Browse, выберите каталог assets из вашего Android-приложения и нажмите ОК.
2. Задайте имя assets в поле Folder Name, нажмите Finish, а затем ОК.

Примечание: если ваше настольное приложение и приложение для Android находятся в одном родительськом каталоге, вы можете использовать «PARENT-1-PROJECT_LOC/gamename-android/assets» для указания связанной папки assets, где gamename-android — название вашего Android-проекта. Это лучше чем жестко заданый путь если вы собираетесь распространять ваши проекты.

Создание игры.

У вашем главном проекте создайте новый класс. Назовите его Game и задайте для него имя пакета (com.gamename, например). В поле Interfaces нажмите Add, выберите ApplicationListener b нажмите ОК. У вас должно появиться что-то похожее:

import com.badlogic.gdx.ApplicationListener;

public class Game implements ApplicationListener {
        public void create () {
        }

        public void render () {
        }

        public void resize (int width, int height) {
        }

        public void pause () {
        }

        public void resume () {
        }

        public void dispose () {
        }
} 

Эти методы позволяют настроить вашу игру и управлять ее отрисовкой. Пока они пусты, эта игра не будет ничего отображать — только пустой экран. Мы должны заставить эту игру запуститься перед тем, как мы сделаем что-то более интересное.

Запуск игры для настольного приложения

Щелкните правой кнопкой мыши на приложении для настольного ПК и создайте новый класс. Назовите его DesktopGame и укажите пакет для него (например, com.gamename). Нажмите ОК. Приведите этот класс к следующему виду:

import com.badlogic.gdx.backends.lwjgl.LwjglApplication;

public class DesktopGame {
        public static void main (String[] args) {
                new LwjglApplication(new Game(), "Game", 480, 320, false);
        }
}

Этот код создаст экземпляр LwjglApplication, передаст ему экземпляр вашей игры, с заданным именем и размерами окна. Последний параметр false указывает, что не нужно использовать OpenGL ES 2.0 (мы будем использовать 1.0/1.1).

Для запуска приложения, щелкните правой кнопкой мыши на проекте -> Debug as -> Java Application. Выберите класс DesktopGame и нажмите ОК. Вы увидите черное окно с заголовком Game. (Мне кажется, проще открыть класс DesktopGame и нажать Ctrl+F11 — прим. переводчика).

Запуск игры на Android.

Откройте класс AndroidGame у вашем Android проекте, который должен создаться автоматически и приведите его к следующему виду:

import com.badlogic.gdx.backends.android.AndroidApplication;

public class AndroidGame extends AndroidApplication {
        public void onCreate (android.os.Bundle savedInstanceState) {
                super.onCreate(savedInstanceState);
                initialize(new Game(), false);
        }
}

Метод initialize в деятельности(Activity) создает и запускает экземпляр нашей игры. Опять же, false означает, что мы не используем OpenGL ES 2.0

Для запуска игры на Android, щелкните правой кнопкой мыши на проекте -> Debug As -> Android Application. Экран будет черным, поскольку наша игра пока ничего не делает. Если будут какие-либо ошибки, они покажутся в Logcat view, которое вы можете открыть, нажав на меню Window -> Show View -> Other -> Android -> Logcat.

Обновление libgdx

Если вам захочется обновить libgdx, скачайте nigtly zip снова и обновите следующие файлы у ваших проектах:

Главный проект: libs/gdx.jar, libs/gdx-sources.jar

Android: libs/gdx-backend-android.jar, libs/armeabi (каталог), libs/armeabi-v7a (каталог)

Настольное приложение: libs/gdx-natives.jar, libs/gdx-backend-lwjgl.jar, libs/gdx-backend-lwjgl-natives.jar

This Full LibGDX Game Tutorial is a full-blown game development tutorial covering all aspects of creating a game using Box2D in libGDX. It is aimed at those people who want to create games but have no knowledge about programming at all. Not only will we cover techniques used to create games but also cover the basics of using java as a language to make games. We will go into how to load images, sounds, music, effects etc with an asset manager which will get rid of the images when they are no longer needed. we will cover how to layout your project so you keep all the different parts in their own group such as game logic on one area, loading in another and rendering in another.

Things we will not cover in this tutorial are being a good programmer, only you can become a good programmer by learning, how to get your game on google play, steam or the app store. That is more marketing than it is creating a game and will not be covered.

Concepts

Before we start I will go over a few concepts that relate to this project: LibGDX is a framework that allows you to code applications in java and allows you to export your application to run on other platforms such as your windows/linux desktop, Android(Android phones), IOS (IPhones iPad) and HTML(in a web browser). This means you only have to write your code once and it will work on those platforms instead of having to make several projects for each platform.

Java is an object-oriented language. This means when you write some code you are writing the blueprint of an object and when your application is run the code will become an object that has its own set of data and actions that can be accessed. Changes to that object will not affect other objects made from the same blueprints without special code. For example, you could write a class called Car and you could make 3 cars. One blue, one green and one yellow. Changing the colour of the blue car will not change the colour or the green or yellow car as they are separate objects.

Java uses a package system to keep groups of code together e.g. All things relating to images would be kept in the image package and all things related to saving files would be in the IO(InputOuput) package. In order to save a file you would need to import both the images package and the IO package.

I think that covers the basics for now, additional information will be given when they pop up in the tutorial.

Creating the project

The first thing we need to do is to setup a new LibGDX Project. If you don’t know how to create a LibGDX project you can read this guide on how to use the LibGDX Project Generator tool to create projects for eclipse. Now we know how to make a project we should make one, and name the main class Box2DTutorial. This will help keep your project in line with this guide. Make sure you add the Box2D extension or you will not be able to import the classes needed for this guide. Below is a screenshot of the settings I used to create my project. NOTE: I have intentionally left out Ai as I will go through adding this via gradle later in this tutorial but you can ad it now if you ae already capable of adding via gradle.

The first thing I do with my games is separate the game into an orchestrator(the boss class), a model for game data and logic processing, views for displaying and rendering and controllers for mapping user input to methods in the model. Our main class will be Box2DTutorial it will be our Orchestrator and be the parent for our upcoming model, views and controllers.

Our base structure will be:

• Box2DTutorial – This is our Orchestrator
• AppPreferences – our preferences class
• Box2DTutorialModel – This is our Model which contains the logic
  • Views
    • LoadingScreen – initial screen to show loading screen.
    • MenuScreen – a menu screen our second screen to show.
    • MainScreen – the screen which shows the game play.
    • PreferencesScreen – shows the preferences and allows them to be changed.
    • EndScreen – show the end game credits etc.
  • Controllers
    • KeyboardController- maps controls to model methods (one for each control type, controller, keyboard, phone accelerometer etc)

Now we have decided on our base structure we can start coding our classes.

Coding

If you followed this guide your main class should be called Box2DTutorial, this is the class we’re going to edit first. The first thing to do is remove the default methods and then change our orchestrator from extending the default class to extending a game class. A game class is used to delegate between different screens. As were going to use 5 screens this class will suit our needs.

The orchestrator should now look like this:

Now we have our orchestrator extending the game class we want it to be able to switch between screens, but we have no screens. Yeah, we need to make these screens. The problem is we don’t have our views package set up yet to place our screens in. Well in eclipse we can just add a new class and set it to the views package and that package will be created with the class. So, let’s do that.

Right click on your Box2DTutorial class and click new > class. This will bring up the add class window. We will add the LoadingScreen class first so in the Name field enter LoadingScreen and in the package field enter blog.gamedevelopment.box2dtutorial.views (if your package structure is different e.g not blog.development, just add .views to the end of the current package text) and click finish. This will create a new default class called LoadingScreen and put it in the package views.

Now we have a loading screen but it doesn’t know how to be a screen because it’s just an empty class. Let’s fix that now. Open your newly created LoadingScreen class and make it extend the Screen class. You will see Screen get highlighted in red, if you hover over it, you will see the error and can view possible options to fix it. We want to import com.badlogic.gdx.Screen, we then get another red highlight on the class name. This is saying the methods for Screen have not been implemented so let’s “Add unimplemented methods”. This automagically fixes our class. Your LoadingScreen should now look like this code:

One down, repeat this for the other 4 screens MenuScreen, MainScreen, EndScreen and PreferencesScreen.

Changing screen

Now we have all our screens we need a way to swap between them. In order to do that we will create a new method called changeScreen in our orchestrator.

This method relies on 4 constants MENU, PREFERENCES, APPLICATION and ENDGAME, these must be defined in our orchestrator as well as the 5 screens. We define the 4 constants using the final static modifiers and our 5 fields for the screens shown in the code below:

Now we have our screens and our changeScreen method we need to set the default screen when the application opens. This is done in the create method. The Game class already has a method called create which is run when the game creates the class, we want to use this method so we use the @Override command to change the default create method to the one we will define now. Note: If you do not @Override the create method then the method will not run. So our create method looks like this:

We have successfully changed the Game class’s create method to create a new LoadingScreen and then set the current screen to display it. At the moment we have no images, sounds or music to load (but we will) so our loading screen can just say “Hey! I’m done loading”. There’s a problem, our LoadingScreen doesn’t know how to tell our orchestrator it’s done loading. In order to do that the LoadingScreen needs to know about the orchestrator, in fact, all our screens need to know about our orchestrator in order to tell it they are done doing what they’re doing. So let’s add a way for our screens to tell the orchestrator they’re done.

We need to add a reference to our orchestrator in each of our screens. This is done by passing the orchestrator object to the screen when we create them. So in our each of our screens, we add a constructor. A constructor is a method that is called when the class is created and can take arguments. To create a constructor you use the classes name as the method name and do not add a return type. So our LoadingScreen constructor would look like this:

Now a blank constructor isn’t going to do much so we need to add our orchestrator argument and assign it to a field in our class so we can access it later.

Do this for each of the screens remembering to change the constructor name to the name of the class. This will allow all our screens to tell the orchestrator when they’re done. Now the screens have been updated the orchestrator needs to be updated to fill in the arguments requested in the constructor of the screens. So change our orchestrator changeScreen method to the following:

Also in the orchestrator replace the loadingScreen code to this

The word “this” is a special word in Java used to represent the current object. As were in the Box2DTutorial class it will reference Box2DTutorial objects. Now all our screens know who the orchestrator is we can finally update our LoadingScreen class to tell the orchestrator they’re done and they should proceed to load the menu screen. In our render method of our LoadingScreen class we need to add the following code:

Creating a Menu screen

So we’re now changing to the menu screen but our menu screen doesn’t do anything yet. We need some buttons. There’s plenty of ways of adding a GUI to a screen including simple images and listening to clicks to using the inbuilt scene-2d. We will be using Scene-2D to create our GUI as it’s relatively simple to use and pretty powerful.

Before we begin your MenuScreen class should look like this:

The first thing we will add is a stage. This is the controller and will react to inputs from the user. In our constructor we add the following code:

We create a new stage with a new ScreenViewport as an argument. This will produce errors and will require you to import the ScreenViewport as you did previously with the LoadingScreen error. You will also get an error from the stage word and the solution is to add a new field. From now on in this guide, I will not prompt you to import new classes used or add fields as these errors are pointed out by eclipse and show their solutions. I will, however, point out errors which require more detailed solutions. We also set the input processor for this screen to the stage. This tells the screen to send any input from the user to the stage so it can respond.

Now the stage is in our class, we will need to tell it to act and draw. If we did not put in this act and draw section the stage would not perform actions after user input and it would not draw the items held within it.

So now we have our stage that will draw its contents, we need to add items for it to draw. Those items are the buttons and the table. We will add 3 buttons to our stage using the table to lay them out in the middle of the screen. The table is like an Excel sheet where you start with one cell and can add a new column or row until you have all the cells you need, unlike Excel you can specify layout properties such as size, padding and fill style irrespective of other cells in the column or row. So, in our show method, let’s add our table to hold out buttons.

We added our table to our stage, now we create some buttons.

In our button code, we have added a new item called a skin. A Skin is libgxd’s way of keeping GUI elements like button textures, fonts and other GUI layout parameters all in one file. In order to use a skin we must first add the images and JSON files that make the skin into our project. To add a skin to your project go to https://github.com/czyzby/gdx-skins and download the skin you want to use for this project. I chose the glassy skin. Once downloaded you will end up with a folder called skin with some .fnt, .atlas, .json and .png files. This skin folder should be placed in your android asset folder. For example, my folder location is:

Now the skin is added to your project folder you need to refresh it in eclipse so it knows to add it to future runs. To do that right click your android project and click the refresh option. Now our skin is added and ready to use in our buttons we need to add our buttons to the table.

In the code above we use “table.add(newGame).fillX().uniform();” This adds our first button to the table and sets it to fill out on the x axis (horizontally) and make it uniform with other cells in this column (currently none). So now we have a table with a single cell containing a button and nothing else. Next we add “table.row().pad(10,0,10,0);” This mean the next table.add() will add their items to the next row instead of suffixing them to the current row. We also set the padding of the new row to 10 pixels top, 0 left, 10 bottom and 0  right. Next, we add our second button similar to the first button and again add a new row, this time with no padding as our previous row is already padding the bottom 10 pixels and finally, we add our last button.

The image below shows how we just created a menu using the row and add methods.

You can now run your project and you should be shown and image similar to the one above (minus the tutorial text). Cool right? Notice any issues? yeah, our buttons don’t stay in the centre when we change the size of our window and if we maximise it we get some flickering issue with the buttons. The centring of the buttons is fixed by updating our stage every time the window is resized. So in our resize method, we add this code:

This tells the stage that the screen size has changed and the viewport should be recalculated. The true boolean, the last argument is what tells the camera to recenter. So that’s the first issue fixed, now how do we fix the flickering. Well, the flickering is caused by the image not being clear each time it is drawn. We must tell it clear the screen before we start drawing the next screen. This is done in our render method before we draw anything so our render method should now look like this:

We finally have something to show for all our work. Yay.

Part 2 of our Full LibGDX Game tutorial will go into how to add actions to your buttons and adding preferences.

Views:
80,393

Версии

Установка или настройка

LibGDX имеет довольно простую настройку с помощью простой Java-программы. Вы можете скачать здесь . Когда вы запускаете приложение, оно будет выглядеть примерно так:
Примечание. Этот снимок экрана был сделан в Linux и показывает путь, который отличается от установки Windows. Однако форма одинакова на любой ОС, совместимой с этим приложением настройки

Ящики ввода

В поле ввода «Имя» указано название игры для вашего проекта. Поле ввода «Пакет» — это пакет для вашего основного класса. Поле ввода «Класс игры» — это основной класс, который вызывается при запуске вашей игры. Поле ввода «Место назначения» — это место назначения, в котором будет создан ваш проект. В поле ввода «Andriod SDK» указан путь к вашему Android-файлу. Это поле ввода полностью необязательно, поэтому, если вы не хотите развернуть приложение на Android, вам не нужно беспокоиться об этом.

---

Подпроекты

Субпроекты — это только платформы, на которые нужно будет развертывать. Эта часть довольно понятна. Если вы не хотите развернуть его в HTML, просто снимите флажок.

---

расширения

Расширения являются официальными расширениями LibGDX. Вот таблица, рассказывающая вам, что каждый из них:

Имя расширения	Описание
пуля	Bullet представляет собой трехмерную систему обнаружения столкновений и динамическую библиотеку динамических тел.
Freetype	Freetype позволяет использовать шрифты .ttf, вместо того, чтобы использовать шрифты Bitmap
инструменты	Позволяет реализовать вывод средств LibGDX.
Контроллеры	Позволяет реализовать контроллеры, такие как контроллеры XBox 360.
Box2D	Физическая библиотека для 2-х игр.
Box2dlights	Позволяет легко добавлять мягкие динамические огни в физическую игру.
Ashley	Крошечная структура сущности
искусственный интеллект	Структура искусственного интеллекта.

Вы можете добавить сторонние расширения, но их данные или имена здесь не отображаются.

---

продвинутый

В разделе «Дополнительно» вы можете установить несколько параметров и создать дополнительные файлы проектов для Eclipse и IDEA IDE.

Имя параметра	Описание
URL-адрес зеркала Maven	Заменяет Maven Central на предоставленный URL Maven
IDEA	Создает файлы проекта Intellij IDEA
Затмение	Создает файлы проекта Eclipse
Автономный режим	Не заставляйте загружать зависимости

---

поколение

После правильной настройки всех ваших настроек вы можете нажать кнопку «Создать». Это может занять пару секунд, но оно будет генерировать основные файлы, а Gradle — для вашего проекта. Как только вы закончите с этим, пришло время импортировать проект в вашу среду IDE.

LibGDX Hello World

основы

Сгенерированные проекты содержат базовое приложение Hello World, подобное уже реализованное.

Основной проект — это основной проект, содержащий весь независимый от платформы код. Это обязательно, но на основе настроек вашего поколения у вас может быть несколько проектов для каждой выбранной вами платформы.

Пример

Откройте com.mygdx.game.MyGdxGame.java в core проекте. Вы увидите следующий код:

public class MyGdxGame extends ApplicationAdapter {
    SpriteBatch batch;
    Texture img;
    
    @Override
    public void create () {
        batch = new SpriteBatch();
        img = new Texture("badlogic.jpg");
    }

    @Override
    public void render () {
        Gdx.gl.glClearColor(1, 0, 0, 1);
        Gdx.gl.glClear(GL20.GL_COLOR_BUFFER_BIT);
        batch.begin();
        batch.draw(img, 0, 0);
        batch.end();
    }
    
    @Override
    public void dispose () {
        batch.dispose();
        img.dispose();
    }
} 

Хотя это ваш основной проект, вы не будете его выполнять напрямую, вам всегда нужно запустить платформенный Launcher, для рабочего стола он называется com.mygdx.game.desktop.DesktopLauncher.java в проекте desktop .

public class DesktopLauncher {
    public static void main (String[] arg) {
        LwjglApplicationConfiguration config = new LwjglApplicationConfiguration();
        new LwjglApplication(new MyGdxGame(), config);
    }
} 

В этом классе вы можете установить настройки для конкретной платформы.

---

Запуск игры

Eclipse и Intellij используют два разных метода для запуска вашего проекта. Найдите IDE, используя ниже.

Запуск с использованием Eclipse

Используя eclipse, вы можете запустить приложение, запустив этот класс как Java-приложение (щелкните правой кнопкой мыши по проекту -> Запустить как -> Java-приложение). Вы увидите следующее окно:

Работа с использованием Intellij Idea

В Intellij вам нужно будет выполнить конфигурацию запуска. Чтобы сделать это, вы должны нажать кнопку в правом верхнем углу, которая выглядит как морковка вниз:

Затем нажмите кнопку «Изменить конфигурации …». Вам будет представлен экран всех ваших текущих конфигураций запуска. Нажмите «+» в левом верхнем углу окна и выберите «Приложение». Оттуда выберите файл «DesktopLauncher» для опции «Основной класс», установите параметр «Использовать путь к модулю» к основному параметру и установите «Рабочий каталог» в папку «Свойства» в вашей основной папке. Конечный продукт должен выглядеть примерно так:

Как только вы это сделаете, вы можете выбрать имя для своей конфигурации запуска и нажать «Применить», затем «ОК». Как только вы закончите с этим, вы можете щелкнуть значок зеленого запуска в правом верхнем углу:

Что происходит в классе MyGdxGame?

Сначала вызывается метод create , который инициализирует пакет, который рисует на экране. Затем метод загружает badlogic.jpg в память.

После этого метод render вызывается повторно до тех пор, пока приложение не будет остановлено. Этот метод сбрасывает цвет фона на красный и рисует изображение на экране. Как вы можете видеть, вам всегда нужно начинать и заканчивать пакетный чертеж. Наконец , когда приложение пытается остановить dispose метод вызывается, что освободит место в памяти , используемой текстуры и партии.

(Хорошо знать, что утилизация может произойти и во время работы на других платформах, например Android, поскольку Android может освобождать пространство памяти, когда приложения находятся в фоновом режиме, но это более сложная тема)

Примечание. Если вы получаете ошибку при запуске, как показано ниже, проверьте этот вопрос для ответа!

Файл не найден: badlogic.jpg (Внутренний)

LibGDX — бесплатная библиотека разработки игр с открытым исходным кодом, разработанная на Java. Цели — позволить пользователям разрабатывать кросс-платформенные игры, которые запускаются на настольных компьютерах, Android, iOS и веб-браузерах. Напишите код один раз, разверните его на любой из основных платформ.

Добавление поддержки для кода, специфичного для платформы

LibGDX разработан таким образом, что вы можете написать один и тот же код и развернуть его на нескольких разных платформах. Тем не менее, есть моменты, когда вы хотите получить доступ к конкретному коду платформы. Например, если у вас есть рейтинги и достижения в вашей игре, вы можете использовать инструменты для платформы (например, Google Play Games) в дополнение к их локальному хранению. Или вы хотите использовать базу данных или что-то совершенно другое.

Вы не можете добавить этот код в основной модуль. Итак, первый шаг — создать интерфейс. Создайте его в основном модуле. Это первая утилита для управления другими интерфейсами:

public interface PlatformWrapper{
    //here you can also add other things you need that are platform specific.
    //If you want to create your own file saver for an instance, a JSON based database,
    //achievements, leaderboards, in app purchases and anything else you need platform specific code for.
    SQLWrapper getSQLSaver();//This one will be used in this example
    AchievementWrapper getAchievementHandler();//this line is here as an example
}

Затем нам нужно создать второй интерфейс — SQLWrapper. Это также входит в основной модуль.

public interface SQLWrapper{
    void init(String DATABASE);
    void saveSerializable(int id, Object o);
    Object loadSerializable(int id, Object o);
    void saveString(int id, String s);
    //.... and other methods you need here. This is something that varies
    //with usage. You may not need the serializable methods, but really need a custom method for saving 
    //an entire game world. This part is entirely up to you to find what methods you need
   
    //With these three methods, always assume it is the active database in question. Unless 
    //otherwise specified, it most likely is
    String getActiveDatabase();
    void deleteDatabase();
    void deleteTable(String table);//delete the active table
}

Теперь вам нужно войти в каждый проект и создать класс для реализации PlatformWrapper и один для реализации SQLWrapper. В каждом проекте вы добавляете необходимый код, например экземпляры, конструкторы и т. Д.

После того, как вы переопределили все интерфейсы, которые вы сделали, убедитесь, что у всех у них есть экземпляр класса, который реализует PlatformWrapper (и что есть геттер). Наконец, вы меняете конструктор в основном классе. Основной класс — это класс, который вы ссылаетесь на пусковую установку. Он либо расширяет ApplicationAdapter, реализует ApplicationListener, либо расширяет Game. Отредактируйте конструктор и добавьте PlatformWrapper в качестве аргумента. Внутри оболочки платформы у вас есть некоторые утилиты (если вы добавили их) в дополнение ко всем другим оберткам (sql, достижениям или другим добавленным вами).

Теперь, если все правильно настроено, вы можете позвонить в PlatformWrapper и получить любой из кросс-платформенных интерфейсов. Вызовите любой метод и (при условии, что выполненный код верен), который вы увидите на любой платформе, он делает то, что он должен делать с конкретным кодом платформы

Менеджер активов

AssetManager — это класс, который помогает вам управлять своими активами.

Во-первых, вам нужно создать экземпляр:

AssetManager am = new AssetManager();

После того, как это будет инициализировано, и перед тем, как что-либо сделать, вы хотите получить ресурсы:

am.load("badlogic.jpg", Texture.class);//Texture.class is the class this asset is of. If it is a 
//sound asset, it doesn't go under Texture. if it is a 3D model, it doesn't go under Texture.class
//Which class added depends on the asset you load

//... other loading here ...//

//when finished, call finishLoading:
am.finishLoading();

Теперь, когда вы чувствуете, что получаете badlogic.jpg :

Texture texture = am.get("badlogic.jpg");
//Ready to render! The rendering itself is in the normal way

Использование AssetManager позволяет загружать их один раз в память AssetManager, а затем получать их столько раз, сколько вы хотите.

Зачем использовать AssetManager? (из вики ):

AssetManager (код) помогает вам загружать и управлять вашими активами. Это рекомендуемый способ загрузки ваших активов из-за следующих хороших поведений:

• Загрузка большинства ресурсов выполняется асинхронно, поэтому вы можете отображать экран реактивной загрузки во время загрузки
• Активы подсчитываются. Если два актива A и B зависят от другого актива C, C не будет удаляться до тех пор, пока не будут выбраны A и B. Это также означает, что если вы загружаете актив несколько раз, он будет фактически разделен и будет занимать память только один раз!
• Единственное место для хранения всех ваших активов.
• Позволяет прозрачно реализовывать такие вещи, как кеши (см. FileHandleResolver ниже)

График 2D-сцены

Когда вы начнете работу с Java или Android, вы быстро узнаете, что (0,0) находится в верхнем левом углу. Однако в LibGDX (0,0) по умолчанию находится в нижнем левом углу.

Используя ортографическую камеру, вы можете получить (0, 0) в верхнем левом углу. Хотя по умолчанию (0, 0) находится в нижнем левом углу. Это то, что важно знать, так как он также изменяет, какой угол текстур имеет координаты X и Y.

We use cookies to ensure that we give you the best experience on our website. If you continue to use this site we will assume that you are happy with it.OkPrivacy policy