Paint Guesser

Introduction

Paint Guesser е игра за която са необходими два играча:

Художник, който ще рисува
Гадател, който трябва да отгатне какво е нарисувано.

Gameplay

Различава се според ролята на играча

Host (художник)
- Създава стая в която трябва да се присъедини гадател (чрез IP)
- След като се присъедини гадателя, за кратък период от време художника вижда изображение, което трябва да запомни и да нарусва.
- За период от една минута художника трябва да нарисува изображението което е видял.
- Работата на художника се оценява от гадателя.
Client (гадател)
- Присъединява се към стаята създадена от художника.
- Наблюдава какво рисува художника в реално време.
- Опитва се да отгатне нарисуваното от художника.
- Оценява работата на художника, като по време на оценката гадателя вижда и самото изображение, което художника е трябвало да запомни и нарисува.

Видео

Потребителски интерфейс

Начална страница с навигация до:
- Лоби - Мястото където се създава или присъединява към игрална стая
- Игрална стая - Мястото където художника рисува, а гадателя наблюдава. Художника може да избира различни цветове за рисуване и поетапно да изтрива нарисуваното в случай на грешка. И двата играча виждат времето което остава до края на играта на екрана, както и на нотификация, която е прикрепена към Foreground Service.
- История - Лист съдържащ информация за изиграните игри (Дата, рейтинг и др.). Нарисуваната картина от художника се визуализира при избиране на елемент от листа.
- Практика - Място подобно на игралната стая, но без таймер и втори играч.

Стартиране на проекта

Backend

Преди да започне играта, приложението се нуждае от API от който да взима картинките за рисуване. С играта беше разработен и проект на Spring, който да генерира картинки за рисуване.

⚠️ Spring апликацията трябва да работи на адрес и порт: http://192.168.0.101:8080. (Може да бъде променено в GameConstants.java. Също така Spring апликацията връща JSON обект, който съдържа линк към генерираната картинка http://192.168.0.101:8080/images/***, който може да бъде променен в IndexController.java.

Emulators

Необходими са два броя емулатора. По подразбиране емулаторите се стартират на портове 5554 и 5556 . За да бъде възможна комуникацията между двата емулатора е небходимо да се изпълнят следната команди:

telnet localhost 5554

След което излиза съобщение подобно на това:

Trying ::1...
Connected to localhost.
Escape character is '^]'.
Android Console: Authentication required
Android Console: type 'auth <auth_token>' to authenticate
Android Console: you can find your <auth_token> in 
'/Users/{username}/.emulator_console_auth_token'

Необходимо е да се копира текста от споменатия файл, а след това да се продължи с:

auth {COPIED TEXT}

След успешното изпълнение на командата auth е необходимо да пренасочим портовете:

redir add tcp:6000:4000

Повече информация: Тук и тук.

Процеса за пренасочването на портовете може да бъде автоматизиран със създаването на executable файл със следното съдържание:

(sleep 1; echo "auth {{AUTH_KEY_FROM_emulator_console_auth_token}}"; sleep 1; echo "redir add tcp:6000:4000"; sleep 1) | telnet localhost 5554

След това е необходимо емулатора с порт 5554 да създаде играта, а емулатора с порт 5556 да се присъедини към играта използвайки 10.0.2.2 за IP адрес.

About

Играта е създадена като проект за CSCB763 Разработване на мобилни приложения.

Изисквания

Използването на външни библиотеки в приложението НЕ е разрешено, освен ако тяхното имплементиране е обосновано и защитено от студента предварително!

Изискванията към разработеното приложение са:

да съдържа поне два компонента Activity, комуникиращи помежду си със съобщение Intent;

да са използвани фрагменти;

да се свързва с интернет, извлича информация от API и правилно да показва тази информация на екран на мобилно устройство;

да съдържа поне една услуга (Service);

да използва работна нишка, изпълнявана паралелно с основната;

да съхранява и извлича данни в БД SQLite.

applicationId (package name) трябва да включва факултетния номер

BalioFVFX/PaintGuesser