Добро пожаловать в Android Helper Documentation

О проекте

Описание и подробности

Case Simulator Redux - это улучшение старого проекта Case Simulator, которое было сделано с нуля. И теперь не страшно смотреть на код (не для новичков). А так же дизайн стал более красивый, и такой же минималистичный, чтобы не было затруднений в его изменении под себя.

Что нового?

  • Переработан дизайн и иерархия проекта;
  • С нуля переписаны скрипты;
  • Доступен вариант покупки кейсов за игровую валюту;
  • Инвентарь без ограничений;
_images/image10.png

Главное меню

_images/image14.png

Панель открытия кейса

_images/image16.png

Панель получения оружия

_images/image15.png

Панель инвентаря

Требования:

  • Unity 2018.4.2f1+;
  • .NET 4.x;

Осторожно

Если поставить .NET 3.5, то будут ошибки в коде, потому что в проекте используется новый синтаксис .NET 4.x.

Дополнительная информация о проекте:

  • .unitypackage файл;
  • Последнее обновление: 21.08.2019;

Как начать?

Открытие проекта

Примечание

Описание объектов и их полей можете прочитать в разделе API.

После скачивания проекта, у вас будет .unitypackage файл. После вам надо создать новый 2D проект, и импортировать файл через контекстное меню: Assets/Import Package/Custom Package….

_images/image1.png

Импортируете таким образом, либо двойным кликом по файлу.

После импорта проекта, откройте главную игровую сцену Game, которая находится в Case Simulator Redux/Scenes/Game.unity.
Далее в File/Build Settings можете поменять платформу, выбрав её в списке и нажав Switch Platform. По стандарту игра сделана для платформы Android.

Предупреждение

Игра разработана для горизонтальной ориентации экрана, так что обязательно поменяйте разрешение в окне Game на любое горизонтальное (пр. 1920x1080).

Подсказка

В проекте уже присутствуют некоторые кейсы, так что можете сразу проверить работоспособность игры.

Настройки игры

В главной директории проекта находится конфигурационный файл с игровыми настройками.

_images/image2.png

Выделенный файл Config.

В файле Config находятся некоторые игровые настройки, и что самое главное - кейсы.

_images/image31.png

Вид объекта Config в инспекторе.

Так же можете создать новый конфигурационный файл, с помощью контекстного меню.

_images/image5.png

Большинство главных игровых скриптов находится на объекте MANAGERS, в иерархии игровой сцены.

_images/image9.png

Вид объекта в инспекторе.

Остальные скрипты находятся на объектах, с которыми они работают.

Добавление кейсов

Все заранее созданные кейсы находятся в Case Simulator Redux/Cases. Так же рекомендуется создавать там и новые кейсы.

_images/image6.png

Создать новый кейс можно с помощью контекстного меню.

_images/image7.png

В объекте кейса вы увидите его настройки в инспекторе.

_images/image8.png

Поля которые нужно заполнить:

  • Название кейса;
  • Цена кейса;

Подсказка

Можете не указывать цену, если кейсы не покупаются за игровую валюту.

  • Изображение кейса;
  • Список оружий кейса;
  • Шансы генерации разных типов редкостей оружий;

При добавлении оружий в кейс, так же заполняете все поля, и выбираете его редкость.

_images/image11.png

После того как заполнили кейс всей информацией, можете добавить его в конфигурационный файл.

_images/image12.png

После этого ваш кейс добавлен в игру, и можете его проверить.

_images/image13.png

Сейчас мы добавили новый Tutorial Case.

Так же все добавленные оружия отображатся в списке.

_images/image14.png

Опасно

После релиза игры не рекомендуется вставлять новые кейсы либо оружия перед теми, которые были уже использованы в игре. Так как старые идентификаторы в инвентаре игрока будут ссылаться на новые объекты. Так же и с удалением использованных кейсов.

Прочее

В верхнем меню редактора, в разделе Game, вы можете найти полезные функции для теста игры в редакторе:

  • Удалить сохранение;
  • Вывести данные сохранения в консоль;
  • Перейти в эту документацию;
_images/image20.png

Компиляция игры

После того как вы сделали все нужные изменения в проекте, можно его скомпилировать для проверки на целевой платформе.

Примечание

Сейчас будет рассмотрена компиляция на платформу Android.

Переходим в File/Build Settings, и добавляем нашу игровую сцену в Scenes In Build.

Подсказка

Можете нажать на кнопку Add Open Scenes, для добавления открытой сцены.

Add Open Scenes Gif

Далее переходим в окно Player Settings для настройки самой компиляции.

Предупреждение

Для компиляции под Android вам надо установить Android SDK через SDK Manager, который можете найти в Android Studio. Более подробно в документации Android разработчиков.

И настраиваем все главные поля:

Примечание

Далее будет информация только о главных полях для компиляции. Информацию о других, можете прочитать в документации Unity.

Company Name
Название вашей компании. Например: Android Helper Games
Product Name
Название игры. Например: Case Simulator Redux

В разделе Resolution and Presentation ставим галочки только на ландшафтные ориентации.

_images/image18.png

В разделе Other Settings пишете свой Package Name, и изменяете версию игры если надо. Так же можете настроить минимальный и максимальный уровень API.

_images/image17.png

Тут показаны рекомендуемые настройки конфигурации.

Остальные настройки можете настраивать по своему усмотрению.

После того как всё нужное настроили, можем переходить назад к окну Build Settings, и нажимать на кнопку Build. Либо Build And Run, если у вас подключено устройство по USB, чтобы запустить игру на нём.

_images/image19.png

Если всё сделали правильно, и все нужные компоненты установлены для компиляции, то она пройдёт без ошибок.

Case Simulator Redux API

Классы

Case Simulator Redux API

О проекте

Описание и подробности

Quiz Game Redux - это улучшение старого проекта Quiz Game, которое было сделано с нуля.

Что нового?

  • Интерфейс лучше настроен под разные разрешения экранов;
  • Скрипты переписаны с нуля;
  • Добавлена возможность делать вопрос с изображением;
  • Добавлена возможность создавать категории;
_images/1.png
_images/2.png
_images/3.png

Требования:

  • Unity 2018.4.0f1+;
  • .NET 4.x;

Осторожно

Если поставить .NET 3.5, то будут ошибки в коде, потому что в проекте используется новый синтаксис .NET 4.x.

Дополнительная информация о проекте:

  • .unitypackage файл;
  • Последнее обновление: 12.05.2019;

Как начать?

Открытие проекта

Примечание

Описание объектов и их полей можете прочитать в разделе API.

После скачивания проекта, у вас будет .unitypackage файл. После вам надо создать новый 2D проект, и импортировать файл через контекстное меню: Assets/Import Package/Custom Package….

_images/4.png

Импортируете таким образом, либо двойным кликом по файлу.

После импорта проекта, откройте главную игровую сцену Game, которая находится в Quiz Game Redux/Scenes/Game.unity.
Далее в File/Build Settings можете поменять платформу, выбрав её в списке и нажав Switch Platform. По стандарту игра сделана для платформы Android.

Предупреждение

Игра разработана для вертикальной ориентации экрана, так что обязательно поменяйте разрешение в окне Game на любое вертикальное (пр. 1080x1920).

Подсказка

В проекте уже присутствуют некоторые вопросы, так что можете сразу проверить работоспособность игры.

Настройки игры

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

_images/5.png

Выделенный файл Config.

Для редактирования категорий и вопросов, нужно нажать на кнопку Категории и вопросы….
Перейти в эту документацию можно через кнопку Перейти в документацию….
_images/6.png

Вид объекта Config в инспекторе.

Так же можете создать новый конфигурационный файл, с помощью контекстного меню.

_images/7.png

Все главные игровые скрипты находится на объекте MANAGERS, в иерархии игровой сцены.

_images/8.png

Редактирование категорий и вопросов

Для редактирования категорий и вопросов, переходим в конфигурационный файл, и нажимаем на кнопку Категории и вопросы….

_images/6.png

После откроется окно настроек.

_images/9.png

По стандарту у вас уже будет одна категория и 8 вопросов.

Важно

Если в игре присутствует только одна категория, то при нажатии на кнопку Play, игра сразу начнётся. Иначе если категорий больше чем 1, то откроется панель выбора категории для игры, после нажатии на которую, начнётся игра.

Если вам не нужна эта категория, то можете её удалить, нажав на крестик возле названия категории.

_images/10.png
Теперь создадим свою категорию с вопросами! Для этого пишем название категории и нажимаем на кнопку Добавить категорию.
После этого наша категория появится в списке категорий.
_images/11.png

Далее можем добавить вопрос. Для этого нажимаем на кнопку Добавить вопрос.

_images/12.png
После того как добавили вопрос, мы можем заполнить его нужной информацией…

Кнопка с зелёной галочкой показывает, какой вариант ответа является верным. Вы конечно же можете его поменять.

Примечание

Порядок вопросов и ответов не особо важен, потому что всё это генерируется в случайном порядке.

Так же вы можете добавить изображение к вопросу. В игре оно будет выглядеть вот так:

Quiz Image Preview

Изображение к вопросу так же можно увеличивать.

Компиляция игры

После того как вы сделали все нужные изменения в проекте, можно его скомпилировать для проверки на целевой платформе.

Примечание

Сейчас будет рассмотрена компиляция на платформу Android.

Переходим в File/Build Settings, и добавляем нашу игровую сцену в Scenes In Build.

Подсказка

Можете нажать на кнопку Add Open Scenes, для добавления открытой сцены.

Add Open Scenes Gif

Далее переходим в окно Player Settings для настройки самой компиляции.

Предупреждение

Для компиляции под Android вам надо установить Android SDK через SDK Manager, который можете найти в Android Studio. Более подробно в документации Android разработчиков.

И настраиваем все главные поля:

Примечание

Далее будет информация только о главных полях для компиляции. Информацию о других, можете прочитать в документации Unity.

Company Name
Название вашей компании. Например: Android Helper Games
Product Name
Название игры. Например: Quiz Game

В разделе Resolution and Presentation ставим галочки только на портретные ориентации.

_images/15.png

В разделе Other Settings пишете свой Package Name, и изменяете версию игры если надо. Так же можете настроить минимальный и максимальный уровень API.

_images/16.png

Тут показаны рекомендуемые настройки конфигурации.

Остальные настройки можете настраивать по своему усмотрению.

После того как всё нужное настроили, можем переходить назад к окну Build Settings, и нажимать на кнопку Build. Либо Build And Run, если у вас подключено устройство по USB, чтобы запустить игру на нём.

_images/17.png

Если всё сделали правильно, и все нужные компоненты установлены для компиляции, то она пройдёт без ошибок.

Quiz Game Redux API

Классы

Quiz Game Redux API

Индексы и таблицы