Szczegółowa instrukcja użytkownika

Transkrypt

1 Szczegółowa instrukcja użytkownika Programowanie Zespołowe WMiI 2011/12 Zespół numer 1 Opiekun: mgr Krzysztof T. Czarkowski Skład zespołu: Łukasz Rumiński kierownik, programista, Michał Kutzner sekretarz, programista, Adrian Dymek programista, Szymon Kwiatkowski programista, Marcin Langa programista.

2 Spis treści Wstęp...3 Informacje licencyjne...4 Instalacja serwera...5 Wymagania minimalne...5 Konfiguracja serwera...10 Główne okno programu widoczne po uruchomieniu serwera...10 Zarządzanie skrótami...11 Ustawienia sensorów...12 Opcje serwera...13 Zarządzanie połączeniami...14 Lista dozwolonych urządzeń...15 Instalacja aplikacji klienckiej (Java Micro Edition)...16 Wymagania minimalne...16 Konfiguracja aplikacji klienckiej (Java Micro Edition)...17 Menu główne...17 Menu Urządzenia...18 Menu Opcje...19 Menu Język...19 Moduł Mysz...20 Moduł Klawiatura...21 Menu modułów...22 Moduł Skróty...23 Instalacja aplikacji klienckiej (Android)...24 Wymagania minimalne...24 Konfiguracja aplikacji klienckiej (Android)...25 Menu główne...25 Lista urządzeń...26 Ekran sterowania...26 Moduł myszy...27 Moduł touchpada...27 Moduł klawiatury...28 Moduł skrótów klawiszowych...28 Moduł kontrolera gier...29 Pomoc oraz konfiguracja modułów...29 Konfiguracja modułu touchpada...30 Ekran informacji i języka...30 Pytania i problemy

3 Wstęp Hackney jest pakietem oprogramowania pozwalającym na zdalne sterowanie komputerem za pośrednictwem telefonu komórkowego i technologii Bluetooth. Składa się on z serwera, który należy zainstalować na komputerze oraz aplikacji klienckich na telefony komórkowe. W tym podręczniku znajdziesz wszystkie potrzebne informacje potrzebne do instalacji jak i użytkowania wspomnianych wyżej programów. 3

4 Informacje licencyjne Wszelkie znaki towarowe oraz nazwy zastrzeżone użyte w tym dokumencie należą do ich właścicieli i użyte zostały wyłącznie w celach informacyjnych. Programy nie są objęte jakąkolwiek gwarancją. Autorzy zapewniają je w takim stanie, w jakim są ("jak widać") i nie odpowiadają za wszelkie szkody wynikające, bezpośrednio lub pośrednio, z ich użytku. Całość odpowiedzialności w zakresie jakości oraz skuteczności działania ponosi jedynie użytkownik. Aplikacja serwera wykorzystuje bibliotekę BlueCove na zasadach The Apache Software License. Programy klienckie oraz serwer są dostarczane na Berkeley Software Distribution License. Jeśli nie określono inaczej, obowiązują postanowienia powyższej licencji. Pliki graficzne użyte w projekcie, jeśli nie określono inaczej, są dostępne na licencji Creative Commons BY-NC-SA 3.0. Logo Wydziału Matematyki i Informatyki Uniwersytetu Mikołaja Kopernka w Toruniu, widniejące na stronach www projektu, jest własnością Wydziału i użyte zostało za zgodą Dziekana. Aplikacje korzystają z ikon, z pakietu Oxygen Icons dostępnego na licencji GNU Library General Public License lub Creative Commons BY-SA

5 Instalacja serwera Wymagania minimalne System operacyjny z Java Runtime Environment w wersji 1.6, Adapter Bluetooth obsługiwany przez bibliotekę BlueCove, Pamięć RAM: 256 MB, Procesor: 800 MHz, Przestrzeń dyskowa: 6 MB. Instalator można pobrać ze strony: Krok 1 Po wybraniu języka, zobaczysz powyższy ekran Instalację serwera można wykonać w siedmiu prostych krokach. powitalny instalatora. Aby przejść do następnego ekranu, kliknij Dalej. 5

6 Krok 2 W drugim kroku instalacji możesz zapoznać się z informacjami o aplikacji. Aby przejść do następnego ekranu, kliknij Dalej. Krok 3 Krok trzeci to zaakceptowanie postanowień licencji Berkeley Software Distribution License na której dostarczane jest oprogramowanie. Aby przejść do następnego ekranu, kliknij Dalej. 6

7 Krok 4 W kolejnym kroku wybierz katalog, w którym chcesz zainstalować aplikację. Aby przejść do następnego ekranu, kliknij Dalej. Krok 5 Później następuje właściwa część instalacji. Aby przejść do następnego ekranu, kliknij Dalej. 7

8 Krok 6 Wybierz odpowiadające Ci opcje dotyczące umieszczenia skrótów do programu i zatwierdź swoją decyzję przyciskiem Dalej. Po zakończeniu instalacji, wyświetlany jest ekran podsumowania. Aby wyjść z instalatora, klikamy Zakończ. 8

9 By uruchomić aplikację, kliknij na odpowiedni skrót. 9

10 Konfiguracja serwera Główne okno programu widoczne po uruchomieniu serwera Na jego środku znajduje się graficzny przełącznik służący do włączenia lub wyłączenia nasłuchu serwera. Na zrzucie ekranu powyżej nasłuch jest wyłączony. Wybranie opcji "Pozwalaj na połączenie tylko znanym urządzeniom" spowoduje, że serwer będzie przyjmował połączenia tylko od urządzeń znajdujących się na liście zaufanych. 10

11 Zarządzanie skrótami Serwer pozwala na zdefiniowanie zestawów skrótów klawiszowych, za pomocą których będzie można zdalnie sterować aplikacjami. Domyślnie zdefiniowane są skróty dla pięciu aplikacji. Ikona wysunięta najbardziej na lewo służy do dodania nowego zestawu. Po jej kliknięciu użytkownik zostanie spytany o nazwę dla zestawu, który następnie zostaje utworzony. Kolejna ikona odpowiada za usuwanie aktywnej listy skrótów, wybranej za pomocą listy rozwijanej na prawo od niej. Klikając na pole tekstowe Ścieżka możemy wskazać plik, który uruchomiony zostanie po wywołaniu skrótu 0 w aplikacji klienckiej. Aby dodać skróty do zestawu, należy wybrać go z listy rozwijanej, a następnie kliknąć na ikonę oznaczoną plusem. Pojawi się nowy wiersz tabeli, który użytkownik może wypełnić, wybierając odpowiednie modyfikatory i klawisze z list rozwijanych oraz poprzez uzupełnienie opisu. Skróty można usuwać poprzez zaznaczenie odpowiednich wierszy w ostatniej kolumnie i późniejsze kliknięcie na ikonę oznaczoną literą X. Zmiany muszą zostać zapisane po przejściu na zakładkę Opcje. 11

12 Ustawienia sensorów Możesz tutaj zdefiniować akcje dla przechylania telefonem w przód, tył i na boki oraz dla sześciu klawiszy funkcyjnych, wyświetlanych na ekranie telefonu w module sterowania grami. Serwer jest w stanie obsłużyć maksymalnie czterech graczy używających go jednocześnie. Każdemu przydziela pierwszy wolny zestaw klawiszy według kolejności połączenia. Edycji każdego z nich dokonuje się poprzez wybór odpowiadającej mu nazwy z menu po lewej stronie, a następnie zmianę wybranego klawisza z listy rozwijanej. Zmiany muszą zostać zapisane po przejściu na zakładkę Opcje. 12

13 Opcje serwera Zapisz wszystko - zapisanie zmian dokonanych w konfiguracji programu, Wyczyść zmiany - cofnięcie wartości ustawień do momentu ostatniego zapisu. Wszystkie niezapisane zmiany zostaną utracone, Przywróć domyślne - przywrócenie początkowych ustawień aplikacji, O programie wywołanie okna informacyjnego o autorach programu. Istnieje dodatkowo możliwość zmiany języka aplikacji. Po jego wyborze zostaniesz poproszony o ponowne uruchomienie programu, by zmiany mogły być aktywowane. 13

14 Zarządzanie połączeniami W tabeli po lewej stronie wyświetlane są wszystkie, nawiązane w danej chwili, połączenia z serwerem. Spośród nich można wybrać takie, które mają znaleźć się na liście dozwolonych. Dokonuje się tego przez wybór nazwy odpowiedniego urządzenia z tabeli, a następnie klikając ikonę Do dozwolonych. Przycisk Usuń służy do zakończenia wybranego połączenia. 14

15 Lista dozwolonych urządzeń Na liście widoczne są wszystkie urządzenia, które mogą łączyć się z serwerem, gdy aktywna jest opcja "Pozwalaj na połączenie tylko znanym urządzeniom". Urządzenia spoza listy będą odrzucane. Usuwanie elementów z tej listy odbywa się analogicznie do ich dodawania. Należy zaznaczyć odpowiedni wiersz w tabeli, po czym kliknąć w ikonę Usuń. 15

16 Instalacja aplikacji klienckiej (Java Micro Edition) Wymagania minimalne Telefon komórkowy z Java Micro Edition, obsługujący JSR-82, Przestrzeń dyskowa: 250 KB. Odwiedź ze swojej komórki, by ściągnąć odpowiedni program. Instaluje się go tak samo, jak inne programy w Twoim telefonie. Aplikacje dostarczane są bezpłatnie, jednak pobranie ich ze strony może wiązać się z opłatami za transfer danych, zależnymi od operatora. Jeśli jesteś użytkownikiem Androida, możesz znaleźć nas też na Google Play. 16

17 Konfiguracja aplikacji klienckiej (Java Micro Edition) Menu główne Poruszać się po menu można za pośrednictwem przycisków kierunkowych góra i dół, bądź pionowej osi joysticka telefonu. Wyboru opcji dokonuje się przyciskiem funkcyjnym, skojarzonym z opcją Wybierz. Przycisk Powrót umożliwia cofnięcie się do poprzedniego menu. W przypadku menu głównego jego miejsce zajmuje przycisk Wyjście, który kończy działanie aplikacji. Urządzenia wybranie tej opcji przenosi użytkownika do menu urządzeń, Opcje prowadzi do menu zarządzania opcjami klienta, O aplikacji informacje odnośnie programu i jego autorów, Wyjście kończy działanie aplikacji. 17

18 Menu Urządzenia Menu urządzeń zawiera przycisk Wyszukaj pozwalający na wyszukiwane dostępnych urządzeń, zapamiętane wcześniej urządzenia oraz te znalezione. Po wybraniu urządzenia, jeśli nie było wcześniej zapamiętane, pojawi się pytanie, czy dodać to urządzenie do listy znanych. 18

19 Menu Opcje Wyczyść dane pozwala na wyczyszczenie informacji o zapamiętanych urządzeniach po potwierdzeniu przez użytkownika Język przenosi do menu wyboru języka aplikacji Menu Język Menu pozwala na zmianę języka, w jakim będą wyświetlane komunikaty programu. 19

20 Moduł Mysz Pierwszy ekran wyświetlany po połączeniu się z serwerem. Klawisze kierunkowe lub joystick telefonu oraz klawiatura numeryczna telefonu pozwalają na ruch kursorem myszy na komputerze. Klawisze 1 oraz 3 pozwalają odpowiednio na kliknięcie lewym i prawym klawiszem myszy. Klawiatura przenosi do modułu klawiaturowego, Menu wyświetla menu modułów. 20

21 Moduł Klawiatura Klawisze kierunkowe lub joystick telefonu oraz klawiatura numeryczna telefonu pozwalają na ruch kursorem na komputerze. Moduł ten umożliwia wprowadzanie tekstu klawiaturą numeryczną urządzenia w podobny sposób, w jaki pisze się wiadomości SMS. Długie wciśnięcie klawisza oznaczonego symbolem modyfikatora (np. SHIFT) spowoduje aktywację go na czas wpisania następnego, pojedynczego znaku. Kolejne jego długie wciśnięcie przestawi modyfikator w tryb stałego aktywowania. Wyłączyć ten tryb można przytrzymując klawisz po raz trzeci. Dodatkowo klawisze telefonu *, 0, # pozwalają odpowiednio na: kasowanie znaku, wprowadzanie spacji oraz znaku nowej linii. Mysz przenosi do modułu myszy, Menu wyświetla menu modułów. 21

22 Menu modułów Menu odpowiadające za wybór wyżej opisanych modułów oraz moduł Skróty. Wybierz wybiera podświetlony moduł Wyjście przenosi do menu głównego programu. 22

23 Moduł Skróty Moduł ten pozwala na wybranie zestawu skrótów klawiaturowych zapisanych na serwerze. Po dokonaniu wyboru, wyświetlana jest lista skrótów z danego zestawu wraz z numerami klawiszy numerycznych, którymi można je wywołać. Lista ta jest konfigurowalna po stronie serwera. Stały numer ma jedynie akcja przypisana do klawisza 0 - uruchomienie aplikacji ze ścieżki ustawionej w aplikacji serwerowej. Jeśli lista skrótów nie mieści się na ekranie, można ją przewinąć klawiszami telefonu góra i dół lub za pomocą pionowej osi joysticka. Wybierz wybiera zestaw skrótów Menu przenosi do menu głównego programu. 23

24 Instalacja aplikacji klienckiej (Android) Wymagania minimalne Urządzenie z systemem Android w wersji 2.1, Wbudowany adapter Bluetooth, Procesor: 500 MHz, Ram: 160 MB, Przestrzeń dyskowa: 2 MB. Zainstalować aplikację można za pośrednictwem Google Play lub odwiedzając stronę by ściągnąć plik apk w celu ręcznej instalacji. Program dostarczany jest bezpłatnie, lecz transfer danych może podlegać opłatom zależnym od operatora. 24

25 Konfiguracja aplikacji klienckiej (Android) Menu główne Wyszukaj urządzenia dokonuje wyszukania urządzeń Bluetooth w pobliżu, Urządzenia sparowane wyświetla użytkownikowi listę wcześniej skojarzonych urządzeń, Informacje przenosi do menu opcji aplikacji, Wyjście kończy działanie aplikacji. 25

26 Lista urządzeń Po wybraniu opcji Wyszukaj urządzenia lub Urządzenia sparowane zostaniesz spytany o zgodę na włączenie adaptera Bluetooth jeśli ten nie był wcześniej włączony. Później następuje odpowiednio wyszukanie urządzeń lub wyświetlenie listy znanych. Próba połączenia następuje po kliknięciu w nawę urządzenia na liście. Jeśli urządzenie to nie było wcześniej sparowane, zostaniesz także spytany o zgodę na dodanie go do listy znanych. Ekran sterowania Pierwszy ekran jaki zobaczysz po udanym połączeniu. Poprzez zakładki u góry okna można poruszać się po modułach sterujących. Rozłącz kończy połączenie z serwerem i wraca do głównego menu programu. 26

27 Moduł myszy Moduł ten pozwala na sterowanie kursorem na ekranie komputera za pomocą klawiszy strzałek. Przyciski u dołu to, od lewej: lewy przycisk myszy, blokada, prawy przycisk myszy. Opcja blokady pozwala na symulację wciśnięcia i przytrzymania któregoś z przycisków myszy. W tym celu należy kliknąć na ikonę kłódki a następnie na klawisz, który ma być przytrzymany. Blokadę zwalnia się ponownie klikając w kłódkę lub dowolny klawisz. Moduł touchpada Moduł także służący do sterowanie ruchem kursora, lecz za pomocą emulacji touchpada podobnego do tego w komputerach przenośnych. W opcjach możliwa zmiana jego czułości. Klawisze myszki działają także z funkcją blokady z modułu myszy. 27

28 Moduł klawiatury W tym module możesz użyć klawiatury swojego urządzenia do wpisywania tekstu na komputerze, do którego jesteś podłączony. Pole widoczne nad klawiaturą ekranową pozwala na podgląd ostatniego wpisanego znaku lub wyrazu w przypadku klawiatury Swype i podobnych do niej. Pokaż/ukryj klawiaturę przełącznik pozwalający na wywołanie klawiatury ekranowej bądź jej ukrycie. Moduł skrótów klawiszowych Moduł do sterowania aplikacjami za pomocą skrótów klawiszowych. Po wyborze zestawu, przeniesiony zostaniesz na listę dostępnych w nim skrótów. Powrót cofa użytkownika do listy zestawów. 28

29 Moduł kontrolera gier Moduł służący do emulacji kontrolera gier z czujnikiem ruchu. Wykorzystywany jest w mim wbudowany w urządzenie akcelerometr. Ruch telefonu w przód, tył oraz na boki odwzorowywany jest na odpowiednie akcje po stronie serwera. Akcje te oraz zachowanie przycisków widocznych powyżej można przedefiniować w aplikacji serwerowej. Pomoc oraz konfiguracja modułów Na ostatniej karcie widnieje opis pomocy do aktywnego modułu. W wybranych, dostępny jest także przycisk Zmień ustawienia, który przenosi użytkownika do ekranu opcji danego modułu. 29

30 Konfiguracja modułu touchpada Jako przykład ekranu opcji modułu wybrana została Suwakiem możesz zmieniać jego czułość wedle potrzeb. konfiguracja touchpada. Zapisz zapisuje ustawienia modułu, Przywróć domyślne przywraca predefiniowane ustawienia modułu. Ekran informacji i języka Na tym ekranie możesz zmienić język komunikatów programu. Dostępne tłumaczenia to język polski oraz angielski. Niżej widnieją informacje na temat aplikacji. 30

31 Pytania i problemy Masz problem z działaniem którejś z aplikacji? A może chcesz nam zadać pytanie? Zapraszamy na stronę Znajdziesz tam więcej informacji oraz dokumentację projektu. Wszelkie usterki i pytania możesz zgłosić przez dostępny na stronie formularz kontaktowy. Chętnie pomożemy i rozwiejemy wszelkie wątpliwości. Jesteśmy także otwarci na sugestie dotyczące naszych programów. 31