Player

public interfacePlayerimplementsFreezable<Player> Parcelable
Known Indirect Subclasses

Data interface for retrieving player information.

Nested Class Summary

@interface Player.FriendsListVisibilityStatus Friends list visibility statuses.
@interface Player.PlayerFriendStatus Player friend statuses.

Constant Summary

long CURRENT_XP_UNKNOWN Constant indicating that the current XP total for a player is not known.
long TIMESTAMP_UNKNOWN Constant indicating that a timestamp for a player is not known.

Inherited Constant Summary

Public Method Summary

abstractUri
getBannerImageLandscapeUri()
Retrieves the URI for loading this player's landscape banner image.
abstractUri
getBannerImagePortraitUri()
Retrieves the URI for loading this player's portrait banner image.
abstractCurrentPlayerInfo
getCurrentPlayerInfo()
Returns information only available for the signed-in user.
abstract void
getDisplayName(CharArrayBuffer dataOut)
Loads the player's display name into the givenCharArrayBuffer.
abstractString
getDisplayName()
Retrieves the display name for this player.
abstractUri
getHiResImageUri()
Retrieves the URI for loading this player's hi-res profile image.
abstractUri
getIconImageUri()
Retrieves the URI for loading this player's icon-size profile image.
abstract long
getLastPlayedWithTimestamp()
This method is deprecated. Real-time multiplayer and Turn-based multiplayer support is being shut down on March 31, 2020. SeeMultiplayer deprecation
abstractPlayerLevelInfo
getLevelInfo()
Retrieves the player level associated information if any exists.
abstractString
getPlayerId()
Retrieves the ID of this player.
abstractPlayerRelationshipInfo
getRelationshipInfo()
Returns relationship information of this player.
abstract long
getRetrievedTimestamp()
Retrieves the timestamp at which this player record was last updated locally.
abstractString
getTitle()
Retrieves the title of the player.
abstract void
getTitle(CharArrayBuffer dataOut)
Loads the player's title into the givenCharArrayBuffer.
abstract boolean
hasHiResImage()
Indicates whether this player has a hi-res profile image to display.
abstract boolean
hasIconImage()
Indicates whether this player has an icon-size profile image to display.

Inherited Method Summary

Constants

public static final long CURRENT_XP_UNKNOWN

Constant indicating that the current XP total for a player is not known.

Constant Value:-1

public static final long TIMESTAMP_UNKNOWN

Constant indicating that a timestamp for a player is not known.

Constant Value:-1

Public Methods

public abstractUrigetBannerImageLandscapeUri()

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 theUri,use ImageManager.

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

public abstractUrigetBannerImagePortraitUri()

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 theUri,use ImageManager.

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

public abstractCurrentPlayerInfo getCurrentPlayerInfo()

Returns information only available for the signed-in user. The method will return nullfor other players.

public abstract voidgetDisplayName(CharArrayBuffer dataOut)

Loads the player's display name into the givenCharArrayBuffer.

Parameters
dataOut The buffer to load the data into.

public abstractStringgetDisplayName()

Retrieves the display name for this player.

Returns
  • The player's display name.

public abstractUrigetHiResImageUri()

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 theUri,use ImageManager.

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

public abstractUrigetIconImageUri()

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 theUri,use ImageManager.

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

public abstract longgetLastPlayedWithTimestamp()

This method is deprecated.
Real-time multiplayer and Turn-based multiplayer support is being shut down on March 31, 2020. SeeMultiplayer deprecation

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 abstractPlayerLevelInfo getLevelInfo()

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

Returns

public abstractStringgetPlayerId()

Retrieves the ID of this player.

Returns
  • The player ID.

public abstractPlayerRelationshipInfo getRelationshipInfo()

Returns relationship information of this player. If no relationship information exists for this player, this method will returnnull.

public abstract longgetRetrievedTimestamp()

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 abstractStringgetTitle()

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, ornullif this player has no title.

public abstract voidgetTitle(CharArrayBuffer dataOut)

Loads the player's title into the givenCharArrayBuffer.

Parameters
dataOut The buffer to load the data into.

public abstract 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 abstract 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.