public final class AchievementEntity extends Object
implements Parcelable Achievement

Data object representing a set of Achievement data. This is immutable, and therefore safe to cache or store. Note, however, that the data it represents may grow stale.

This class exists solely to support parceling these objects and should not be used directly.

Inherited Constant Summary

Field Summary

public static final Creator<AchievementEntity> CREATOR

Public Method Summary

boolean
equals(Object obj)
Achievement
freeze()
String
getAchievementId()
Retrieves the ID of this achievement.
int
getCurrentSteps()
Retrieves the number of steps this user has gone toward unlocking this achievement; only applicable for TYPE_INCREMENTAL achievement types.
String
getDescription()
Retrieves the description for this achievement.
void
getDescription(CharArrayBuffer dataOut)
Loads the achievement description into the given CharArrayBuffer.
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.
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.
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.
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.
long
getLastUpdatedTimestamp()
Retrieves the timestamp (in millseconds since epoch) at which this achievement was last updated.
void
getName(CharArrayBuffer dataOut)
Loads the achievement name into the given CharArrayBuffer.
String
getName()
Retrieves the name of this achievement.
Player
getPlayer()
Retrieves the player information associated with this achievement.
Uri
getRevealedImageUri()
Retrieves a URI that can be used to load the achievement's revealed image icon.
String
getRevealedImageUrl()
int
getState()
Returns the Achievement.AchievementState of the achievement.
int
getTotalSteps()
Retrieves the total number of steps necessary to unlock this achievement; only applicable for TYPE_INCREMENTAL achievement types.
int
getType()
Returns the Achievement.AchievementType of this achievement.
Uri
getUnlockedImageUri()
Retrieves a URI that can be used to load the achievement's unlocked image icon.
String
getUnlockedImageUrl()
long
getXpValue()
Retrieves the XP value of this achievement.
int
hashCode()
boolean
isDataValid()
String
toString()
void
writeToParcel(Parcel dest, int flags)

Inherited Method Summary

Fields

public static final Creator<AchievementEntity> CREATOR

Public Methods

public boolean equals (Object obj)

public Achievement freeze ()

public String getAchievementId ()

Retrieves the ID of this achievement.

Returns
  • The achievement ID.

public 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 String getDescription ()

Retrieves the description for this achievement.

Returns
  • The achievement description.

public void getDescription (CharArrayBuffer dataOut)

Loads the achievement description into the given CharArrayBuffer.

Parameters
dataOut The buffer to load the data into.

public 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 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 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 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 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 void getName (CharArrayBuffer dataOut)

Loads the achievement name into the given CharArrayBuffer.

Parameters
dataOut The buffer to load the data into.

public String getName ()

Retrieves the name of this achievement.

Returns
  • The achievement name.

public 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 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 String getRevealedImageUrl ()

public int getState ()

Returns the Achievement.AchievementState of the achievement.

public 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 int getType ()

Returns the Achievement.AchievementType of this achievement.

public 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 String getUnlockedImageUrl ()

public long getXpValue ()

Retrieves the XP value of this achievement.

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

public int hashCode ()

public boolean isDataValid ()

public String toString ()

public void writeToParcel (Parcel dest, int flags)