public final class

PlayerEntity

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

Class Overview

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.

Summary

[Expand]
Inherited Constants
From interface android.os.Parcelable
From interface com.google.android.gms.games.Player
Fields
public static final Creator<PlayerEntity> CREATOR
Public Methods
boolean equals(Object obj)
Player freeze()
Freeze a volatile representation into an immutable representation.
Uri getBannerImageLandscapeUri()
Retrieves the URI for loading this player's landscape banner image.
Uri getBannerImagePortraitUri()
Retrieves the URI for loading this player's portrait banner image.
void getDisplayName(CharArrayBuffer dataOut)
Loads the player's display name into the given CharArrayBuffer.
String getDisplayName()
Retrieves the display name for this player.
Uri getHiResImageUri()
Retrieves the URI for loading this player's hi-res profile image.
Uri getIconImageUri()
Retrieves the URI for loading this player's icon-size profile image.
long getLastPlayedWithTimestamp()
Retrieves the timestamp at which this player last played a multiplayer game with the currently signed in user.
PlayerLevelInfo getLevelInfo()
Retrieves the player level associated information if any exists.
String getPlayerId()
Retrieves the ID of this player.
long getRetrievedTimestamp()
Retrieves the timestamp at which this player record was last updated locally.
String getTitle()
Retrieves the title of the player.
void getTitle(CharArrayBuffer dataOut)
Loads the player's title into the given CharArrayBuffer.
boolean hasHiResImage()
Indicates whether this player has a hi-res profile image to display.
boolean hasIconImage()
Indicates whether this player has an icon-size profile image to display.
int hashCode()
boolean isDataValid()
Check to see if this object is valid for use.
String toString()
void writeToParcel(Parcel dest, int flags)
[Expand]
Inherited Methods
From class java.lang.Object
From interface android.os.Parcelable
From interface com.google.android.gms.games.Player
From interface com.google.android.gms.common.data.Freezable

Fields

public static final Creator<PlayerEntity> CREATOR

Public Methods

public boolean equals (Object obj)

Parameters
obj Object
Returns
boolean

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
Player A concrete implementation of the data object.

public Uri getBannerImageLandscapeUri ()

Retrieves the URI for loading this player's landscape banner image. Returns null if the player has no landscape banner image.

To retrieve the Image from the Uri, use ImageManager.

Returns
Uri The image URI for the player's landscape banner image, or null if the player has none.

public Uri getBannerImagePortraitUri ()

Retrieves the URI for loading this player's portrait banner image. Returns null if the player has no portrait banner image.

To retrieve the Image from the Uri, use ImageManager.

Returns
Uri The image URI for the player's portrait banner image, or null if the player has none.

public void getDisplayName (CharArrayBuffer dataOut)

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

Parameters
dataOut CharArrayBuffer: The buffer to load the data into.

public String getDisplayName ()

Retrieves the display name for this player.

Returns
String The player's display name.

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
Uri 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
Uri 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
long 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
PlayerLevelInfo The PlayerLevelInfo associated with this player, if any.

public String getPlayerId ()

Retrieves the ID of this player.

Returns
String The player ID.

public long getRetrievedTimestamp ()

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

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

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
String The player's title, or null if this player has no title.

public void getTitle (CharArrayBuffer dataOut)

Loads the player's title into the given CharArrayBuffer.

Parameters
dataOut CharArrayBuffer: The buffer to load the data into.

public boolean hasHiResImage ()

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

Returns
boolean 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
boolean Whether the player has an icon-size profile image to display.

public int hashCode ()

Returns
int

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
boolean whether or not the object is valid for use.

public String toString ()

Returns
String

public void writeToParcel (Parcel dest, int flags)

Parameters
dest Parcel
flags int