edu.illinois.cs.cs125.fall2019.mp

Class AreaGame

java.lang.Object

edu.illinois.cs.cs125.fall2019.mp.Game

edu.illinois.cs.cs125.fall2019.mp.AreaGame

public final class AreaGame
extends Game

Represents an area mode game. Keeps track of cells and the player's most recent capture.

All these functions are stubs that you need to implement. Feel free to add any private helper functions that would be useful. See TargetGame for an example of how multiplayer games are handled.

Constructor Summary

Constructors

Constructor and Description
AreaGame(java.lang.String email, com.google.android.gms.maps.GoogleMap map, com.neovisionaries.ws.client.WebSocket webSocket, com.google.gson.JsonObject fullState, android.content.Context context) Creates a game in area mode.

Method Summary

Modifier and Type	Method and Description
int	getTeamScore(int teamId) Gets a team's score in this area mode game.
boolean	handleMessage(com.google.gson.JsonObject message, java.lang.String type) Processes an update from the server.
void	locationUpdated(com.google.android.gms.maps.model.LatLng location) Called when the user's location changes.

Methods inherited from class edu.illinois.cs.cs125.fall2019.mp.Game

getContext, getEmail, getMap, getMyTeam, sendMessage, sendMessage

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AreaGame

public AreaGame(java.lang.String email,
                com.google.android.gms.maps.GoogleMap map,
                com.neovisionaries.ws.client.WebSocket webSocket,
                com.google.gson.JsonObject fullState,
                android.content.Context context)

Creates a game in area mode.

Loads the current game state from JSON into instance variables and populates the map to show existing cell captures.

Parameters:

email - the user's email

map - the Google Maps control to render to

webSocket - the websocket to send updates to

fullState - the "full" update from the server

context - the Android UI context

Method Detail

getTeamScore

public int getTeamScore(int teamId)

Gets a team's score in this area mode game.

Specified by:

getTeamScore in class Game

Parameters:

teamId - the team ID

Returns:

the number of cells owned by the team

handleMessage

public boolean handleMessage(com.google.gson.JsonObject message,
                             java.lang.String type)

Processes an update from the server.

Since playerCellCapture events are specific to area mode games, this function handles those by placing a polygon of the capturing player's team color on the newly captured cell and recording the cell's new owning team. All other message types are delegated to the superclass.

Overrides:

handleMessage in class Game

Parameters:

message - JSON from the server

type - the update type

Returns:

whether the message type was recognized

locationUpdated

public void locationUpdated(com.google.android.gms.maps.model.LatLng location)

Called when the user's location changes.

Area mode games detect whether the player is in an uncaptured cell. Capture is possible if the player has no captures yet or if the cell shares a side with the previous cell captured by the player. If capture occurs, a polygon with the team color is added to the cell on the map and a cellCapture update is sent to the server.

Specified by:

locationUpdated in class Game

Parameters:

location - a location FusedLocationProviderClient is reasonably confident about