SC_LocalAchievementsController

The SC_LocalAchievementsController manages achievements of the current game for the session user only.

This information is stored locally and has to be synchronized by the developer with the server.

The APIs of SC_LocalAchievementsController allow the following actions:

• set an award as being achieved

• update achievement progress

• query for local achievements progress

• synchronize local achievements with the server

Note that you must configure awards for your game on . Part of the configuration process includes choosing a unique reverse DNS identifier for every award. Once awards have been configured, Scoreloop generates an awards bundle, which you must add to you game projects. This provides local access to information about the configured awards, including their identifiers and achieving values, among other things.

See also:

SC_Award.

a) To set an award as being achieved for a user: When the game is played, as the user completes one of the incremental stages necessary to achieve the award, set the value of the award accordingly.

1. Get an instance of SC_LocalAchievementsController or reuse an existing one.

2. To do this, use one of the following:

   • SC_LocalAchievementsController_SetValueForAwardIdentifier() or

   • SC_LocalAchievementsController_IncrementValueForAwardIdentifier() or

   • SC_LocalAchievementsController_SetAchievedValueForAwardIdentifier()

b) To synchronize locally stored information with the server:

1. Get an instance of SC_LocalAchievementsController or reuse an existing one.

2. Call the SC_LocalAchievementsController_ShouldSynchronize()

3. to update the server with the local data.

c) To retrieve lists of Achievement objects

1. Get an instance of SC_LocalAchievementsController or re-use an existing one.

2. Call SC_LocalAchievementsController_GetAchievements() to obtain achievements for the session user