Instance Method

scoreForPlayer:

Returns a number rating the desirability of the game model’s current state from the perspective of the specified player.

Declaration

- (NSInteger)scoreForPlayer:(id<GKGameModelPlayer>)player;

Parameters

player

An instance of your game’s player class (a custom class implementing the GKGameModelPlayer protocol) representing the player evaluating the game model.

Return Value

A value indicating the specified player’s evaluation of the game model’s current state. Higher values indicate that a state is more desirable than lower values.

Discussion

The score you return from this method is the primary heuristic by which the GKMinmaxStrategist class evaluates possible moves. GameplayKit speculates about the effects of possible future moves by making copies of the active game model, applying possible moves to that model, and calling your scoreForPlayer: method to rate the effects of those moves. Returning a high rating from your score method indicates a state of the game model that is advantageous to the given player; a low rating indicates a state that is less advantageous. GameplayKit then collects and sorts the scores resulting from many possible moves (including future moves that follow the move currently being planned) to find the most advantageous move for the active player’s current turn.

Exactly how you calculate scores to return from this method depends on the rules of your game and your strategy for evaluating possible game states. The gameplay performance of the GKMinmaxStrategist strategist depends largely on the soundness of your metric in describing the relative advantage of different game positions. For example, if your metric can distinguish between a move that is likely to result in a win after a few turns and a move that is likely to result in a win after many turns, the strategist will be better able to predict winning moves.

This method should return NSIntegerMin if the specified player is not valid.

See Also

Evaluating a Game Model

- gameModelUpdatesForPlayer:

Returns the set of moves available to the specified player.

Required.

- isLossForPlayer:

Returns a Boolean value indicating whether the specified player has lost the game.

- isWinForPlayer:

Returns a Boolean value indicating whether the current state of the game model reflects a win for the specified player.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software