Updates the internal state of the game model to remove the effect of the specified changes.
- iOS 9.1+
- macOS 10.11.2+
- Mac Catalyst 13.0+
- tvOS 9.0+
An instance of your custom class that implements the
GKGameprotocol, describing a move to be revoked in your game.
This method is an optional counterpart to the
apply method. By default, a GameplayKit strategist explores possible moves by copying the current game model, then calling that method to test the effect of a move. Copying a game model (see the
set method) repeatedly can increase the time it takes for a strategist to evaluate moves. If your move class (adopting the
GKGame protocol) can describe not only how to perform a move, but also how to take back a move—leaving the game model in the same state it was before the move—implement the
unapply method to undo moves. If you implement this method, the strategist can evaluate multiple moves without copying the game model, possibly increasing performance.
Some games naturally describe moves reversibly. For example, a Tic-Tac-Toe move class indicates which square to place a marker into, so unapplying that update would remove the marker from that square. To use this method in other games, however, you’ll need to design your move class carefully. For example, in a chess game, the move class would need to record both the original position and the destination position of a piece being moved, and either the move class or the game model class would need to track any pieces captured in that move so that they can be restored.