Returns a number rating the desirability of the game model’s current state from the perspective of the specified player.
- iOS 9.0+
- macOS 10.11+
- Mac Catalyst 13.0+
- tvOS 9.0+
An instance of your game’s player class (a custom class implementing the
GKGameprotocol) representing the player evaluating the game model.
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.
The score you return from this method is the primary heuristic by which the
GKMinmax 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
score(for:) 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
GKMinmax 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
NSInteger if the specified player is not valid.