GASPDemonstrator (DoJa) install requirements and using.

This demonstrator is actually a simple game without collision detection, without lives management and so on... It's a free software. You can redistribute it and/or modify it under the terms of the GNU Lesser General Public License (LGPL) as published by the Free Software Foundation , either version 2.1 of the license, or (at your option) any later version.
The GASPDemonstrator has been created to be used on a GASP Platform (cf. http://gasp.objectweb.org/).
So you must install and manage this kind of server and also:

Note: all these indications are given for a Microsoft Windows environment. It has been tested on a Windows XP Workstation.

install on a workstation

J2SE SDK (file: j2sdk-1_4_2_10-windows-i586-p-iftw.exe) here: (http://javashoplm.sun.com/ECom/docs/Welcome.jsp?StoreId=22&PartDetailId=j2sdk-1.4.2_10-oth-JPR&SiteId=JSC&TransactionId=noreg)
iappli Developpment Kit (iDK) which is contained in the in the DoJa emulator. Downloadable here: http://www.doja-developer.net/downloads/index.php?node=43
jDKDoja2.5 (file: 2122_25emulator1_03.zip) from here: http://www.doja-developer.net/downloads/index.php?node=41
J2ME Wireless Toolkit 2.2 from Sun (http://java.sun.com/products/sjwtoolkit/download-2_2.html)
extract (unzip) DoJaGASPDemonstratorClient to C:\iDK\apps\DojaGASPDemonstratorClient
extract (unzip) GASPDemonstratorServer to \\web-inf\lib on the GASP Platform

Before starting this Demonstrator, you must:

know that this Gasp demonstrator is available with DoJa 1.5, so you must use the compliant emulator.
create all the users in GASP Data Base (cf. Getting Started_ENG_for_developpers_v3.0.2 p33)

Now running...

For each player, running the emulator (C:\iDK\bin\doja.exe):
At the first time, you have to create a project as described below. After, it will be easier.... you will just open a project, then build it (with the right device) and run it.
First starting

create a new project

Name project: DojaGASPDemonstratorClient
ADF configurations : AppName= App, PackageURL= http://localhost:8080/ (the adress of your GASP Server), AppClass=app2.App, LastModified= Mon, 20 Mar 2006 14:40:41 and finally UseNetwork= http.

build the project with the bigest device (device3).
run the project .......an emulator will appear on your screen....

Access to the GASP interface:

Click on Launch button
Fill Login and Password fields, then click on Login (Login: testx, Password: testx with x representing a player)
you will have an ActorId and a SessionID before access to the Lobby Room

In Lobby Room, several cases:

no session joinable : creation mode
one or more sessions are joinable: you can join randomly a session or join a specific session
refresh the screen (none session is visible): click on Refresh
Quit the GASP Platform (Click on Menu, then Quit)

In Waiting Room:

Pseudo (change your pseudoname)
Start the game (only for the Owner)
Quit Session (go back to Lobby Room)
Quit (go back to Gasp Log On )

In Game:

Move your Heroe
Pause
End Session (only for the Owner)
Quit (go back to Gasp Log On )

To create a game session:
On lobby screen...you can Create a game session (click on the create button, then a new screen will appear)

to create a public session, you have to indicate a minimal and a maximal number of player (fields Minimum, Maximum), click on Ok.
you can also create a private session (but it's not ready)
if you click on Back, you will go back to the previous screen (Lobby Room) without creating a session

When you create a game session, you become the game session Owner.

(Lobby Room), (Top)

To join a game session:
On Lobby screen...if one or more game session exist, you can join randomly a session or join a specific session
By default, a random access is selected to join a game session.
If you want to join a specific game session, you have to selecte it with arrows keys and click on the Join button.
Then, you will be in Waiting room. If a new player joins this game session, you will receive a message with its name and Id
Now, you must wait the launching of the game by the owner of the game session.
If a game session has begun, a new player cannot join this game session.

(Lobby Room), (Top)

To start:
Nobody else that the owner can start a game session. So, if you are the owner of a game session you can start it from the Waiting Room: Start (2nd SoftKey).

(Waiting Room), (Top)

To play: (move your Heroe)
When the Owner begun the game, each player receives a message and its heroe will appear in the middle of the screen (a red actor).
All the other actors (blue actor) will appear at the same place on each device.
You can move your own heroe with the arrows keys. Its avatar will move on the other devices with a specific algorithm (Dead Reckonning)

Pause:
You can interrupt your game.... Your screen will seem to be freezed until you select Pause.

(In GAME), (Top)

To leave the game: (Quit Session)
You can leave a game session by selecting Quit session (you will leave the game session)
   1-If you are the Owner of a game session, leaving the game session to go back to the Lobby Room or leaving the platform,
       will stop the game and each others players will receive a message before going back to the Lobby screen.

   2-If you are a player, when you leave a game session (Quit Session) or the platform (Quit) each others players will receive a message.
   If there is no more enough player in game, the game session is stopped until a new player joins this game session.

(In GAME), (Top)

To leave the platform: (Quit)
Each players can leave the platform from anywhere. For this, you must click on Quit on any Screen. You will be then on Gasp Log On.

To end a game session: (end session)
The Owner of a game session is the only one who can end a game session. Each others players receive a message and go back to the Waiting Room.

(In GAME), (Top)

Pseudoname option:
You can change the pseudoname of your heroe... You must be in Waiting Room!
Click on options... a new screen will appear. Fill the pseudoname field and submit by clicking on Ok.

(Waiting Room), (Top)

Troubleshooting:

SessionID = 0: The Gasp Platform is not started or you made an error with your Login or your Password (be careful to respect the case)