GASPDemonstrator
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:
- duplicate the directory
\WTK22\wtklib\devices\DefaultColorPhone
and rename it :
\WTK22\wtklib\devices\DefaultColorPhoneUIDx With x
which represent the player Id. Then rename DefaultColorPhone.properties
in DefaultColorPhoneUIDx.properties.
This is quite important because the UID is useful with the couple
(login+password) in order to ensure the connection on the GASP
platform. With the first DefaultColorPhone, the user is, for instance, login: test1, pwd: test1
- 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 KToolBar:
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: GASPDemonstratorClient
- Midlet Class Name: app2.client.App
- build the project with a different device for each player:
DefaultColorPhone for player1, DefaultcolorPhoneUID2 for
player2
and so on...
- 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)
- accept to use airtime by clicking on Yes. If you refuse by
clicking on No, you will go back to previous screen.
- 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 (no session is visible): click on Menu,
then Refresh
- Quit the GASP
Platform (Click on Menu, then Quit)
In Waiting Room:
- Options (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 Menu, then
Create 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 Menu, then
Create.
- you can also create a private session (but it's not ready)
- if you select Cancel in the Menu, 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 choose Join
in the Menu.
Then, you will be in Waiting room. If a new player join this game
session, you will receive a message with its name and Id
Now, you must await 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 Session in the Menu.
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 on the Menu.
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 join this game session.
To leave
the platform: (Quit)
Each players can leave the platform from anywhere. For
this, you must selecte Quit on any Menu. 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 Menu, then options... a new screen will appear. Fill the
pseudoname field and submit by clicking on Menu, then 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)