Hide

PlayerEntity

public final class PlayerEntity extends Object
implements Parcelable Player
java.lang.Object
   ↳ com.google.android.gms.games.PlayerEntity

Data object representing a set of Player 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<PlayerEntity> CREATOR

Public Method Summary

int
boolean
equals(Object obj)
Player
freeze()
String
void
Uri
Uri
long
PlayerLevelInfo
String
long
void
String
boolean
boolean
int
boolean
String
void
writeToParcel(Parcel dest, int flags)

Fields

public static final Creator<PlayerEntity> CREATOR

Public Methods

public int describeContents ()

public boolean equals (Object obj)

public Player freeze ()

Freeze a volatile representation into an immutable representation. Objects returned from this call are safe to cache.

Note that the output of freeze may not be identical to the parent object, but should be equal. In other words:

 
 Freezable f1 = new Freezable();
 Freezable f2 = f1.freeze();
 f1 == f2 may not be true.
 f1.equals(f2) will be true.
 
 

Returns
  • A concrete implementation of the data object.

public String getDisplayName ()

Retrieves the display name for this player.

Returns
  • The player's display name.

public void getDisplayName (CharArrayBuffer dataOut)

Loads the player's display name into the given CharArrayBuffer.

Parameters
dataOut The buffer to load the data into.

public Uri getHiResImageUri ()

Retrieves the URI for loading this player's hi-res profile image. Returns null if the player has no profile image.

To retrieve the Image from the Uri, use ImageManager.

Returns
  • The image URI for the player's hi-res profile image, or null if the player has none.

public Uri getIconImageUri ()

Retrieves the URI for loading this player's icon-size profile image. Returns null if the player has no profile image.

To retrieve the Image from the Uri, use ImageManager.

Returns
  • The image URI for the player's icon-size profile image, or null if the player has none.

public long getLastPlayedWithTimestamp ()

Retrieves the timestamp at which this player last played a multiplayer game with the currently signed in user. If the timestamp is not found, this method returns TIMESTAMP_UNKNOWN.

Returns
  • The timestamp (in ms since epoch) at which the player last played a multiplayer game with the currently signed in user.

public PlayerLevelInfo getLevelInfo ()

Retrieves the player level associated information if any exists. If no level information exists for this player, this method will return null.

Returns

public String getPlayerId ()

Retrieves the ID of this player.

Returns
  • The player ID.

public long getRetrievedTimestamp ()

Retrieves the timestamp at which this player record was last updated locally.

Returns
  • The timestamp (in ms since epoch) at which the player data was last updated locally.

public void getTitle (CharArrayBuffer dataOut)

Loads the player's title into the given CharArrayBuffer.

Parameters
dataOut The buffer to load the data into.

public String getTitle ()

Retrieves the title of the player. This is based on the player's gameplay activity in apps using Google Play Games services. Note that not all players have titles, and that a player's title may change over time.

Returns
  • The player's title, or null if this player has no title.

public boolean hasHiResImage ()

Indicates whether this player has a hi-res profile image to display.

Returns
  • Whether the player has a hi-res profile image to display.

public boolean hasIconImage ()

Indicates whether this player has an icon-size profile image to display.

Returns
  • Whether the player has an icon-size profile image to display.

public int hashCode ()

public boolean isDataValid ()

Check to see if this object is valid for use. If the object is still volatile, this method will indicate whether or not the object can be safely used. The output of a call to freeze() will always be valid.

Returns
  • whether or not the object is valid for use.

public String toString ()

public void writeToParcel (Parcel dest, int flags)