public interface Achievement implements Freezable<Achievement> Parcelable
Known Indirect Subclasses

Data interface for retrieving achievement information.

Nested Class Summary

@interface Achievement.AchievementState Achievement state. 
@interface Achievement.AchievementType Achievement type. 

Constant Summary

int STATE_HIDDEN Constant returned by getState() indicating a hidden achievement.
int STATE_REVEALED Constant returned by getState() indicating a revealed achievement.
int STATE_UNLOCKED Constant returned by getState() indicating an unlocked achievement.
int TYPE_INCREMENTAL Constant returned by getType() indicating an incremental achievement.
int TYPE_STANDARD Constant returned by getType() indicating a standard achievement.

Inherited Constant Summary

Public Method Summary

abstract String
getAchievementId()
Retrieves the ID of this achievement.
abstract int
getCurrentSteps()
Retrieves the number of steps this user has gone toward unlocking this achievement; only applicable for TYPE_INCREMENTAL achievement types.
abstract String
getDescription()
Retrieves the description for this achievement.
abstract void
getDescription(CharArrayBuffer dataOut)
Loads the achievement description into the given CharArrayBuffer.
abstract void
getFormattedCurrentSteps(CharArrayBuffer dataOut)
Retrieves the number of steps this user has gone toward unlocking this achievement (formatted for the user's locale) into the given CharArrayBuffer.
abstract String
getFormattedCurrentSteps()
Retrieves the number of steps this user has gone toward unlocking this achievement (formatted for the user's locale); only applicable for TYPE_INCREMENTAL achievement types.
abstract void
getFormattedTotalSteps(CharArrayBuffer dataOut)
Loads the total number of steps necessary to unlock this achievement (formatted for the user's locale) into the given CharArrayBuffer; only applicable for TYPE_INCREMENTAL achievement types.
abstract String
getFormattedTotalSteps()
Retrieves the total number of steps necessary to unlock this achievement, formatted for the user's locale; only applicable for TYPE_INCREMENTAL achievement types.
abstract long
getLastUpdatedTimestamp()
Retrieves the timestamp (in millseconds since epoch) at which this achievement was last updated.
abstract void
getName(CharArrayBuffer dataOut)
Loads the achievement name into the given CharArrayBuffer.
abstract String
getName()
Retrieves the name of this achievement.
abstract Player
getPlayer()
Retrieves the player information associated with this achievement.
abstract Uri
getRevealedImageUri()
Retrieves a URI that can be used to load the achievement's revealed image icon.
abstract int
getState()
Returns the Achievement.AchievementState of the achievement.
abstract int
getTotalSteps()
Retrieves the total number of steps necessary to unlock this achievement; only applicable for TYPE_INCREMENTAL achievement types.
abstract int
getType()
Returns the Achievement.AchievementType of this achievement.
abstract Uri
getUnlockedImageUri()
Retrieves a URI that can be used to load the achievement's unlocked image icon.
abstract long
getXpValue()
Retrieves the XP value of this achievement.

Inherited Method Summary

Constants

public static final int STATE_HIDDEN

Constant returned by getState() indicating a hidden achievement.

Constant Value: 2

public static final int STATE_REVEALED

Constant returned by getState() indicating a revealed achievement.

Constant Value: 1

public static final int STATE_UNLOCKED

Constant returned by getState() indicating an unlocked achievement.

Constant Value: 0

public static final int TYPE_INCREMENTAL

Constant returned by getType() indicating an incremental achievement.

Constant Value: 1

public static final int TYPE_STANDARD

Constant returned by getType() indicating a standard achievement.

Constant Value: 0

Public Methods

public abstract String getAchievementId ()

Retrieves the ID of this achievement.

Returns
  • The achievement ID.

public abstract int getCurrentSteps ()

Retrieves the number of steps this user has gone toward unlocking this achievement; only applicable for TYPE_INCREMENTAL achievement types.

Returns
  • The number of steps this user has gone toward unlocking this achievement.

public abstract String getDescription ()

Retrieves the description for this achievement.

Returns
  • The achievement description.

public abstract void getDescription (CharArrayBuffer dataOut)

Loads the achievement description into the given CharArrayBuffer.

Parameters
dataOut The buffer to load the data into.

public abstract void getFormattedCurrentSteps (CharArrayBuffer dataOut)

Retrieves the number of steps this user has gone toward unlocking this achievement (formatted for the user's locale) into the given CharArrayBuffer.

Parameters
dataOut The buffer to load the data into.

public abstract String getFormattedCurrentSteps ()

Retrieves the number of steps this user has gone toward unlocking this achievement (formatted for the user's locale); only applicable for TYPE_INCREMENTAL achievement types.

Returns
  • The formatted number of steps this user has gone toward unlocking this achievement or null if this information is unavailable.

public abstract void getFormattedTotalSteps (CharArrayBuffer dataOut)

Loads the total number of steps necessary to unlock this achievement (formatted for the user's locale) into the given CharArrayBuffer; only applicable for TYPE_INCREMENTAL achievement types.

Parameters
dataOut The buffer to load the data into.

public abstract String getFormattedTotalSteps ()

Retrieves the total number of steps necessary to unlock this achievement, formatted for the user's locale; only applicable for TYPE_INCREMENTAL achievement types.

Returns
  • The total number of steps necessary to unlock this achievement or null if this information is unavailable.

public abstract long getLastUpdatedTimestamp ()

Retrieves the timestamp (in millseconds since epoch) at which this achievement was last updated. If the achievement has never been updated, this will return -1.

Returns
  • Timestamp at which this achievement was last updated.

public abstract void getName (CharArrayBuffer dataOut)

Loads the achievement name into the given CharArrayBuffer.

Parameters
dataOut The buffer to load the data into.

public abstract String getName ()

Retrieves the name of this achievement.

Returns
  • The achievement name.

public abstract Player getPlayer ()

Retrieves the player information associated with this achievement.

Note that this object is a volatile representation, so it is not safe to cache the output of this directly. Instead, cache the result of Freezable.freeze().

Returns
  • The player associated with this achievement.

public abstract Uri getRevealedImageUri ()

Retrieves a URI that can be used to load the achievement's revealed image icon. Returns null if the achievement has no revealed image.

To retrieve the Image from the Uri, use ImageManager.

Returns
  • The image URI for the achievement's revealed image icon, or null if the achievement has no revealed image.

public abstract int getState ()

Returns the Achievement.AchievementState of the achievement.

public abstract int getTotalSteps ()

Retrieves the total number of steps necessary to unlock this achievement; only applicable for TYPE_INCREMENTAL achievement types.

Returns
  • The total number of steps necessary to unlock this achievement.

public abstract int getType ()

Returns the Achievement.AchievementType of this achievement.

public abstract Uri getUnlockedImageUri ()

Retrieves a URI that can be used to load the achievement's unlocked image icon. Returns null if the achievement has no unlocked image.

To retrieve the Image from the Uri, use ImageManager.

Returns
  • The image URI for the achievement's unlocked image icon, or null if the achievement has no unlocked image.

public abstract long getXpValue ()

Retrieves the XP value of this achievement.

Returns
  • XP value given to players for unlocking this achievement.