Projekt K.I.K. Podręcznik użytkownika Paweł Kieliszczyk, Bartłomiej Kucharczyk, Michał Skrzypkowski, Szymon Wilczek 18 stycznia 2010
2
Rozdział 1 Wstęp 1.1 Wprowadzenie Dziękujemy za wybór naszego produktu! Produkt K.I.K. czyli Konferencyjny Intuicyjny Komunikator został zaprojektowany po to, by ułatwić prowadzenie konferencji oraz przedstawianie prezentacji na odległość. Poza cechami typowego komunikatora pozwalającego prowadzić konferencje na odległość nasz produkt wyróżnia również: intuicyjny interfejs użytkownika, wirtualna tablica pozwalająca na jednoczesne rysowanie na niej przez kilku użytkowników, pełna funkcjonalność w przeglądarce internetowej. Dzięki wykorzystaniu innowacyjnej technologii Google stało się możliwe stworzenie tak wspaniałego produktu, jakim jest K.I.K. Mamy nadzieję, że korzystanie z naszego produktu przysporzy Państwu, conajmniej tyle samo przyjemności, co nam tworzenie go. Życzymy miłego użytkowania! 1.2 Wymagania systemowe Aby zagwarantować pełne działanie aplikacji należy posiadać przeglądarkę internetową z obsługującą język javascript, na przykład: Firefox, Opera, Google Chrome, Safari, Internet Explorer 6+. Konieczne jest również posiadanie konta na serwerze jabbera obsługującym http-bind. 1.3 Instalacja systemu w sieci lokalnej Instalacja systemu w sieci lokalnej składa się z trzech kroków: 1. Konfiguracja serwera Apache: w pliku konfiguracyjnym apache <apache>/conf/httpd.conf należy odkomentować następujące linie: 3
4 ROZDZIAŁ 1. WSTĘP LoadModule proxy module modules/mod proxy.so LoadModule proxy ajp module modules/mod proxy ajp.so LoadModule rewrite module modules/mod rewrite.so Include conf/extra/httpd-vhosts.conf W pliku konfiguracyjnym apache <apache>/conf/extra/httpd-vhosts.conf należy dopisać nastęujące linie < VirtualHost *:80 > ServerName tomcat.localhost ProxyPass /kik ajp://localhost:8009/kik ProxyPassReverse /kik ajp://localhost:8009/kik < /VirtualHost > należy zakomentować pozostałe definicje VirtualHost 2. Konfiguracja serwera Tomcat w pliku konfiguracyjnym Tomcat <tomcat>/conf/server.xml nalećy odkomentować następującą linię: <Connector port="8009" protocol="ajp/1.3" redirectport="8443" /> 3. Konfiguracja lokalnego serwera jabbera poniżej znajduje się adres strony internetowej, na której znajduje się przykładowa konfiguracja serwera jabbera ejabberd na systemie Ubuntu http://code.google.com/p/emite/wiki/ejabberdubuntu
Rozdział 2 Korzystanie z aplikacji K.I.K. 2.1 Uruchomienie aplikacji Uruchomienie aplikacji odbywa się poprzez wpisanie w przeglądarce internetowej odpowiedniego adresu strony. 2.2 Logowanie Poniżej znajduje się interfejs logowania do aplikacji. Logowanie odbywa się w następujący sposób: 1. wpisanie nazwy użytkownika w formie nazwaużytkownika@serwerjabbera w polu Login, 2. wpisanie hasła w polu Password, 3. kliknięcie na przycisk Connect. 5
6 ROZDZIAŁ 2. KORZYSTANIE Z APLIKACJI K.I.K. W przypadku jeżeli wszystkie podane dane są poprawne, użytkownik zostanie przeniesiony do interfejsu użytkownika konferencji, w przeciwnym wypadku nic się nie stanie. 2.3 Interfejs użytkownika konferencji Jeżeli logowanie przebiegło pomyślnie, użytkownik powinien zobaczyć stronę, która jest przedstawiona poniżej: Początkowy interfejs użytkownika można podzielić na trzy części: 1. Zarządzanie stanem użytkownika, w tej częsci znajdują się: tekst powitania użytkownika: Hello, nazwa użytkownika, przycisk Disconnect pozwalający wylogować się z aplikacji. 2. Okno przechowywania konferencji - zajmujące największą część strony. 3. Interfejs zarządzania konferencjami, w którym znajdują się: lista kontaktów - przedstawia listę dostępnych użytkowników w zakładce Online oraz listę niedostępnych użytkowników w zakładce Offline, przycisk Invite to Conference, przycisk Create Conference. 2.3.1 Tworzenie nowej konferencji Tworzenie nowej konferencji odbywa się poprzez naciśnięcie przycisku Create Conference. W oknie przechowywania konferencji pojawi się panel z zakładkami. Każda z zakładek posiada nazwę Conference oraz numer konferencji. Kliknięcie na odpowiednią zakładkę pozwoli wejść do okna danej konferencji, które jest przedstawione poniżej.
2.3. INTERFEJS UŻYTKOWNIKA KONFERENCJI 7 W lewej części okna znajduje się wirtualna tablica, natomiast w prawej części okna znajduje się panel rozmowy tekstowej, a następnie lista uczestników konferencji. 2.3.2 Zarządzanie konferencją Do każdej konferencji można zaprosić użytkowników. Wykonuje się to następującymi krokami: 1. zaznaczenie zakładki z konferencją, do której ma zostać zaproszony użytkownik, 2. zaznaczenie na liście kontaktów użytkownika, który ma zostać zaproszony do konferencji, 3. naciśnięcie przycisku Invite to Conference. W przypadku, gdy użytkownik jest dostępny pojawi się mu okno, w którym znajduje się pytanie o to, czy chce dołączyć do danej konferencji (okno to można zobaczyć poniżej). W przypadku, gdy użytkownik jest niedostępny okno to pojawi się dopiero, gdy zmieni swój stan na dostępny. Naciśnięcie przycisku OK spowoduje przyjęcie zaproszenia oraz w konsekwencji dołączenie do konferencji. Naciśnięcie przycisku Anuluj spowoduje odrzucenie zaproszenia. znaj- Z konferencji można wyjść w każdej chwili klikając na przycisk dujący się w oknie konferencji. 2.3.3 Obsługa wirtualnej tablicy Poniżej znajduje się panel wirtualnej tablicy:
8 ROZDZIAŁ 2. KORZYSTANIE Z APLIKACJI K.I.K. Naciśnięcie strzałki znajdującej się w lewym górnym rogu panelu spowoduje ukrycie wirtualnej tablicy. Ponowne kliknięcie tej strzałki spowoduje, iż wirtualna tablica pojawi się ponownie. To, co zostanie narysowane na wirtualnej tablicy danego użytkownika, pojawi się na wirtualnej tablicy wszystkich pozostałych użytkowników należących do konferencji. Wirtualna tablica posiada 11, z których można korzystać: 1. [] - narzędzie służące do rysowania prostokątów. Przyciśnięcie lewego przycisku myszy na obszarze roboczym wirtualnej tablicy spowoduje rozpoczęcie rysowania prostokąta. Następnie przytrzymując lewy przycisk myszy i poruszając myszką po obszarze roboczym wirtualnej tablicy można obserwować obecnie tworzony prostokąt. Puszczenie lewego przycisku myszy spowoduje utworzenie prostokąta wówczas widocznego na ekranie. 2. O - narzędzie służące do rysowania okręgów. Przyciśnięcie lewego przycisku myszy na obszarze roboczym wirtualnej tablicy spowoduje rozpoczęcie rysowania okręgu. Miejsce kliknięcia wyznacza środek okręgu. Następnie przytrzymując lewy przycisk myszy i poruszając myszką po obszarze roboczym wirtualnej tablicy można obserwować obecnie tworzony okrąg. Poruszanie myszką służy do zmiany długości promienia. Puszczenie lewego przycisku myszy spowoduje utworzenie okręgu wówczas widocznego na ekranie. 3. - - narzędzie służące do rysowania linii prostej. Przyciśnięcie lewego przycisku myszy na obszarze roboczym wirtualnej tablicy spowoduje rozpoczęcie rysowania linii. Miejsce kliknięcia wyznacza punkt początkowy linii. Następnie przytrzymując lewy przycisk myszy i poruszając myszką po obszarze roboczym wirtualnej tablicy można obserwować obecnie tworzoną linię. Puszczenie lewego przycisku myszy spowoduje utworzenie linii wówczas widocznej na ekranie. Miejsce puszczenia lewego przycisku myszki wyznacza punkt końcowy linii. 4. + - narzędzie służące do przesuwania obiektów widocznych na wirtualnej tablicy. Przyciśnięcie lewego przycisku myszy na obiekcie znajdującym się na obszarze roboczym wirtualnej tablicy spowoduje zaznaczenie tego obiektu. Następnie przytrzymując lewy przycisk myszy i poruszając myszką po obszarze roboczym wirtualnej tablicy można obserwować przesuwanie obiektu. Puszczenie lewego przycisku myszy spowoduje upuszczenie obiektu oraz pozostawienie tablicy w wówczas widocznym stanie. Wszyst-
2.3. INTERFEJS UŻYTKOWNIKA KONFERENCJI 9 kie obiekty znajdujące się na tablicy mogą być przesuwane poza śladem pędzla. 5. ~ - narzędzie służące do rysowania pędzlej po wirtualnej tablicy. Przyciśnięcie lewego przycisku myszy na obszarze roboczym wirtualnej tablicy spowoduje rozpoczęcie rysowania pędzlem. Następnie przytrzymując lewy przycisk myszy i poruszając myszką po obszarze roboczym wirtualnej tablicy można obserwować tworzony obiekt. Pędzel zostawia ślad za ruchem myszki. Puszczenie lewego przycisku myszy spowoduje stworzenie śladu po ruchu pędzla, który odbył się w trakcie trzymania lewego przycisku myszki. 6. txt - narzędzie służy do pisania tekstu na obszarze roboczym wirtualnej tablicy. Kliknięcie lewym przyciskiem myszki na obszarze roboczym wirtualnej tablicy spowoduje pojawienie się poniższego okna. W polu tekstowym należy wpisać tekst, który chcemy aby pojawił się na obszarze roboczym wirtualnej tablicy. Następnie należy kliknąć na przycisk Drukuj. Naciśnięcie tego przycisku spowoduje pojawienie się tekstu, w miejscu, w którym kliknięcie myszką spowodowało pojawienie się okna do wpisywania tekstu. 7. /\ - narzędzie służce do zmiany priorytetu rysowania obiektu. Kliknięcie lewym przyciskiem myszy na danym obiekcie spowoduje przesunięcie obiektu warstwę wyżej, innymi słowy, będzie on rysowany nad obiektem, który znajdował się bezpośrednio nad nim. Narzędzia nie da się zastosować do śladu pędzla. 8. \/ - narzędzie służce do zmiany priorytetu rysowania obiektu. Kliknięcie lewym przyciskiem myszy na danym obiekcie spowoduje przesunięcie obiektu warstwę niżej, innymi słowy, będzie on rysowany pod obiektem, który znajdował się bezpośrednio pod nim. Narzędzia nie da się zastosować do śladu pędzla. 9. d - narzędzie służące do usuwania obiektów znajdujących się na wirtualnej tablicy. Kliknięcie lewym przyciskiem na obiekt znajdujący się na obszarze roboczym wirtualnej tablicy spowoduje jego usunięcie. Narzędzia nie da się zastosować do śladu pędzla. 10. img - narzędzie służy do dodawania obrazków do obszaru roboczego wirtualnej tablicy. Kliknięcie lewym przyciskiem myszki na obszarze roboczym wirtualnej tablicy spowoduje pojawienie się poniższego okna.
10 ROZDZIAŁ 2. KORZYSTANIE Z APLIKACJI K.I.K. W polu tekstowym należy wpisać adres obrazka, którego chcemy wkleić do obszaru roboczego. Następnie należy nacisnąć przycisk Otworz. To spowoduje pojawienie się obrazka w miejscu, w którym kliknięcie myszką spowodawało pojawienie się okna ładowania obrazka. Uwaga: Obrazek musi znajdować się na zewnętrznym serwerze. 11. c - kliknięcie tego przycisku spowoduje usunięcie wszystkich obiektów obecnie widocznych na obszarze roboczym wirtualnej tablicy. 2.3.4 Obsługa rozmowy Poniżej znajduje się panel rozmowy. Aby wysłać wiadomość do wszystkich użytkowników należących do konferencji należy wpisać tekst w polu tekstu znajdującym się na dole panelu rozmowy i nacisnąć przycisk Send.