AchievementsClient

Returns aTaskwhich asynchronously loads anIntentto show the list of achievements for a game. Note that theIntentreturned from theTaskmust be invoked with Activity.startActivityForResult(Intent, int),so that the identity of the calling package can be established.

The returnedTaskcan fail with aRemoteException.

Increments an achievement by the given number of steps. The achievement must be an incremental achievement. Once an achievement reaches at least the maximum number of steps, it will be unlocked automatically. Any further increments will be ignored.

This is the fire-and-forget form of the API. Use this form if you don't need to know the status of the operation immediately. For most applications, this will be the preferred API to use, though note that the update may not be sent to the server until the next sync. See incrementImmediate(String, int)if you need the operation to attempt to communicate to the server immediately or need to have the status code delivered to your application.

Returns aTaskwhich asynchronously increments an achievement by the given number of steps. The achievement must be an incremental achievement. Once an achievement reaches at least the maximum number of steps, it will be unlocked automatically. Any further increments will be ignored.

This form of the API will attempt to update the user's achievement on the server immediately. TheBooleanin a successful response indicates whether the achievement is now unlocked.

Returns aTaskwhich asynchronously loads an annotated AchievementBufferthat represents the achievement data for the currently signed-in player.

AbstractDataBuffer.release()should be called to release resources after usage.

Reveals a hidden achievement to the currently signed-in player. If the achievement has already been unlocked, this will have no effect.

This is the fire-and-forget form of the API. Use this form if you don't need to know the status of the operation immediately. For most applications, this will be the preferred API to use, though note that the update may not be sent to the server until the next sync. See revealImmediate(String)if you need the operation to attempt to communicate to the server immediately or need to have the status code delivered to your application.

Returns aTaskwhich asynchronously reveals a hidden achievement to the currently signed in player. If the achievement is already visible, this will have no effect.

This form of the API will attempt to update the user's achievement on the server immediately. TheTaskwill complete successfully when the server has been updated.

Sets an achievement to have at least the given number of steps completed. Calling this method while the achievement already has more steps than the provided value is a no-op. Once the achievement reaches the maximum number of steps, the achievement will automatically be unlocked, and any further mutation operations will be ignored.

This is the fire-and-forget form of the API. Use this form if you don't need to know the status of the operation immediately. For most applications, this will be the preferred API to use, though note that the update may not be sent to the server until the next sync. See setStepsImmediate(String, int)if you need the operation to attempt to communicate to the server immediately or need to have the status code delivered to your application.

Returns aTaskwhich asynchronously sets an achievement to have at least the given number of steps completed. Calling this method while the achievement already has more steps than the provided value is a no-op. Once the achievement reaches the maximum number of steps, the achievement will automatically be unlocked, and any further mutation operations will be ignored.

This form of the API will attempt to update the user's achievement on the server immediately. TheBooleanin a successful response indicates whether the achievement is now unlocked.

Unlocks an achievement for the currently signed in player. If the achievement is hidden this will reveal it to the player.

This is the fire-and-forget form of the API. Use this form if you don't need to know the status of the operation immediately. For most applications, this will be the preferred API to use, though note that the update may not be sent to the server until the next sync. See unlockImmediate(String)if you need the operation to attempt to communicate to the server immediately or need to have the status code delivered to your application.

Returns aTaskwhich asynchronously unlocks an achievement for the currently signed in player. If the achievement is hidden this will reveal it to the player.

This form of the API will attempt to update the user's achievement on the server immediately. TheTaskwill complete successfully when the server has been updated.