Games that are made to target devices that run iOS or Android
can also connect to one of two leaderboard and achievement API's.
For iOS you have the iTunes Game Center, and for Android you
can use the Amazon Game Circle or Google Play, with
all of them using the using the functions found on this page. These
functions permit your game to send information on scores and
achievements to the leaderboards that you have set up in the
Developers Account for the game you are making and is an excellent
way to get players involved in the social side of gaming as they
can then see what other people who have played your game have
achieved and try to better them.
When using these functions, you should note that they do not track achievements and scores automatically for you. They only show the data that you send them from your game, so you must code your own achievements and hi-score system to keep track of the individuals status in game, then use these functions to add the data to the chosen network (however you can request progress information for achievements using the achievement_load_progress function).
Some of these functions will trigger a callback Social Asynchronous Event, which will contain a ds_map of data relating to the function that triggered it. Those functions that trigger the event also detail the map key/value pairs that are returned by the callback, however a callback Social Event can also be triggered by your game receiving external notifications about challenges etc... The exact details of the ds_map returned for these events are explained in the Social Asynchronous Event section.
NOTE: For these functions to work with iOS you must have a valid Game Center account and an iOS app id for your game.
NOTE: For these functions to work with Android you must submit your game to the Amazon App store, or to Google Play, and have set up the necessary sections as well as have the API activated in the Global Game Settings for your game.
The functions listed below are the basic ones used for integrating your game with the chosen target social gaming platform:
Apart from these functions for devices, GameMaker: Studio also integrates a basic highscore storage system that is local to your game and compatible with all platforms. This system can store up to ten places (with names and scores) locally, which you can then draw on-screen as you wish. For more information see:
- Local High Scores