Interface PokerSquaresPlayer

All Known Implementing Classes:

GreedyMCPlayer, RandomPlayer

public interface PokerSquaresPlayer

PokerSquaresPlayer - a simple player interface for PokerSquares. For each score system, there will be a call to setScoreSystem followed by the calls of one or more games. For each game, there will be a call to init() followed by 25 calls to getPlay(Card, long). Author: Todd W. Neller

Method Summary

Modifier and Type	Method and Description
java.lang.String	getName() getName - gets the uniquely identifying name of the Poker Squares player.
int[]	getPlay(Card card, long millisRemaining) getPlay - gets the current play position for a given card within the allotted number of milliseconds.
void	init() init - initializes the player before each game
void	setPointSystem(PokerSquaresPointSystem system, long millis) setScoreSystem - provides the player with the point system that will be used in subsequent games until a new point system is specified by the same method.

Method Detail

setPointSystem

void setPointSystem(PokerSquaresPointSystem system,
                    long millis)

setScoreSystem - provides the player with the point system that will be used in subsequent games until a new point system is specified by the same method. Players can assume that (1) this will be the first method called on a PokerSquaresPlayer, and (2) it will be followed immediately by a call to init(). The amount of time allotted to the player to prepare for using this system is given by parameter millis. After the given number of milliseconds, or after the player returns from this method, the player should be ready to play. It is permissible to perform such computation on a separate thread, but the player should be able to play immediately after the return from this method or after the allotted time, whichever comes first.

Parameters:

system - - new score system

millis - - number of milliseconds allotted for player processing of the new point system

init

void init()

init - initializes the player before each game

getPlay

int[] getPlay(Card card,
              long millisRemaining)

getPlay - gets the current play position for a given card within the allotted number of milliseconds. Each card passed to getPlay has been drawn from the game deck. Each legal returned move will be made for the player. Thus, this method contains all information necessary to maintain current game state for the player. It is the player's responsibility to record its own moves, which and how many cards have been played, etc.

Parameters:

card - - card just drawn.

millisRemaining - - remaining milliseconds for play in the rest of the player's game.

Returns:

a 2D int array with the chosen (row, col) position for play of the given card.

getName

java.lang.String getName()

getName - gets the uniquely identifying name of the Poker Squares player. The name should be 20 characters or less.

Returns:

unique player name