Dokumentacja użytkownika aplikacji mobilna Aplikacja Uczestnika Gry Miejskiej
Zamawiający: Wykonawca: Dokumentacja powstała w ramach projektów Dokumentacja powstała w ramach projektów: e-usługi e-organizacj a - pakiet rozwiązań informatycznych dla j ednostek organizacyj nych woj ewództwa kuj awsko-pomorskiego i Realizacj a systemu innowacyj nej edukacj i w woj ewództwie kuj awsko-pomorskim poprzez zbudowanie systemu dystrybucj i treści edukacyj nych
Spis treści 1. Wstęp 4 2. mobilna Aplikacja Uczestnika Gry Miejskiej (maugm) przekrój 5 2.1 Pobieranie aplikacji maugm 5 2.2 Instalacja i uruchomienie aplikacji maugm 5 2.3 Strona główna aplikacji maugm 6 2.4 7 Graj online 2.4.1 Gracz tryb uczestnika 2.4.2 Gospodarz tryb gospodarza 8 11 2.5 Graj offline zapisane gry 15 2.6 Historia gier 19 2.7 Zakończenie pracy z aplikacją 20
1. Wstęp Platforma Gier Miejskich (PGM) to moduł Kujawsko-Pomorskiej Platformy Edukacyjnej umożliwiający projektowanie, udostępnianie, oraz przeprowadzanie gier miejskich z wykorzystaniem urządzeń mobilnych. PGM składa się z następujących 2 komponentów: Edytor Gier Miejskich umożliwia tworzenie i udostępnianie gier miejskich, przeszukiwanie bazy gier i zadań utworzonych przy użyciu Edytora oraz pobranie aplikacji służącej do uczestnictwa i prowadzenia gier, mobilna Aplikacja Uczestnika Gry Miejskiej (maugm) umożliwia branie udziału i prowadzenie gier miejskich na urządzeniach mobilnych takich jak tablet i smartfon oraz podgląd własnego profilu, w tym rezultatów swoich gier. Poniższa instrukcja skupia się jedynie na funkcjonalnościach mobilnej Aplikacji Uczestnika Gry Miejskiej. UWAGA: Aby dowiedzieć się więcej na temat tworzenia gier miejskich przejdź do dokumentu Edytor Gier Miejskich Dokumentacja użytkow nika. Strona 4
2. mobilna Aplikacja Uczestnika Gry Miejskiej (maugm) przekrój mobilna Aplikacja Uczestnika Gry Miejskiej (maugm) pozwala użytkownikom na organizację lub branie udziału w grach uprzednio stworzonych w Edytorze Gier Miejskich. mobilna Aplikacja Uczestnika Gry Miejskiej (maugm) umożliwia branie udziału w grach miejskich w następujących dwóch trybach: tryb gospodarza umożliwiający: o przeszukiwanie bazy gier, o zorganizowanie wybranej gry dla uczestników, o śledzenie w czasie rzeczywistym indywidualnych ścieżek, po których poruszają się poszczególni uczestnicy oraz podgląd ilości zrealizowanych przez każdego z nich zadań wraz z osiągniętą punktacją, tryb gracza umożliwiający: o przeszukiwanie bazy gier, o zapoznanie się z informacjami na temat toczących się gier, w których uczestnik może wziąć udział, o branie udziału w wybranych grach w pojedynke lub poprzez wprowadzenie kodu dającego dostęp do gry o ograniczonym dostępie, o zapoznanie się z założeniami rozpoczętej gry oraz zadaniami do wykonania w jej ramach. Dodatkowo każdy użytkownik ma możliwość przejścia do podglądu własnego profilu tj. rezultatów gier, które prowadził lub, w których brał udział. UWAGA: Aplikacja maugm działa na urządzeniach mobilnych takich jak tablet i smartfon pracującymi w środowisku systemu operacyjnego Android v. 4.0 i nowszych lub ios. Aplikacja oferuje ograniczoną funkcjonalność również w trybie wyłączonej transmisji danych urządzenia mobilnego tj. zarówno wcześniej pobrana treść zadań jak i ich lokalizacja GPS może zostać odczytana (patrz: Graj offline zapisane gry). 2.1. Pobieranie aplikacji maugm Aby pobrać mobilną aplikację uczestnika gry miejskiej, należy: zalogować się do platformy i przejść do Edytora Gier Miejskich (jak opisano w dokumencie Edytor Gier Miejskich Dokumentacja użytkow nika), przejść do zakładki Pobierz grę, kliknąć przycisk Pobierz dla systemu Android, przesłać lub przenieść pobrany plik na swoje urządzenie mobilne, zainstalować aplikację zgodnie z instrukcją na ekranie. 2.2. Instalacja i uruchomienie aplikacji maugm Aby zainstalować aplikację maugm na swoim urządzeniu mobilnym, należy: pobrać aplikację poprzez kliknięcie przycisku Pobierz dla systemu Android z zakładki Pobierz grę w obrębie Edytora Gier Miejskich, przyznać aplikacji wymagane uprawnienia i zainstalować aplikację zgodnie z instrukcjami Strona 5
wyświetlanymi na ekranie (w zależności od ustawień telefonu konieczne może być zezwolenie na instalację aplikacji z nieznanych źródeł poprzez wybranie opcji Ustawienia > Bezpieczeństwo > Nieznane źródła). Po zainstalowaniu aplikacji maugm stuknąć przycisk Otwórz, aby od razu przejść do aplikacji. 2.3. Strona główna aplikacji maugm Po otwarciu aplikacji maugm automatycznie wyświetlona zostanie strona główna aplikacji umożliwiająca zalogowanie się do aplikacji (przycisk Zaloguj się) lub rozegranie gry w trybie offline (przycisk Graj offline). Strona 6
Aby zalogować się do aplikacji, należy: stuknąć przycisk Zaloguj się, na stronie logowania wpisać odpowiednio adres e-mail i hasło logowania do platformy Edupolis, stuknąć przycisk Zaloguj. UWAGA: Aby zalogować się do aplikacja maugm konieczne jest podanie danych konta służbowego tj. tego samego adresu e-mail i hasła logowania jak do platformy Edupolis. Aby dowiedzieć się więcej na temat rozgrywania gry offline przejdź do rozdziału Graj offline zapisane gry. 2.4. Graj online Po zalogowaniu się do aplikacji możliwe jest dołączenie do istniejącej gry jako jej uczestnik (przycisk Gracz) lub zostanie gospodarzem uprzednio utworzonej gry i monitorowanie postępów wszystkich zaproszonych uczestników gry (przycisk Gospodarz). Strona 7
2.4.1. Gracz tryb uczestnika Aby wziąć udział w trwającej grze w trybie uczestnika, należy: zalogować się do aplikacji, stuknąć przycisk Gracz automatycznie pojawi się baza dostępnych na Platformie Gier Miejskich gier podzielona na dwie zakładki: o Trwające gry lista gier odbywających się w danym momencie, z możliwością dołączenia do wybranej z nich po podaniu odpowiedniego kodu otrzymanego od gospodarza gry, o Dostępne gry baza gier dostępnych na Platformie Gier Miejskich, z możliwością pobrania lub rozegrania gry w pojedynke; UWAGA: W przypadku gry w pojedynke należy postępować podobnie jak w przypadku gier offline. stuknąć przycisk lub wyszukać i stuknąć jedną z gier dostępnych w zakładce Trwające gry, wprowadzić otrzymany od gospodarza gry kod (PIN) dający dostęp do gry o ograniczonym dostępie, stuknąć przycisk Graj, zapoznać się z założeniami wybranej gry i stuknąć przycisk Pobierz grę, aby pobrać mapę i/lub przycisk Rozpocznij grę, aby ją uruchomić; UWAGA: Po stuknięciu przycisku Pobierz grę, mapa gry wraz z zadaniami zostanie pobrana na Twój telefon/tablet umożliwiając rozegranie gry w trybie offline. Zauważ, że pobrane gry są oznaczone ikoną. Dodatkowo, po pobraniu gry przycisk Strona 8
Pobierz grę zamieni się w Usuń pobraną grę, umożliwiając usunięcie gry z Twojego urządzenia. poczekać na rozpoczęcie gry przez gospodarza. Każda gra jest zbiorem zadań do wykonania. Po rozpoczęciu gry aplikacja wyświetli mapę z lokalizacją gry wraz punktem startowym (bordowy znacznik), punktem końcowym (znacznik flagi) oraz z rozmieszczeniem poszczególnych zadań do wykonania (czarne, ponumerowane znaczniki) i Twoim obecnym położeniem (niebieska kropka). UWAGA: Aby wyświetlić własną lokalizację na mapie należy w swoim urządzeniu włączyć funkcję GPS i stuknąć ikonę mapa zostanie wyśrodkowana do Twojej bieżącej lokalizacji zgodnie z lokalizacją GPS urządzenia mobilnego. Dodatkowo u góry ekranu zawsze widoczny jest uzyskany przez uczestnika wynik oraz czas pozostały do zakończenia gry. Aby przybliżyć lub oddalić lokalizację na mapie, należy umieścić dwa palce na mapie, a następnie Strona 9
rozsunąć je lub zsunąć. UWAGA: Możliwe jest również skorzystanie z ikon + i - zlokalizowanych w prawym dolnym rogu ekranu. Po stuknięciu w wybrany punkt (zadanie) wyświetlona zostanie nazwa i opis zadania. Gdy znajdziemy się niedaleko miejsca oznaczonego zadania, w prawym górnym rogu ekranu gry pojawi się ikona, po stuknięciu której wyświetlona zostanie nazwa i opis zadania w pobliżu, którego się znajdujemy. Dodatkowo, będąc w zasięgu zadania, stuknięcie w wybrany punkt (zadanie) otworzy ekran z zadaniem i dołączonymi do niego materiałami. UWAGA: W przypadku większej ilości materiałów/pytań dołączonych do zadania, na dole ekranu widoczne będą następujące kropki informujące o tym, na której stronie się obecnie znajdujesz. Aby przejść do poprzedniego/następnego ekranu przesuń palcem w lewo lub w prawo w obrębie okna. Strona 10
Aby wykonać zadanie, należy zapoznać się z załączonym materiałem, odpowiedzieć na pytanie i stuknąć przycisk Sprawdź. Czas spędzony na rozwiązywaniu zadania jest mierzony a udzielone odpowiedzi są odpowiednio weryfikowane i punktowane przez aplikację. Dodatkowo na mapie automatycznie aktualizowana będzie Twoja indywidualna ścieżka, którą poruszasz się jako uczestnik gry. Aby zakończyć grę, należy wykonać wszystkie zadania, a następnie stuknać ikonę aby powrócić do listy gier po zakończeniu gry, jej wynik zostanie wyświetlony na ekranie oraz zapisany w sekcji Historia gier (patrz: Historia gier). 2.4.2. Gospodarz tryb gospodarza Aby zorganizować grę dla uczestników tj. zostać jej gospodarzem, należy: zalogować się do aplikacji, stuknąć przycisk Gospodarz automatycznie pojawi się baza dostępnych na Platformie Gier Miejskich gier podzielona na dwie zakładki: o Moje gry lista gier utworzonych i opublikowanych przez zalogowanego użytkownika w obrębie Edytora Gier Miejskich; UWAGA: W tym miejscu dostępne są również gry, które użytkownik przesłał do aplikacji przy użyciu przycisku Wypróbuj w aplikacji, umożliwiając sprawdzenie gry przed jej oficjalnym opublikowaniem, o Dostępne gry baza gier dostępnych na Platformie Gier Miejskich, z możliwością pobrania lub rozpoczęcie gry w trybie gospodarza, wyszukać i stuknąć jedną z gier dostępnych w zakładce Moje gry lub Dostępne gry, Strona 11
zapoznać się z założeniami wybranej gry i stuknąć przycisk Pobierz grę, aby pobrać mapę i/lub przycisk Rozpocznij grę, aby ją uruchomić. UWAGA: Po stuknięciu przycisku Pobierz grę, mapa gry wraz z zadaniami zostanie pobrana na Twój telefon/tablet umożliwiając rozegranie gry w trybie offline. Zauważ, że pobrane gry są oznaczone ikoną. Dodatkowo, po pobraniu gry przycisk Pobierz grę zamieni się w Usuń pobraną grę, umożliwiając usunięcie gry z Twojego urządzenia. Po stuknięciu przycisku Rozpocznij grę aplikacja wyświetli mapę z lokalizacją gry wraz punktem startowym (bordowy znacznik), punktem końcowym (znacznik flagi) oraz z rozmieszczeniem poszczególnych zadań do wykonania (czarne, ponumerowane znaczniki) i Twoim obecnym położeniem (niebieska kropka). UWAGA: Aby wyświetlić własną lokalizację na mapie należy w swoim urządzeniu włączyć funkcję GPS i stuknąć ikonę mapa zostanie wyśrodkowana do Twojej bieżącej lokalizacji zgodnie z lokalizacją GPS urządzenia mobilnego. Zauważ, że po uruchomieniu gry w trybie gospodarza aplikacja automatycznie wygeneruje PIN do gry, który należy podać graczom, których chcesz zaprosić do prowadzonej gry. Aby rozpocząć grę stuknij przycisk i poczekaj na dołączenie do niej graczy. Strona 12
Po rozpoczęciu gry u góry ekranu zawsze widoczny będzie czas pozostały do zakończenia gry. Gdy odpowiedni uczestnicy dołączą do gry, której jesteś gospodarzem zostaniesz o tym poinformowany/a w następujący sposób. W rezultacie ilość graczy biorących udział w grze będzie wyświetlana w obrębie przycisku umożliwiającego jednocześnie wyświetlenie listy uczestników gry wraz z uzyskanymi przez nich wynikami. Strona 13
Dodatkowo, jako gospodarz użytkownik ma możliwość śledzenia w czasie rzeczywistym indywidualnych ścieżek, po których poruszają się poszczególni uczestnicy. W trybie gospodarza, po stuknięciu w wybrany punkt (zadanie) wyświetlony zostanie ekran z zadaniem (z zaznaczonymi poprawnymi odpowiedziami) i dołączonymi do niego materiałami. W przypadku większej ilości materiałów/pytań dołączonych do zadania, na dole ekranu widoczne będą następujące kropki informujące o tym, na której stronie się obecnie znajdujesz. Aby przejść do poprzedniego/ następnego ekranu przesuń palcem w lewo lub w prawo w obrębie okna. UWAGA: Zauważ, że gdy jako gospodarz znajdziesz się niedaleko miejsca oznaczonego zadania, w prawym górnym rogu ekranu gry pojawi się ikona nazwa i opis zadania w pobliżu, którego się znajdujesz. Aby zakończyć grę, stuknij przycisk, po stuknięciu której wyświetlona zostanie, a następnie stuknij ikonę aby powrócić do listy gier. Po zakończeniu gry, jej wynik zapisany zostanie w sekcji Historia gier (patrz: Historia gier). Strona 14
2.5. Graj offline zapisane gry UWAGA: Aplikacja oferuje ograniczoną funkcjonalność w trybie wyłączonej transmisji danych urządzenia mobilnego tj. zarówno wcześniej pobrana treść zadań jak i ich lokalizacja GPS może zostać odczytana. Granie w trybie offline nie wymaga logowanie do aplikacji. Aby rozegrać grę offline, należy uprzednio pobrać jedną z dostępnych w aplikacji gier. Aby pobrać grę, należy: zalogować się do aplikacji, stuknąć przycisk Gracz lub Gospodarz, przejść do zakładki Dostępne gry, stuknąć jedną z dostępnych gier, na ekranie informacji o grze stuknąć przycisk Pobierz grę gra zostanie automatycznie pobrana na Twoje urządzenie mobilne. Po stuknięciu przycisku Pobierz grę, mapa gry wraz z zadaniami zostanie pobrana na Twój telefon/ tablet umożliwiając rozegranie gry w trybie offline. Zauważ, że pobrane gry są oznaczone ikoną. Dodatkowo, po pobraniu gry przycisk Pobierz grę zamieni się w Usuń pobraną grę, umożliwiając usunięcie gry z Twojego urządzenia. Strona 15
Aby rozegrać grę offline, należy: otworzyć aplikację maugm, na stronie głównej aplikacji stuknąć przycisk Graj offline (nie wymaga logowania do aplikacji), UWAGA: Przejście do zapisanych na urządzeniu gier możliwe jest również po zalogowaniu do aplikacji, stuknięciu przycisku funkcyjnego i wybraniu opcji Zapisane gry (jak pokazano poniżej). wybrać jedną z pobranych na telefon/tablet gier, zapoznać się z założeniami wybranej gry i stuknąć przycisk Rozpocznij grę, aby ją uruchomić. Każda gra jest zbiorem zadań do wykonania. Po rozpoczęciu gry aplikacja wyświetli mapę z lokalizacją gry wraz punktem startowym (bordowy znacznik), punktem końcowym (znacznik flagi) oraz z rozmieszczeniem poszczególnych zadań do wykonania (czarne, ponumerowane znaczniki) i Twoim obecnym położeniem (niebieska kropka). UWAGA: Aby wyświetlić własną lokalizację na mapie należy w swoim urządzeniu włączyć funkcję GPS i stuknąć ikonę mapa zostanie wyśrodkowana do Twojej bieżącej lokalizacji zgodnie z lokalizacją GPS urządzenia mobilnego. Dodatkowo u góry ekranu zawsze widoczny jest uzyskany przez uczestnika wynik oraz czas pozostały do zakończenia gry. Strona 16
Aby przybliżyć lub oddalić lokalizację na mapie, należy umieścić dwa palce na mapie, a następnie rozsunąć je lub zsunąć. UWAGA: Możliwe jest również skorzystanie z ikon + i - zlokalizowanych w prawym dolnym rogu ekranu. Po stuknięciu w wybrany punkt (zadanie) wyświetlona zostanie nazwa i opis zadania. Strona 17
Gdy znajdziemy się niedaleko miejsca oznaczonego zadania, w prawym górnym rogu ekranu gry pojawi się ikona, po stuknięciu której wyświetlona zostanie nazwa i opis zadania w pobliżu, którego się znajdujemy. Dodatkowo, będąc w zasięgu zadania, stuknięcie w wybrany punkt (zadanie) otworzy ekran z zadaniem i dołączonymi do niego materiałami. Aby wykonać zadanie, należy zapoznać się z załączonym materiałem, odpowiedzieć na pytanie i stuknąć przycisk Sprawdź. Czas spędzony na rozwiązywaniu zadania jest mierzony a udzielone odpowiedzi są odpowiednio weryfikowane i punktowane przez aplikację. Strona 18
Dodatkowo na mapie automatycznie aktualizowana będzie Twoja indywidualna ścieżka, którą poruszasz się jako uczestnik gry. Aby zakończyć grę, należy wykonać wszystkie zadania, a następnie stuknąć ikonę listy gier. aby powrócić do 2.6. Historia gier Aplikacja maugm umożliwia również podgląd własnego profilu tj. rezultatów gier, które prowadził, lub w których brał udział zalogowany użytkownik. Aby wyświetlić historię swoich rozegranych i zorganizowanych gier, należy: zalogować się do aplikacji, stuknąć przycisk funkcyjny i wybrać opcję Historia gier (jak pokazano poniżej), UWAGA: Opcja Historia gier jest dostępna również w innych miejscach aplikacji pod przyciskiem funkcyjnym. automatycznie pojawi się baza wyników gier z podziałem na następujące dwa tryby: o Gracz wyniki rozegranych przez Ciebie gier, o Gospodarz lista gier, których byłeś/aś gospodarzem po stuknięciu nazwy wybranej gry wyświetlone zostaną imiona i nazwiska osób, które brały w niej udział wraz z uzyskanymi przez nich wynikami. Strona 19
2.7. Zakończenie pracy z aplikacją Aby zakończyć pracę z aplikacją maugm, należy: stuknąć przycisk funkcyjny i wybrać opcję Wyloguj (jak pokazano poniżej), potwierdzić chęć wylogowania, zamknąć aplikację. UWAGA: Opcja Wyloguj jest dostępna również w innych miejscach aplikacji pod przyciskiem funkcyjnym. Strona 20
Zamawiający: Wykonawca: Young Digital Planet SA a Sanoma Company ul. Łużycka 3c, 81 537 Gdynia, Polska tel. +48 58 768 22 22, fax. +48 58 768 22 11 e-mail: info@ydp.eu strona www: http://www.ydp.eu Dokumentacja powstała w ramach projektów: e-usługi e-organizacj a - pakiet rozwiązań informatycznych dla j ednostek organizacyj nych woj ewództwa kuj awsko-pomorskiego i Realizacj a systemu innowacyj nej edukacj i w woj ewództwie kuj awsko-pomorskim poprzez zbudowanie systemu dystrybucj i treści edukacyj nych Strona 21