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
- 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.
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.
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).
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.
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.
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.
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.
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)