A Volity game has been successfully concluded, and corresponding data has been recorded for analysis.
Volity::GameRecord is a Perl module that provides valuable information about a completed Volity game. The module offers a variety of methods that make it easy to build and sign an RPC call for a game referee, which can then be sent to a Volity network's bookkeeper once the game has concluded.
This class provides an abstraction of the information contained in a finished game, and it is easy for a parlor to use its methods to create and sign the RPC call, and it is equally easy for the receiving bookkeeper to accept it. It is important to note that, because RPC is a neutral middle ground, a Volity::Game::Server subclass object can pass Volity::GameRecord to any Volity bookkeeper, regardless of its platform. Similarly, a Volity::Bookkeeper object can make a Volity::Gamerecord object from any game parlor's RPC request, regardless of whether the parlor runs Frivolity.
Game module designers do not need to worry about Volity::GameRecord because records are automatically created by Volity::Referee objects when a game has ended. In addition, incoming records are automatically parsed by the bookkeeper. The main responsibility with game record handling involves the winners list, which is available through the winners() method of your Volity::Game subclass and can be manipulated through the methods described in Volity::WinnersList.
The following documentation is included for completeness' sake, but those who want to modify the Frivolity referee or bookkeeper behavior can find it useful.
This class provides an abstraction of the information contained in a finished game, and it is easy for a parlor to use its methods to create and sign the RPC call, and it is equally easy for the receiving bookkeeper to accept it. It is important to note that, because RPC is a neutral middle ground, a Volity::Game::Server subclass object can pass Volity::GameRecord to any Volity bookkeeper, regardless of its platform. Similarly, a Volity::Bookkeeper object can make a Volity::Gamerecord object from any game parlor's RPC request, regardless of whether the parlor runs Frivolity.
Game module designers do not need to worry about Volity::GameRecord because records are automatically created by Volity::Referee objects when a game has ended. In addition, incoming records are automatically parsed by the bookkeeper. The main responsibility with game record handling involves the winners list, which is available through the winners() method of your Volity::Game subclass and can be manipulated through the methods described in Volity::WinnersList.
The following documentation is included for completeness' sake, but those who want to modify the Frivolity referee or bookkeeper behavior can find it useful.
What's New
Version 0.7.1: N/A