Quicknav Quicknav
Links

- Google Play Developer Console
- Android Developers Blog
- About Android

Android Sites

- Android.com
- Android Developers
- Android Open Source Project

close

- - Get Started
  - Style
  - Patterns
  - Building Blocks
  - Downloads
  - Videos
- - Training
  - API Guides
  - Reference
  - Tools
    - Get the SDK
  - Google Services
- - Google Play
  - Publishing
  - Promoting
  - App Quality
  - Spotlight
  - Open Distribution

## Results

Loading...
Summary: Nested Classes | Constants | Methods | Inherited Methods | [Expand All]
public final class

# GamesClient

extends Object
implements GooglePlayServicesClient

java.lang.Object
↳ | com.google.android.gms.games.GamesClient

This class is deprecated.
See `GoogleApiClient` and `Games`.

## Summary

Nested Classes
class | GamesClient.Builder | This class is deprecated. See `GoogleApiClient.Builder`.

Constants
String | EXTRA_EXCLUSIVE_BIT_MASK | Used to bundle the exclusive bit mask of the player for auto-match criteria.
String | EXTRA_INVITATION | Used to return an `Invitation`.
String | EXTRA_MAX_AUTOMATCH_PLAYERS | Used to return the maximum number of players that should be added to a room by auto-matching.
String | EXTRA_MIN_AUTOMATCH_PLAYERS | Used to return the minimum number of players that should be added to a room by auto-matching.
String | EXTRA_PLAYERS | Used to return a list of player IDs.
String | EXTRA_PLAYER_SEARCH_RESULTS | Used by the Player Search UI to return a list of parceled Player objects.
String | EXTRA_ROOM | Used to return a `Room`.
String | EXTRA_TURN_BASED_MATCH | Used to return a `TurnBasedMatch`.
int | MAX_RELIABLE_MESSAGE_LEN | This gives the maximum message size supported via the `sendReliableRealTimeMessage(RealTimeReliableMessageSentListener, byte[], String, String)` methods (excluding protocol headers).
int | MAX_UNRELIABLE_MESSAGE_LEN | This gives the maximum (unfragmented) message size supported via the `sendUnreliableRealTimeMessage(byte[], String, String)` methods (excluding protocol headers).
int | NOTIFICATION_TYPES_ALL | Notification types for any notification.
int | NOTIFICATION_TYPES_MULTIPLAYER | Notification types for multiplayer notifications.
int | NOTIFICATION_TYPE_INVITATION | Notification type for invites to multiplayer games.
int | NOTIFICATION_TYPE_MATCH_UPDATE | Notification type for updates to match information.
int | STATUS_ACHIEVEMENT_NOT_INCREMENTAL | Indicates that the call to increment achievement failed since the achievement is not an incremental achievement.
int | STATUS_ACHIEVEMENT_UNKNOWN | Could not find the achievement, so the operation to update the achievement failed.
int | STATUS_ACHIEVEMENT_UNLOCKED | Indicates that the incremental achievement was also unlocked when the call was made to increment the achievement.
int | STATUS_ACHIEVEMENT_UNLOCK_FAILURE | An incremental achievement cannot be unlocked directly, so the call to unlock achievement failed.
int | STATUS_APP_MISCONFIGURED | The developer has misconfigured their application in some way.
int | STATUS_CLIENT_RECONNECT_REQUIRED | The GamesClient is in an inconsistent state and must reconnect to the service to resolve the issue.
int | STATUS_GAME_NOT_FOUND | The specified game ID was not recognized by the server.
int | STATUS_INTERNAL_ERROR | An unspecified error occurred; no more specific information is available.
int | STATUS_INVALID_REAL_TIME_ROOM_ID | Constant indicating that the real-time room ID provided to the operation was not valid, or does not correspond to the currently active real-time room.
int | STATUS_LICENSE_CHECK_FAILED | The game is not licensed to the user.
int | STATUS_MATCH_ERROR_ALREADY_REMATCHED | The specified match has already had a rematch created.
int | STATUS_MATCH_ERROR_INACTIVE_MATCH | The match is not currently active.
int | STATUS_MATCH_ERROR_INVALID_MATCH_RESULTS | The match results provided in this API call are invalid.
int | STATUS_MATCH_ERROR_INVALID_MATCH_STATE | The match is not in the correct state to perform the specified action.
int | STATUS_MATCH_ERROR_INVALID_PARTICIPANT_STATE | One or more participants in this match are not in valid states.
int | STATUS_MATCH_ERROR_LOCALLY_MODIFIED | The specified match has already been modified locally.
int | STATUS_MATCH_ERROR_OUT_OF_DATE_VERSION | The match data is out of date.
int | STATUS_MATCH_NOT_FOUND | The specified match cannot be found.
int | STATUS_MULTIPLAYER_DISABLED | This game does not support multiplayer.
int | STATUS_MULTIPLAYER_ERROR_CREATION_NOT_ALLOWED | The user is not allowed to create a new multiplayer game at this time.
int | STATUS_MULTIPLAYER_ERROR_INVALID_MULTIPLAYER_TYPE | The match is not the right type to perform this action on.
int | STATUS_MULTIPLAYER_ERROR_INVALID_OPERATION | This multiplayer operation is not valid, and the server rejected it.
int | STATUS_MULTIPLAYER_ERROR_NOT_TRUSTED_TESTER | The user attempted to invite another user who was not authorized to see the game.
int | STATUS_NETWORK_ERROR_NO_DATA | A network error occurred while attempting to retrieve fresh data, and no data was available locally.
int | STATUS_NETWORK_ERROR_OPERATION_DEFERRED | A network error occurred while attempting to modify data, but the data was successfully modified locally and will be updated on the network the next time the device is able to sync.
int | STATUS_NETWORK_ERROR_OPERATION_FAILED | A network error occurred while attempting to perform an operation that requires network access.
int | STATUS_NETWORK_ERROR_STALE_DATA | A network error occurred while attempting to retrieve fresh data, but some locally cached data was available.
int | STATUS_OK | The operation was successful.
int | STATUS_OPERATION_IN_FLIGHT | Trying to start a join/create operation while another is already in flight.
int | STATUS_PARTICIPANT_NOT_CONNECTED | Constant indicating that the ID of the participant provided by the user is not currently connected to the client in the real-time room.
int | STATUS_REAL_TIME_CONNECTION_FAILED | Failed to initialize the network connection for a real-time room.
int | STATUS_REAL_TIME_INACTIVE_ROOM | The room is not currently active.
int | STATUS_REAL_TIME_MESSAGE_FAILED | Status code returned from the `sendUnreliableRealTimeMessage(byte[], String, String)` and `sendReliableRealTimeMessage(RealTimeReliableMessageSentListener, byte[], String, String)` methods when the message send operation failed due to an immediate error.
int | STATUS_REAL_TIME_MESSAGE_SEND_FAILED | Failed to send message to the peer participant for a real-time room.
int | STATUS_REAL_TIME_ROOM_NOT_JOINED | Failed to send message to the peer participant for a real-time room, since the user has not joined the room.

Public Methods
void | acceptTurnBasedInvitation(OnTurnBasedMatchInitiatedListener listener, String invitationId) This method is deprecated. See `acceptInvitation(GoogleApiClient, String)`
void | cancelTurnBasedMatch(String matchId) This method is deprecated. See `cancelMatch(GoogleApiClient, String)`
void | cancelTurnBasedMatch(OnTurnBasedMatchCanceledListener listener, String matchId) This method is deprecated. See `cancelMatch(GoogleApiClient, String)`
void | clearAllNotifications() This method is deprecated. See `clearAll(GoogleApiClient)`
void | clearNotifications(int notificationTypes) This method is deprecated. See `clear(GoogleApiClient, int)`
void | connect() This method is deprecated. See `connect()`.
void | createRoom(RoomConfig config) This method is deprecated. See `create(GoogleApiClient, RoomConfig)`
void | createTurnBasedMatch(OnTurnBasedMatchInitiatedListener listener, TurnBasedMatchConfig config) This method is deprecated. See `createMatch(GoogleApiClient, TurnBasedMatchConfig)`
void | declineRoomInvitation(String invitationId) This method is deprecated. See `declineInvitation(GoogleApiClient, String)`
void | declineTurnBasedInvitation(String invitationId) This method is deprecated. See `declineInvitation(GoogleApiClient, String)`
void | disconnect() This method is deprecated. See `disconnect()`.
void | dismissRoomInvitation(String invitationId) This method is deprecated. See `dismissInvitation(GoogleApiClient, String)`
void | dismissTurnBasedInvitation(String invitationId) This method is deprecated. See `dismissInvitation(GoogleApiClient, String)`
void | dismissTurnBasedMatch(String matchId) This method is deprecated. See `dismissMatch(GoogleApiClient, String)`
void | finishTurnBasedMatch(OnTurnBasedMatchUpdatedListener listener, String matchId, byte[] matchData, List<ParticipantResult> results) This method is deprecated. See `finishMatch(GoogleApiClient, String, byte[], java.util.List)`
void | finishTurnBasedMatch(OnTurnBasedMatchUpdatedListener listener, String matchId) This method is deprecated. See `finishMatch(GoogleApiClient, String)`
void | finishTurnBasedMatch(OnTurnBasedMatchUpdatedListener listener, String matchId, byte[] matchData, ParticipantResult... results) This method is deprecated. See `finishMatch(GoogleApiClient, String, byte[], ParticipantResult[])`
Intent | getAchievementsIntent() This method is deprecated. See `getAchievementsIntent(GoogleApiClient)`
Intent | getAllLeaderboardsIntent() This method is deprecated. See `getAllLeaderboardsIntent(GoogleApiClient)`.
String | getAppId() This method is deprecated. See `getAppId(GoogleApiClient)`
String | getCurrentAccountName() This method is deprecated. See `getCurrentAccountName(GoogleApiClient)`.
Game | getCurrentGame() This method is deprecated. See `getCurrentGame(GoogleApiClient)`.
Player | getCurrentPlayer() This method is deprecated. See `getCurrentPlayer(GoogleApiClient)`.
String | getCurrentPlayerId() This method is deprecated. See `getCurrentPlayerId(GoogleApiClient)`.
Intent | getInvitationInboxIntent() This method is deprecated. See `getInvitationInboxIntent(GoogleApiClient)`
Intent | getLeaderboardIntent(String leaderboardId) This method is deprecated. See `getLeaderboardIntent(GoogleApiClient, String)`.
Intent | getMatchInboxIntent() This method is deprecated. See `getInboxIntent(GoogleApiClient)`
int | getMaxTurnBasedMatchDataSize() This method is deprecated. See `getMaxMatchDataSize(GoogleApiClient)`
Intent | getPlayerSearchIntent() This method is deprecated. See `getPlayerSearchIntent(GoogleApiClient)`
Intent | getRealTimeSelectOpponentsIntent(int minPlayers, int maxPlayers, boolean allowAutomatch) This method is deprecated. See `getSelectOpponentsIntent(GoogleApiClient, int, int, boolean)`
Intent | getRealTimeSelectOpponentsIntent(int minPlayers, int maxPlayers) This method is deprecated. See `getSelectOpponentsIntent(GoogleApiClient, int, int)`
RealTimeSocket | getRealTimeSocketForParticipant(String roomId, String participantId) This method is deprecated. See `getSocketForParticipant(GoogleApiClient, String, String)`
Intent | getRealTimeWaitingRoomIntent(Room room, int minParticipantsToStart) This method is deprecated. See `getWaitingRoomIntent(GoogleApiClient, Room, int)`
Intent | getSettingsIntent() This method is deprecated. See `getSettingsIntent(GoogleApiClient)`
void | getTurnBasedMatch(OnTurnBasedMatchLoadedListener listener, String matchId) This method is deprecated. See `loadMatch(GoogleApiClient, String)`
Intent | getTurnBasedSelectOpponentsIntent(int minPlayers, int maxPlayers, boolean allowAutomatch) This method is deprecated. See `getSelectOpponentsIntent(GoogleApiClient, int, int, boolean)`
Intent | getTurnBasedSelectOpponentsIntent(int minPlayers, int maxPlayers) This method is deprecated. See `getSelectOpponentsIntent(GoogleApiClient, int, int)`
void | incrementAchievement(String id, int numSteps) This method is deprecated. See `increment(GoogleApiClient, String, int)`
void | incrementAchievementImmediate(OnAchievementUpdatedListener listener, String id, int numSteps) This method is deprecated. See `incrementImmediate(GoogleApiClient, String, int)`
boolean | isConnected() This method is deprecated. See `isConnected()`.
boolean | isConnecting() This method is deprecated. See `isConnecting()`.
boolean | isConnectionCallbacksRegistered(GooglePlayServicesClient.ConnectionCallbacks listener) This method is deprecated. See `isConnectionCallbacksRegistered(GoogleApiClient.ConnectionCallbacks)`.
boolean | isConnectionFailedListenerRegistered(GooglePlayServicesClient.OnConnectionFailedListener listener) This method is deprecated. See `isConnectionFailedListenerRegistered(GoogleApiClient.OnConnectionFailedListener)`.
void | joinRoom(RoomConfig config) This method is deprecated. See `join(GoogleApiClient, RoomConfig)`
void | leaveRoom(RoomUpdateListener listener, String roomId) This method is deprecated. See `leave(GoogleApiClient, RoomUpdateListener, String)`
void | leaveTurnBasedMatch(OnTurnBasedMatchLeftListener listener, String matchId) This method is deprecated. See `leaveMatch(GoogleApiClient, String)`
void | leaveTurnBasedMatchDuringTurn(OnTurnBasedMatchLeftListener listener, String matchId, String pendingParticipantId) This method is deprecated. See `leaveMatchDuringTurn(GoogleApiClient, String, String)`
void | loadAchievements(OnAchievementsLoadedListener listener, boolean forceReload) This method is deprecated. See `load(GoogleApiClient, boolean)`
void | loadCurrentPlayerLeaderboardScore(OnPlayerLeaderboardScoreLoadedListener listener, String leaderboardId, int span, int leaderboardCollection) This method is deprecated. See `loadCurrentPlayerLeaderboardScore(GoogleApiClient, String, int, int)`
void | loadGame(OnGamesLoadedListener listener) This method is deprecated. See `loadGame(GoogleApiClient)`
void | loadInvitablePlayers(OnPlayersLoadedListener listener, int pageSize, boolean forceReload) This method is deprecated. See `loadInvitablePlayers(GoogleApiClient, int, boolean)`.
void | loadInvitations(OnInvitationsLoadedListener listener) This method is deprecated. See `loadInvitations(GoogleApiClient)`
void | loadLeaderboardMetadata(OnLeaderboardMetadataLoadedListener listener, boolean forceReload) This method is deprecated. See `loadLeaderboardMetadata(GoogleApiClient, boolean)`.
void | loadLeaderboardMetadata(OnLeaderboardMetadataLoadedListener listener, String leaderboardId, boolean forceReload) This method is deprecated. See `loadLeaderboardMetadata(GoogleApiClient, String, boolean)`
void | loadMoreInvitablePlayers(OnPlayersLoadedListener listener, int pageSize) This method is deprecated. See `loadMoreInvitablePlayers(GoogleApiClient, int)`.
void | loadMoreScores(OnLeaderboardScoresLoadedListener listener, LeaderboardScoreBuffer buffer, int maxResults, int pageDirection) This method is deprecated. See `loadMoreScores(GoogleApiClient, LeaderboardScoreBuffer, int, int)`
void | loadPlayer(OnPlayersLoadedListener listener, String playerId) This method is deprecated. See `loadPlayer(GoogleApiClient, String)`.
void | loadPlayerCenteredScores(OnLeaderboardScoresLoadedListener listener, String leaderboardId, int span, int leaderboardCollection, int maxResults, boolean forceReload) This method is deprecated. See `loadPlayerCenteredScores(GoogleApiClient, String, int, int, int, boolean)`
void | loadPlayerCenteredScores(OnLeaderboardScoresLoadedListener listener, String leaderboardId, int span, int leaderboardCollection, int maxResults) This method is deprecated. See `loadPlayerCenteredScores(GoogleApiClient, String, int, int, int)`
void | loadTopScores(OnLeaderboardScoresLoadedListener listener, String leaderboardId, int span, int leaderboardCollection, int maxResults) This method is deprecated. See `loadTopScores(GoogleApiClient, String, int, int, int)`
void | loadTopScores(OnLeaderboardScoresLoadedListener listener, String leaderboardId, int span, int leaderboardCollection, int maxResults, boolean forceReload) This method is deprecated. See `loadTopScores(GoogleApiClient, String, int, int, int, boolean)`
void | loadTurnBasedMatches(OnTurnBasedMatchesLoadedListener listener, int... matchTurnStatuses) This method is deprecated. See `loadMatchesByStatus(GoogleApiClient, int[])`
void | reconnect() This method is deprecated. See `reconnect()`
void | registerConnectionCallbacks(GooglePlayServicesClient.ConnectionCallbacks listener) This method is deprecated. See `registerConnectionCallbacks(GoogleApiClient.ConnectionCallbacks)`.
void | registerConnectionFailedListener(GooglePlayServicesClient.OnConnectionFailedListener listener) This method is deprecated. See `registerConnectionFailedListener(GoogleApiClient.OnConnectionFailedListener)`.
void | registerInvitationListener(OnInvitationReceivedListener listener) This method is deprecated. See `registerInvitationListener(GoogleApiClient, OnInvitationReceivedListener)`
void | registerMatchUpdateListener(OnTurnBasedMatchUpdateReceivedListener listener) This method is deprecated. See `registerMatchUpdateListener(GoogleApiClient, OnTurnBasedMatchUpdateReceivedListener)`
void | rematchTurnBasedMatch(OnTurnBasedMatchInitiatedListener listener, String matchId) This method is deprecated. See `rematch(GoogleApiClient, String)`
void | revealAchievement(String id) This method is deprecated. See `reveal(GoogleApiClient, String)`
void | revealAchievementImmediate(OnAchievementUpdatedListener listener, String id) This method is deprecated. See `revealImmediate(GoogleApiClient, String)`
int | sendReliableRealTimeMessage(RealTimeReliableMessageSentListener listener, byte[] messageData, String roomId, String recipientParticipantId) This method is deprecated. See `sendReliableMessage(GoogleApiClient, ReliableMessageSentCallback, byte[], String, String)`
int | sendUnreliableRealTimeMessage(byte[] messageData, String roomId, List<String> recipientParticipantIds) This method is deprecated. See `sendUnreliableMessage(GoogleApiClient, byte[], String, java.util.List)`
int | sendUnreliableRealTimeMessage(byte[] messageData, String roomId, String recipientParticipantId) This method is deprecated. See `sendUnreliableMessage(GoogleApiClient, byte[], String, String)`
int | sendUnreliableRealTimeMessageToAll(byte[] messageData, String roomId) This method is deprecated. See `sendUnreliableMessageToAll(GoogleApiClient, byte[], String)`
void | setAchievementSteps(String id, int numSteps) This method is deprecated. See `setSteps(GoogleApiClient, String, int)`
void | setAchievementStepsImmediate(OnAchievementUpdatedListener listener, String id, int numSteps) This method is deprecated. See `setStepsImmediate(GoogleApiClient, String, int)`
void | setGravityForPopups(int gravity) This method is deprecated. See `setGravityForPopups(GoogleApiClient, int)`.
void | setViewForPopups(View gamesContentView) This method is deprecated. See `setViewForPopups(GoogleApiClient, View)`.
void | signOut(OnSignOutCompleteListener listener) This method is deprecated. See `signOut(GoogleApiClient)`
void | signOut() This method is deprecated. See `signOut(GoogleApiClient)`
void | submitScore(String leaderboardId, long score, String scoreTag) This method is deprecated. See `submitScore(GoogleApiClient, String, long, String)`
void | submitScore(String leaderboardId, long score) This method is deprecated. See `submitScore(GoogleApiClient, String, long)`
void | submitScoreImmediate(OnScoreSubmittedListener listener, String leaderboardId, long score, String scoreTag) This method is deprecated. See `submitScoreImmediate(GoogleApiClient, String, long, String)`
void | submitScoreImmediate(OnScoreSubmittedListener listener, String leaderboardId, long score) This method is deprecated. See `submitScoreImmediate(GoogleApiClient, String, long)`
void | takeTurn(OnTurnBasedMatchUpdatedListener listener, String matchId, byte[] matchData, String pendingParticipantId) This method is deprecated. See `takeTurn(GoogleApiClient, String, byte[], String)`
void | takeTurn(OnTurnBasedMatchUpdatedListener listener, String matchId, byte[] matchData, String pendingParticipantId, ParticipantResult... results) This method is deprecated. See `takeTurn(GoogleApiClient, String, byte[], String, ParticipantResult[])`
void | takeTurn(OnTurnBasedMatchUpdatedListener listener, String matchId, byte[] matchData, String pendingParticipantId, List<ParticipantResult> results) This method is deprecated. See `takeTurn(GoogleApiClient, String, byte[], String, java.util.List)`
void | unlockAchievement(String id) This method is deprecated. See `unlock(GoogleApiClient, String)`
void | unlockAchievementImmediate(OnAchievementUpdatedListener listener, String id) This method is deprecated. See `unlockImmediate(GoogleApiClient, String)`
void | unregisterConnectionCallbacks(GooglePlayServicesClient.ConnectionCallbacks listener) This method is deprecated. See `unregisterConnectionCallbacks(GoogleApiClient.ConnectionCallbacks)`.
void | unregisterConnectionFailedListener(GooglePlayServicesClient.OnConnectionFailedListener listener) This method is deprecated. See `unregisterConnectionFailedListener(GoogleApiClient.OnConnectionFailedListener)`.
void | unregisterInvitationListener() This method is deprecated. See `unregisterInvitationListener(GoogleApiClient)`
void | unregisterMatchUpdateListener() This method is deprecated. See `unregisterMatchUpdateListener(GoogleApiClient)`

[Expand] Inherited Methods

From class java.lang.Object

Object | clone()
boolean | equals(Object arg0)
void | finalize()
final Class<?> | getClass()
int | hashCode()
final void | notify()
final void | notifyAll()
String | toString()
final void | wait()
final void | wait(long arg0, int arg1)
final void | wait(long arg0)

From interface com.google.android.gms.common.GooglePlayServicesClient

abstract void | connect() Connects the client to Google Play services.
abstract void | disconnect() Closes the connection to Google Play services.
abstract boolean | isConnected() Checks if the client is currently connected to the service, so that requests to other methods will succeed.
abstract boolean | isConnecting() Checks if the client is attempting to connect to the service.
abstract boolean | isConnectionCallbacksRegistered(GooglePlayServicesClient.ConnectionCallbacks listener) Returns true if the specified listener is currently registered to receive connection events.
abstract boolean | isConnectionFailedListenerRegistered(GooglePlayServicesClient.OnConnectionFailedListener listener) Returns true if the specified listener is currently registered to receive connection failed events.
abstract void | registerConnectionCallbacks(GooglePlayServicesClient.ConnectionCallbacks listener) Registers a listener to receive connection events from this `GooglePlayServicesClient`.
abstract void | registerConnectionFailedListener(GooglePlayServicesClient.OnConnectionFailedListener listener) Registers a listener to receive connection failed events from this `GooglePlayServicesClient`.
abstract void | unregisterConnectionCallbacks(GooglePlayServicesClient.ConnectionCallbacks listener) Removes a connection listener from this `GooglePlayServicesClient`.
abstract void | unregisterConnectionFailedListener(GooglePlayServicesClient.OnConnectionFailedListener listener) Removes a connection failed listener from the `GooglePlayServicesClient`.

## Constants

#### public static final String EXTRA_EXCLUSIVE_BIT_MASK

Used to bundle the exclusive bit mask of the player for auto-match criteria.

Constant Value: "exclusive_bit_mask"

#### public static final String EXTRA_INVITATION

Used to return an `Invitation`. Retrieve with `getParcelableExtra(String)` or `getParcelable(String)`.

Constant Value: "invitation"

#### public static final String EXTRA_MAX_AUTOMATCH_PLAYERS

Used to return the maximum number of players that should be added to a room by auto-matching. Retrieve with `getIntExtra(String, int)`.

##### See Also

- `getRealTimeSelectOpponentsIntent(int, int)`
- `getTurnBasedSelectOpponentsIntent(int, int)`

Constant Value: "max_automatch_players"

#### public static final String EXTRA_MIN_AUTOMATCH_PLAYERS

Used to return the minimum number of players that should be added to a room by auto-matching. Retrieve with `getIntExtra(String, int)`.

##### See Also

- `getRealTimeSelectOpponentsIntent(int, int)`
- `getTurnBasedSelectOpponentsIntent(int, int)`

Constant Value: "min_automatch_players"

#### public static final String EXTRA_PLAYERS

Used to return a list of player IDs. Retrieve with `getStringArrayListExtra(String)`.

##### See Also

- `getRealTimeSelectOpponentsIntent(int, int)`
- `getTurnBasedSelectOpponentsIntent(int, int)`

Constant Value: "players"

#### public static final String EXTRA_PLAYER_SEARCH_RESULTS

Used by the Player Search UI to return a list of parceled Player objects. Retrieve with `getParcelableArrayListExtra(String)`.

##### See Also

- `getPlayerSearchIntent()`

Constant Value: "player_search_results"

#### public static final String EXTRA_ROOM

Used to return a `Room`. Retrieve with `getParcelableExtra(String)`.

Constant Value: "room"

#### public static final String EXTRA_TURN_BASED_MATCH

Used to return a `TurnBasedMatch`. Retrieve with `getParcelableExtra(String)` or `getParcelable(String)`.

Constant Value: "turn_based_match"

#### public static final int MAX_RELIABLE_MESSAGE_LEN

This gives the maximum message size supported via the `sendReliableRealTimeMessage(RealTimeReliableMessageSentListener, byte[], String, String)` methods (excluding protocol headers).

Constant Value: 1400 (0x00000578)

#### public static final int MAX_UNRELIABLE_MESSAGE_LEN

This gives the maximum (unfragmented) message size supported via the `sendUnreliableRealTimeMessage(byte[], String, String)` methods (excluding protocol headers).

Constant Value: 1168 (0x00000490)

#### public static final int NOTIFICATION_TYPES_ALL

Notification types for any notification.

Constant Value: -1 (0xffffffff)

#### public static final int NOTIFICATION_TYPES_MULTIPLAYER

Notification types for multiplayer notifications.

Constant Value: 3 (0x00000003)

#### public static final int NOTIFICATION_TYPE_INVITATION

Notification type for invites to multiplayer games.

Constant Value: 1 (0x00000001)

#### public static final int NOTIFICATION_TYPE_MATCH_UPDATE

Notification type for updates to match information.

Constant Value: 2 (0x00000002)

#### public static final int STATUS_ACHIEVEMENT_NOT_INCREMENTAL

Indicates that the call to increment achievement failed since the achievement is not an incremental achievement.

Constant Value: 3002 (0x00000bba)

#### public static final int STATUS_ACHIEVEMENT_UNKNOWN

Could not find the achievement, so the operation to update the achievement failed.

Constant Value: 3001 (0x00000bb9)

#### public static final int STATUS_ACHIEVEMENT_UNLOCKED

Indicates that the incremental achievement was also unlocked when the call was made to increment the achievement.

Constant Value: 3003 (0x00000bbb)

#### public static final int STATUS_ACHIEVEMENT_UNLOCK_FAILURE

An incremental achievement cannot be unlocked directly, so the call to unlock achievement failed.

Constant Value: 3000 (0x00000bb8)

#### public static final int STATUS_APP_MISCONFIGURED

The developer has misconfigured their application in some way. The logs will contain more data about the error and the appropriate resolution.

Constant Value: 8 (0x00000008)

#### public static final int STATUS_CLIENT_RECONNECT_REQUIRED

The GamesClient is in an inconsistent state and must reconnect to the service to resolve the issue. Further calls to the service using the current connection are unlikely to succeed.

Constant Value: 2 (0x00000002)

#### public static final int STATUS_GAME_NOT_FOUND

The specified game ID was not recognized by the server.

Constant Value: 9 (0x00000009)

#### public static final int STATUS_INTERNAL_ERROR

An unspecified error occurred; no more specific information is available. The device logs may provide additional data.

Constant Value: 1 (0x00000001)

#### public static final int STATUS_INVALID_REAL_TIME_ROOM_ID

Constant indicating that the real-time room ID provided to the operation was not valid, or does not correspond to the currently active real-time room.

Constant Value: 7002 (0x00001b5a)

#### public static final int STATUS_LICENSE_CHECK_FAILED

The game is not licensed to the user. Further calls will return the same code.

Constant Value: 7 (0x00000007)

#### public static final int STATUS_MATCH_ERROR_ALREADY_REMATCHED

The specified match has already had a rematch created. Only one rematch may be created for any initial match.

Constant Value: 6505 (0x00001969)

#### public static final int STATUS_MATCH_ERROR_INACTIVE_MATCH

The match is not currently active. This action cannot be performed on an inactive match.

Constant Value: 6501 (0x00001965)

#### public static final int STATUS_MATCH_ERROR_INVALID_MATCH_RESULTS

The match results provided in this API call are invalid. This covers cases of duplicate results, results for players who are not in the match, etc.

Constant Value: 6504 (0x00001968)

#### public static final int STATUS_MATCH_ERROR_INVALID_MATCH_STATE

The match is not in the correct state to perform the specified action.

Constant Value: 6502 (0x00001966)

#### public static final int STATUS_MATCH_ERROR_INVALID_PARTICIPANT_STATE

One or more participants in this match are not in valid states. This could occur if a specified participant is not actually a participant of the match, or is invalid, or is in an incorrect state to make the API call. Check the logs for more detailed information.

Constant Value: 6500 (0x00001964)

#### public static final int STATUS_MATCH_ERROR_LOCALLY_MODIFIED

The specified match has already been modified locally. This operation cannot be performed until the match has been sent to the server.

Constant Value: 6507 (0x0000196b)

#### public static final int STATUS_MATCH_ERROR_OUT_OF_DATE_VERSION

The match data is out of date. Someone else has modified the data on the server, so the request could not be completed safely.

Constant Value: 6503 (0x00001967)

#### public static final int STATUS_MATCH_NOT_FOUND

The specified match cannot be found. The provided match ID does not correspond to any known match.

Constant Value: 6506 (0x0000196a)

#### public static final int STATUS_MULTIPLAYER_DISABLED

This game does not support multiplayer. This could occur if the linked app is not configured appropriately in the developer console.

Constant Value: 6003 (0x00001773)

#### public static final int STATUS_MULTIPLAYER_ERROR_CREATION_NOT_ALLOWED

The user is not allowed to create a new multiplayer game at this time. This could occur if the user has too many outstanding invitations already.

Constant Value: 6000 (0x00001770)

#### public static final int STATUS_MULTIPLAYER_ERROR_INVALID_MULTIPLAYER_TYPE

The match is not the right type to perform this action on. For example, this error will be returned when trying to take a turn in a real-time match.

Constant Value: 6002 (0x00001772)

#### public static final int STATUS_MULTIPLAYER_ERROR_INVALID_OPERATION

This multiplayer operation is not valid, and the server rejected it. Check the logs for more information.

Constant Value: 6004 (0x00001774)

#### public static final int STATUS_MULTIPLAYER_ERROR_NOT_TRUSTED_TESTER

The user attempted to invite another user who was not authorized to see the game. This can occur if a trusted tester invites a user who is not a trusted tester while the game is unpublished. In this case, the invitations will not be sent.

Constant Value: 6001 (0x00001771)

#### public static final int STATUS_NETWORK_ERROR_NO_DATA

A network error occurred while attempting to retrieve fresh data, and no data was available locally.

Constant Value: 4 (0x00000004)

#### public static final int STATUS_NETWORK_ERROR_OPERATION_DEFERRED

A network error occurred while attempting to modify data, but the data was successfully modified locally and will be updated on the network the next time the device is able to sync.

Constant Value: 5 (0x00000005)

#### public static final int STATUS_NETWORK_ERROR_OPERATION_FAILED

A network error occurred while attempting to perform an operation that requires network access. The operation may be retried later.

Constant Value: 6 (0x00000006)

#### public static final int STATUS_NETWORK_ERROR_STALE_DATA

A network error occurred while attempting to retrieve fresh data, but some locally cached data was available. The data returned may be stale and/or incomplete.

Constant Value: 3 (0x00000003)

#### public static final int STATUS_OK

The operation was successful.

Constant Value: 0 (0x00000000)

#### public static final int STATUS_OPERATION_IN_FLIGHT

Trying to start a join/create operation while another is already in flight.

Constant Value: 7007 (0x00001b5f)

#### public static final int STATUS_PARTICIPANT_NOT_CONNECTED

Constant indicating that the ID of the participant provided by the user is not currently connected to the client in the real-time room.

Constant Value: 7003 (0x00001b5b)

#### public static final int STATUS_REAL_TIME_CONNECTION_FAILED

Failed to initialize the network connection for a real-time room.

Constant Value: 7000 (0x00001b58)

#### public static final int STATUS_REAL_TIME_INACTIVE_ROOM

The room is not currently active. This action cannot be performed on an inactive room.

Constant Value: 7005 (0x00001b5d)

#### public static final int STATUS_REAL_TIME_MESSAGE_FAILED

Status code returned from the `sendUnreliableRealTimeMessage(byte[], String, String)` and `sendReliableRealTimeMessage(RealTimeReliableMessageSentListener, byte[], String, String)` methods when the message send operation failed due to an immediate error.

Constant Value: -1 (0xffffffff)

#### public static final int STATUS_REAL_TIME_MESSAGE_SEND_FAILED

Failed to send message to the peer participant for a real-time room.

Constant Value: 7001 (0x00001b59)

#### public static final int STATUS_REAL_TIME_ROOM_NOT_JOINED

Failed to send message to the peer participant for a real-time room, since the user has not joined the room.

Constant Value: 7004 (0x00001b5c)

## Public Methods

#### public void acceptTurnBasedInvitation (OnTurnBasedMatchInitiatedListener listener, String invitationId)

This method is deprecated.
See `acceptInvitation(GoogleApiClient, String)`

Accept an invitation for a turn-based match.

##### Parameters

listener | The listener that is called when the match has been accepted. The listener is called on the main thread.
invitationId | The ID of the invitation to be accepted.

#### public void cancelTurnBasedMatch (String matchId)

This method is deprecated.
See `cancelMatch(GoogleApiClient, String)`

Cancels a turn-based match. Once this call succeeds, the match will be removed from local storage. Note that this will cancel the match completely, forcing it to end for all players involved. See `leaveTurnBasedMatch(OnTurnBasedMatchLeftListener, String)` for a different alternative.

##### Parameters

matchId | The ID of the match to cancel.

#### public void cancelTurnBasedMatch (OnTurnBasedMatchCanceledListener listener, String matchId)

This method is deprecated.
See `cancelMatch(GoogleApiClient, String)`

Cancels a turn-based match. Once this call succeeds, the match will be removed from local storage. Note that this will cancel the match completely, forcing it to end for all players involved. See `leaveTurnBasedMatch(OnTurnBasedMatchLeftListener, String)` for a different alternative.

##### Parameters

listener | The listener that is called after the match has been canceled. The listener is called on the main thread.
matchId | The ID of the match to cancel.

#### public void clearAllNotifications ()

This method is deprecated.
See `clearAll(GoogleApiClient)`

Clear all notifications for the current game and signed-in player.

#### public void clearNotifications (int notificationTypes)

This method is deprecated.
See `clear(GoogleApiClient, int)`

Clear the notifications of the specified type for the current game and signed-in player. This should be a mask comprised of values from the constants `NOTIFICATION_TYPE_INVITATION`, `NOTIFICATION_TYPES_MULTIPLAYER`, and `NOTIFICATION_TYPES_ALL`.

##### Parameters

notificationTypes | Mask of notification types to clear.

#### public void connect ()

This method is deprecated.
See `connect()`.

Connect to the games service.

This method should be called from `onStart()` or `onStart()`.

This method will return immediately, and `onConnected(Bundle)` will be called if the connection is successful.

The Bundle provided to `onConnected` may be null. If not null, it can contain the following keys:

- `EXTRA_INVITATION` if the user wanted to accept an invitation to a multiplayer game. The value contained here is an `Invitation` which can be accessed with `getParcelable(String)`.
- `EXTRA_TURN_BASED_MATCH` if the user wanted to take action in a turn-based match. The value contained here is a `TurnBasedMatch` which can be accessed with `getParcelable(String)`.

##### See Also

- `connect()`

#### public void createRoom (RoomConfig config)

This method is deprecated.
See `create(GoogleApiClient, RoomConfig)`

Create a real-time room for the current game. The lifetime of the current game's connection to the room is bound to this `GamesClient`'s lifecycle. When the client disconnects, the player will leave the room and any peer-to-peer connections for this player will be torn down. The result is delivered by the callback `onRoomCreated(int, Room)` to the given RoomUpdateListener in the `RoomConfig`. The listener is called on the main thread.

##### Parameters

config | The real-time room configuration.

#### public void createTurnBasedMatch (OnTurnBasedMatchInitiatedListener listener, TurnBasedMatchConfig config)

This method is deprecated.
See `createMatch(GoogleApiClient, TurnBasedMatchConfig)`

Create a turn-based match for the current game.

##### Parameters

listener | The listener that is called when the match has been created. The listener is called on the main thread.
config | The configuration parameters for the match to create.

##### See Also

- `TurnBasedMatchConfig`

#### public void declineRoomInvitation (String invitationId)

This method is deprecated.
See `declineInvitation(GoogleApiClient, String)`

Decline an invitation for a real-time room.

##### Parameters

invitationId | The ID of the invitation to decline.

#### public void declineTurnBasedInvitation (String invitationId)

This method is deprecated.
See `declineInvitation(GoogleApiClient, String)`

Decline an invitation for a turn-based match.

##### Parameters

invitationId | The ID of the invitation to decline.

#### public void disconnect ()

This method is deprecated.
See `disconnect()`.

Closes the connection to Google Play services. No calls can be made on this object after calling this method.

#### public void dismissRoomInvitation (String invitationId)

This method is deprecated.
See `dismissInvitation(GoogleApiClient, String)`

Dismiss an invitation to a real-time room. Dismissing an invitation will not change the state of the room for the other participants.

##### Parameters

invitationId | The ID of the invitation to dismiss.

#### public void dismissTurnBasedInvitation (String invitationId)

This method is deprecated.
See `dismissInvitation(GoogleApiClient, String)`

Dismiss an invitation to a turn-based match. Dismissing an invitation will not change the state of the match for the other participants.

##### Parameters

invitationId | The ID of the invitation to dismiss.

#### public void dismissTurnBasedMatch (String matchId)

This method is deprecated.
See `dismissMatch(GoogleApiClient, String)`

Delete a match from the server and local storage. Dismissing a match will not change the state of the match for the other participants, but dismissed matches will never be shown to the dismissing player again.

##### Parameters

matchId | The ID of the match to dismiss.

#### public void finishTurnBasedMatch (OnTurnBasedMatchUpdatedListener listener, String matchId, byte[] matchData, List<ParticipantResult> results)

This method is deprecated.
See `finishMatch(GoogleApiClient, String, byte[], java.util.List)`

Mark a match as finished. This should be called when the match is over and all participants have results to be reported (if appropriate). Note that the last client to update a match is responsible for calling finish on that match.

##### Parameters

listener | The listener that is called when the match has been updated. The listener is called on the main thread.
matchId | ID of the match to finish.
matchData | Data representing the new state of the match after this update. Limited to a maximum of `getMaxTurnBasedMatchDataSize()` bytes.
results | List of `ParticipantResult` objects for this match. The client which calls `finishMatch` is responsible for reporting the results for all appropriate participants in the match. Not every participant is required to have a result, but providing results for participants who are not in the match is an error.

#### public void finishTurnBasedMatch (OnTurnBasedMatchUpdatedListener listener, String matchId)

This method is deprecated.
See `finishMatch(GoogleApiClient, String)`

Indicate that a participant is finished with a match. This will not change the data of the match, but it will transition the match into state `MATCH_STATUS_COMPLETE` if the match is not already in that state. This method is most commonly used to report that a participant has finished any post-processing steps the game might have and has seen their results in the match.

##### Parameters

listener | The listener that is called when the match has been updated. The listener is called on the main thread.
matchId | ID of the match to finish.

#### public void finishTurnBasedMatch (OnTurnBasedMatchUpdatedListener listener, String matchId, byte[] matchData, ParticipantResult... results)

This method is deprecated.
See `finishMatch(GoogleApiClient, String, byte[], ParticipantResult[])`

Mark a match as finished. This should be called when the match is over and all participants have results to be reported (if appropriate). Note that the last client to update a match is responsible for calling finish on that match.

On the last turn of the match, the client should call this method instead of `takeTurn(OnTurnBasedMatchUpdatedListener, String, byte[], String)`.

##### Parameters

listener | The listener that is called when the match has been updated. The listener is called on the main thread.
matchId | ID of the match to finish.
matchData | Data representing the new state of the match after this update. Limited to a maximum of `getMaxTurnBasedMatchDataSize()` bytes.
results | List of `ParticipantResult` objects for this match. The client which calls `finishMatch` is responsible for reporting the results for all appropriate participants in the match. Not every participant is required to have a result, but providing results for participants who are not in the match is an error.

##### See Also

- `takeTurn(OnTurnBasedMatchUpdatedListener, String, byte[], String)`

#### public Intent getAchievementsIntent ()

This method is deprecated.
See `getAchievementsIntent(GoogleApiClient)`

Gets an intent to show the list of achievements for a game. Note that this must be invoked with `startActivityForResult(Intent, int)`, so that the identity of the calling package can be established.

A `RESULT_RECONNECT_REQUIRED` may be returned as the resultCode in `onActivityResult(int, int, Intent)` if the GamesClient ends up in an inconsistent state.

##### Returns

- An `Intent` that can be started to view the currently signed in player's achievements.

#### public Intent getAllLeaderboardsIntent ()

This method is deprecated.
See `getAllLeaderboardsIntent(GoogleApiClient)`.

Gets an intent to show the list of leaderboards for a game. Note that this must be invoked with `startActivityForResult(Intent, int)`, so that the identity of the calling package can be established.

A `RESULT_RECONNECT_REQUIRED` may be returned as the resultCode in `onActivityResult(int, int, Intent)` if the GamesClient ends up in an inconsistent state.

##### Returns

- An `Intent` that can be started to view the list of leaderboards for a game.

#### public String getAppId ()

This method is deprecated.
See `getAppId(GoogleApiClient)`

Get the application ID linked to this GamesClient instance.

##### Returns

- The application ID linked to this GamesClient instance.

#### public String getCurrentAccountName ()

This method is deprecated.
See `getCurrentAccountName(GoogleApiClient)`.

Get the name of the currently selected account. This is the account the user has chosen to use for Google Play Games.

Note that the `GamesClient` must be connected to call this API, and your app must have `<uses-permission android:name="android.permission.GET_ACCOUNTS" />` declared in your manifest in order to use this method.

##### Returns

- Account name for the currently selected account. May be null if an error occurred while communicating with the games service.

##### Throws

SecurityException | If your app doesn't have the `GET_ACCOUNTS` permission.

#### public Game getCurrentGame ()

This method is deprecated.
See `getCurrentGame(GoogleApiClient)`.

##### Returns

- `Game` metadata for the current game. May be null if the metadata is not available locally.

#### public Player getCurrentPlayer ()

This method is deprecated.
See `getCurrentPlayer(GoogleApiClient)`.

##### Returns

- `Player` representing the currently signed in player. May be null if an error occurred while communicating with the games service.

#### public String getCurrentPlayerId ()

This method is deprecated.
See `getCurrentPlayerId(GoogleApiClient)`.

##### Returns

- The player ID for the currently signed in player. May be null if an error occurred while communicating with the games service.

#### public Intent getInvitationInboxIntent ()

This method is deprecated.
See `getInvitationInboxIntent(GoogleApiClient)`

Returns an intent that will let the user see and manage any outstanding invitations. Note that this must be invoked using `startActivityForResult(Intent, int)` so that the identity of the calling package can be established.

If the user canceled, the result will be `RESULT_CANCELED`. If the user selected an invitation to accept, the result will be `RESULT_OK` and the data intent will contain the selected invitation as a parcelable extra in `EXTRA_INVITATION`.

##### Returns

- An `Intent` that can be started to view the invitation inbox UI.

#### public Intent getLeaderboardIntent (String leaderboardId)

This method is deprecated.
See `getLeaderboardIntent(GoogleApiClient, String)`.

Gets an intent to show a leaderboard for a game. Note that this must be invoked with `startActivityForResult(Intent, int)`, so that the identity of the calling package can be established.

A `RESULT_RECONNECT_REQUIRED` may be returned as the resultCode in `onActivityResult(int, int, Intent)` if the GamesClient ends up in an inconsistent state.

##### Parameters

leaderboardId | The ID of the leaderboard to view.

##### Returns

- An `Intent` that can be started to view the specified leaderboard.

#### public Intent getMatchInboxIntent ()

This method is deprecated.
See `getInboxIntent(GoogleApiClient)`

Returns an intent that will let the user see and manage any outstanding invitations and matches. Note that this must be invoked using `startActivityForResult(Intent, int)` so that the identity of the calling package can be established.

If the user canceled the result will be `RESULT_CANCELED`. If the user selected an invitation or a match to accept, the result will be `RESULT_OK` and the data intent will contain the selected invitation/match as a parcelable extra in the extras. Based on the type of the match, the result will include either `EXTRA_TURN_BASED_MATCH` or `EXTRA_INVITATION`.

##### Returns

- An `Intent` that can be started to view the match inbox.

#### public int getMaxTurnBasedMatchDataSize ()

This method is deprecated.
See `getMaxMatchDataSize(GoogleApiClient)`

Gets the maximum data size per match in bytes. Guaranteed to be at least 128 KB. May increase in the future.

If the service cannot be reached for some reason, this will return `STATUS_CLIENT_RECONNECT_REQUIRED`. In this case, no further operations should be attempted until after the client has reconnected.

##### Returns

- The maximum data size per match in bytes.

#### public Intent getPlayerSearchIntent ()

This method is deprecated.
See `getPlayerSearchIntent(GoogleApiClient)`

Returns an intent that will display a screen where the user can search for people on Google+. Note that this must be invoked with `startActivityForResult(Intent, int)`, so that the identity of the calling package can be established.

If the user canceled, the result will be `RESULT_CANCELED`. If the user selected any players from the search results list, the result will be `RESULT_OK`, and the data intent will contain a list of parceled Player objects in `EXTRA_PLAYER_SEARCH_RESULTS`.

Note that the current Player Search UI only allows a single selection, so the returned list of parceled Player objects will currently contain at most one Player. The Player Search UI may allow multiple selections in a future release, though.

##### Returns

- An `Intent` that can be started to display the player selector.

#### public Intent getRealTimeSelectOpponentsIntent (int minPlayers, int maxPlayers, boolean allowAutomatch)

This method is deprecated.
See `getSelectOpponentsIntent(GoogleApiClient, int, int, boolean)`

Returns an intent that will let the user select players to send an invitation to. Note that this must be invoked with `startActivityForResult(Intent, int)`, so that the identity of the calling package can be established.

The number of players passed in should be the desired number of additional players to select, not including the current player. So, for a game that can handle between 2 and 4 players, `minPlayers` would be 1 and `maxPlayers` would be 3.

If the user canceled, the result will be `RESULT_CANCELED`. If the user selected players, the result will be `RESULT_OK`, and the data intent will contain the selected player IDs in `EXTRA_PLAYERS` and the minimum and maximum numbers of additional auto-match players in `EXTRA_MIN_AUTOMATCH_PLAYERS` and `EXTRA_MAX_AUTOMATCH_PLAYERS` respectively. The player IDs in `EXTRA_PLAYERS` will include only the other players selected, not the current player.

If the `allowAutomatch` parameter is set to false, the UI will not display an option for selecting automatch players. Set this to false if your game does not support automatching.

##### Parameters

minPlayers | The minimum number of players to select (not including the current player).
maxPlayers | The maximum number of players to select (not including the current player).
allowAutomatch | Whether or not to display an option for selecting automatch players.

##### Returns

- An `Intent` that can be started to display the player selector.

##### See Also

- `createTurnBasedMatch(OnTurnBasedMatchInitiatedListener, TurnBasedMatchConfig)`
- `createRoom(RoomConfig)`

#### public Intent getRealTimeSelectOpponentsIntent (int minPlayers, int maxPlayers)

This method is deprecated.
See `getSelectOpponentsIntent(GoogleApiClient, int, int)`

Returns an intent that will let the user select players to send an invitation to. Note that this must be invoked with `startActivityForResult(Intent, int)`, so that the identity of the calling package can be established.

The number of players passed in should be the desired number of additional players to select, not including the current player. So, for a game that can handle between 2 and 4 players, `minPlayers` would be 1 and `maxPlayers` would be 3.

If the user canceled, the result will be `RESULT_CANCELED`. If the user selected players, the result will be `RESULT_OK`, and the data intent will contain the selected player IDs in `EXTRA_PLAYERS` and the minimum and maximum numbers of additional auto-match players in `EXTRA_MIN_AUTOMATCH_PLAYERS` and `EXTRA_MAX_AUTOMATCH_PLAYERS` respectively. The player IDs in `EXTRA_PLAYERS` will include only the other players selected, not the current player.

This method is the equivalent of calling `getRealTimeSelectOpponentsIntent(int, int, boolean)` with the `allowAutomatch` parameter set to true.

##### Parameters

minPlayers | The minimum number of players to select (not including the current player).
maxPlayers | The maximum number of players to select (not including the current player).

##### Returns

- An `Intent` that can be started to display the player selector.

##### See Also

- `createRoom(RoomConfig)`

#### public RealTimeSocket getRealTimeSocketForParticipant (String roomId, String participantId)

This method is deprecated.
See `getSocketForParticipant(GoogleApiClient, String, String)`

Returns a `RealTimeSocket` for carrying network traffic to the given peer. Creates a new socket if one does not exist (or if an existing socket gets disconnected). Requires an active real-time room and players being available. Throws an `IllegalArgumentException` if participantId is not a valid participant or belongs to the current player.

This method preserves datagram boundaries with the write() and read() calls and guarantees in-order arrival of packets.

##### Parameters

roomId | ID of the room for which the socket is being bound.
participantId | The ID of the participant to whom this socket is bound

##### Returns

- An instance of a LocalSocket, or null on error.

#### public Intent getRealTimeWaitingRoomIntent (Room room, int minParticipantsToStart)

This method is deprecated.
See `getWaitingRoomIntent(GoogleApiClient, Room, int)`

Returns an intent that will display a "waiting room" screen that shows the progress of participants joining a real-time multiplayer room. Note that this must be invoked with `startActivityForResult(Intent, int)`, so that the identity of the calling package can be established.

If the necessary number of peers have connected and it's now OK to start the game, or if the user explicitly asked to start the game now, the activity result will be `RESULT_OK`. If the user bailed out of the waiting room screen without taking any action, the result will be `RESULT_CANCELED`. If the user explicitly chose to leave the room, the result will be `RESULT_LEFT_ROOM`.

Regardless of what the result code was, the waiting room activity will return a data intent containing a `Room` object in `EXTRA_ROOM` that represents the current state of the Room that you originally passed as a parameter here.

If desired, the waiting room can allow the user to start playing the game even before the room is fully connected. This is controlled by the `minParticipantsToStart` parameter: if at least that many participants (including the current player) are connected to the room, a "Start playing" menu item will become enabled in the waiting room UI. Setting `minParticipantsToStart` to 0 means that "Start playing" will always be available, and a value of `MAX_VALUE` will disable the item completely. Note: if you do allow the user to start early, you'll need to handle that situation by explicitly telling the other connected peers that the game is now starting; see the developer documentation for more details.

Finally, note that the waiting room itself will never explicitly take any action to change the state of the room or its participants. So if the activity result is `RESULT_LEFT_ROOM`, it's the caller's responsibility to actually leave the room. Or if the result is `RESULT_CANCELED`, it's the responsibility of the caller to double-check the current state of the Room and decide whether to start the game, keep waiting, or do something else. But note that while the waiting room is active, the state of the Room will change as participants accept or decline invitations, and the number of participants may even change as auto-match players get added.

##### Parameters

room | The `Room` object to be displayed.
minParticipantsToStart | the minimum number of participants that must be connected to the room (including the current player) for the "Start playing" menu item to become enabled.

##### Returns

- An `Intent` that can be started to display the waiting room screen.

##### See Also

- `createRoom(RoomConfig)`
- `leaveRoom(RoomUpdateListener, String)`

#### public Intent getSettingsIntent ()

This method is deprecated.
See `getSettingsIntent(GoogleApiClient)`

Gets an intent to show the Settings screen that allows the user to configure GamesClient-related features for the current game. Note that this must be invoked with `startActivityForResult(Intent, int)`, so that the identity of the calling package can be established.

A `RESULT_RECONNECT_REQUIRED` may be returned as the resultCode in `onActivityResult(int, int, Intent)` if the GamesClient ends up in an inconsistent state.

Most applications will not need to call this directly, since the Settings UI is already reachable from most other GamesClient UI screens (achievements, leaderboards, etc.) via a menu item.

##### Returns

- An `Intent` that can be started to view the GamesClient Settings UI.

#### public void getTurnBasedMatch (OnTurnBasedMatchLoadedListener listener, String matchId)

This method is deprecated.
See `loadMatch(GoogleApiClient, String)`

Load a specified turn-based match.

##### Parameters

listener | The listener that is called when the load is complete. The listener is called on the main thread.
matchId | The ID of the match to retreive.

#### public Intent getTurnBasedSelectOpponentsIntent (int minPlayers, int maxPlayers, boolean allowAutomatch)

This method is deprecated.
See `getSelectOpponentsIntent(GoogleApiClient, int, int, boolean)`

Returns an intent that will let the user select players to send an invitation to. Note that this must be invoked with `startActivityForResult(Intent, int)`, so that the identity of the calling package can be established.

The number of players passed in should be the desired number of additional players to select, not including the current player. So, for a game that can handle between 2 and 4 players, `minPlayers` would be 1 and `maxPlayers` would be 3.

If the user canceled, the result will be `RESULT_CANCELED`. If the user selected players, the result will be `RESULT_OK`, and the data intent will contain the selected player IDs in `EXTRA_PLAYERS` and the minimum and maximum numbers of additional auto-match players in `EXTRA_MIN_AUTOMATCH_PLAYERS` and `EXTRA_MAX_AUTOMATCH_PLAYERS` respectively. The player IDs in `EXTRA_PLAYERS` will include only the other players selected, not the current player.

If the `allowAutomatch` parameter is set to false, the UI will not display an option for selecting automatch players. Set this to false if your game does not support automatching.

##### Parameters

minPlayers | The minimum number of players to select (not including the current player).
maxPlayers | The maximum number of players to select (not including the current player).
allowAutomatch | Whether or not to display an option for selecting automatch players.

##### Returns

- An `Intent` that can be started to display the player selector.

##### See Also

- `createTurnBasedMatch(OnTurnBasedMatchInitiatedListener, TurnBasedMatchConfig)`

#### public Intent getTurnBasedSelectOpponentsIntent (int minPlayers, int maxPlayers)

This method is deprecated.
See `getSelectOpponentsIntent(GoogleApiClient, int, int)`

Returns an intent that will let the user select players to send an invitation to. Note that this must be invoked with `startActivityForResult(Intent, int)`, so that the identity of the calling package can be established.

The number of players passed in should be the desired number of additional players to select, not including the current player. So, for a game that can handle between 2 and 4 players, `minPlayers` would be 1 and `maxPlayers` would be 3.

If the user canceled, the result will be `RESULT_CANCELED`. If the user selected players, the result will be `RESULT_OK`, and the data intent will contain the selected player IDs in `EXTRA_PLAYERS` and the minimum and maximum numbers of additional auto-match players in `EXTRA_MIN_AUTOMATCH_PLAYERS` and `EXTRA_MAX_AUTOMATCH_PLAYERS` respectively. The player IDs in `EXTRA_PLAYERS` will include only the other players selected, not the current player.

This method is the equivalent of calling `getTurnBasedSelectOpponentsIntent(int, int, boolean)` with the `allowAutomatch` parameter set to true.

##### Parameters

minPlayers | The minimum number of players to select (not including the current player).
maxPlayers | The maximum number of players to select (not including the current player).

##### Returns

- An `Intent` that can be started to display the player selector.

##### See Also

- `createTurnBasedMatch(OnTurnBasedMatchInitiatedListener, TurnBasedMatchConfig)`

#### public void incrementAchievement (String id, int numSteps)

This method is deprecated.
See `increment(GoogleApiClient, String, int)`

Increments an achievement by the given number of steps. The achievement must be an incremental achievement. Once an achievement reaches at least the maximum number of steps, it will be unlocked automatically. Any further increments will be ignored.

This is the fire-and-forget form of the API. Use this form if you don't need to know the status of the operation immediately. For most applications, this will be the preferred API to use, though note that the update may not be sent to the server until the next sync. See `incrementAchievementImmediate(OnAchievementUpdatedListener, String, int)` if you need the operation to attempt to communicate to the server immediately or need to have the status code delivered to your application.

##### Parameters

id | The achievement ID to increment.
numSteps | The number of steps to increment by. Must be greater than 0.

#### public void incrementAchievementImmediate (OnAchievementUpdatedListener listener, String id, int numSteps)

This method is deprecated.
See `incrementImmediate(GoogleApiClient, String, int)`

Increments an achievement by the given number of steps. The achievement must be an incremental achievement. Once an achievement reaches at least the maximum number of steps, it will be unlocked automatically. Any further increments will be ignored.

This form of the API will attempt to update the user's achievement on the server immediately, and will use the provided listener to inform the caller of the result of the operation.

The status code to indicate the success or failure of the operation is delivered to the given listener on the main thread. If `disconnect()` is called before the operation is completed, the status code will not be delivered.

##### Parameters

listener | The listener that is called when the increment achievement is complete. The listener is called on the main thread.
id | The ID of the achievement to increment.
numSteps | The number of steps to increment by. Must be greater than 0.

#### public boolean isConnected ()

This method is deprecated.
See `isConnected()`.

Checks if the client is currently connected to the service, so that requests to other methods will succeed. Applications should guard client actions caused by the user with a call to this method.

##### Returns

- true if the client is connected to the service.

#### public boolean isConnecting ()

This method is deprecated.
See `isConnecting()`.

Checks if the client is attempting to connect to the service.

##### Returns

- true if the client is attempting to connect to the service.

#### public boolean isConnectionCallbacksRegistered (GooglePlayServicesClient.ConnectionCallbacks listener)

This method is deprecated.
See `isConnectionCallbacksRegistered(GoogleApiClient.ConnectionCallbacks)`.

Returns true if the specified listener is currently registered to receive connection events.

##### Parameters

listener | The listener to check for.

##### Returns

- true if the specified listener is currently registered to receive connection events.

#### public boolean isConnectionFailedListenerRegistered (GooglePlayServicesClient.OnConnectionFailedListener listener)

This method is deprecated.
See `isConnectionFailedListenerRegistered(GoogleApiClient.OnConnectionFailedListener)`.

Returns true if the specified listener is currently registered to receive connection failed events.

##### Parameters

listener | The listener to check for.

##### Returns

- true if the specified listener is currently registered to receive connection failed events.

#### public void joinRoom (RoomConfig config)

This method is deprecated.
See `join(GoogleApiClient, RoomConfig)`

Join a real-time room by accepting an invitation. The lifetime of the current game's connection to the room is bound to this `GamesClient`'s lifecycle. When the client disconnects, the player will leave the room and any peer-to-peer connections for this player will be torn down. The result is delivered by the callback `onJoinedRoom(int, Room)` to the given RoomUpdateListener in the `RoomConfig`. The listener is called on the main thread.

##### Parameters

config | The real-time room configuration.

#### public void leaveRoom (RoomUpdateListener listener, String roomId)

This method is deprecated.
See `leave(GoogleApiClient, RoomUpdateListener, String)`

Leave the specified room. This will disconnect the player from the room, but allow other players to continue playing the game. The result is delivered by the callback `onLeftRoom(int, String)` to the given listener on the main thread.

After this method is called, you cannot perform any further actions on the room. You can create or join another room only after `onLeftRoom(int, String)` is received.

##### Parameters

listener | The listener that is notified after the room has been left. The listener is called on the main thread.
roomId | ID of the room to leave.

#### public void leaveTurnBasedMatch (OnTurnBasedMatchLeftListener listener, String matchId)

This method is deprecated.
See `leaveMatch(GoogleApiClient, String)`

Leave the specified match when it is not the current player's turn. If this takes the match to fewer than two participants, the match will be canceled.

See `leaveTurnBasedMatchDuringTurn(OnTurnBasedMatchLeftListener, String, String)` for the form of the API to call during the current player's turn.

##### Parameters

listener | The listener that is called after the match has been left. The listener is called on the main thread.
matchId | ID of the match to leave.

#### public void leaveTurnBasedMatchDuringTurn (OnTurnBasedMatchLeftListener listener, String matchId, String pendingParticipantId)

This method is deprecated.
See `leaveMatchDuringTurn(GoogleApiClient, String, String)`

Leave the specified match during the current player's turn. If this takes the match to fewer than two participants, the match will be canceled. The provided `pendingParticipantId` will be used to determine which participant should act next. If no pending participant is provided and the match has available auto-match slots, the match will wait for additional players to be found. If there are no auto-match slots available for this match, a pending participant ID is required.

See `leaveTurnBasedMatch(OnTurnBasedMatchLeftListener, String)` for the form of the API to call when it is not the current player's turn.

##### Parameters

listener | The listener that is called after the match has been left. The listener is called on the main thread.
matchId | ID of the match to leave.
pendingParticipantId | ID of the participant who will be set to pending after this update succeeds, or `null` to wait for additional automatched players (if possible).

#### public void loadAchievements (OnAchievementsLoadedListener listener, boolean forceReload)

This method is deprecated.
See `load(GoogleApiClient, boolean)`

Asynchronously load achievement data for the currently signed in player.

The result is delivered to the given listener on the main thread. If `disconnect()` is called before the result is ready it will not be delivered.

##### Parameters

listener | The listener that is called when the load is complete. The listener is called on the main thread.
forceReload | If true, this call will clear any locally cached data and attempt to fetch the latest data from the server. This would commonly be used for something like a user-initiated refresh. Normally, this should be set to false to gain advantages of data caching.

#### public void loadCurrentPlayerLeaderboardScore (OnPlayerLeaderboardScoreLoadedListener listener, String leaderboardId, int span, int leaderboardCollection)

This method is deprecated.
See `loadCurrentPlayerLeaderboardScore(GoogleApiClient, String, int, int)`

Asynchronously load the currently signed in player's score for a given leaderboard.

##### Parameters

listener | The listener that is called when the load is complete. The listener is called on the main thread.
leaderboardId | ID of the leaderboard to load the score from.
span | Time span to retrieve data for. Valid values are `TIME_SPAN_DAILY`, `TIME_SPAN_WEEKLY`, or `TIME_SPAN_ALL_TIME`.
leaderboardCollection | The leaderboard collection to retrieve scores for. Valid values are either `COLLECTION_PUBLIC` or `COLLECTION_SOCIAL`.

#### public void loadGame (OnGamesLoadedListener listener)

This method is deprecated.
See `loadGame(GoogleApiClient)`

Load the details for the current game.

##### Parameters

listener | The listener that is called when the load is complete. The listener is called on the main thread.

#### public void loadInvitablePlayers (OnPlayersLoadedListener listener, int pageSize, boolean forceReload)

This method is deprecated.
See `loadInvitablePlayers(GoogleApiClient, int, boolean)`.

Load the initial page of players the currently signed-in player can invite to a multiplayer game, sorted alphabetically by name.

The result is delivered to the given listener on the main thread. If `disconnect()` is called before the result is ready it will not be delivered.

##### Parameters

listener | The listener that is called when the load is complete. The listener is called on the main thread.
pageSize | The number of entries to request for this initial page. Note that if cached data already exists, the returned buffer may contain more than this size, but it is guaranteed to contain at least this many if the collection contains enough records. This must be a value between 1 and 25.
forceReload | If true, this call will clear any locally cached data and attempt to fetch the latest data from the server. This would commonly be used for something like a user-initiated refresh. Normally, this should be set to false to gain advantages of data caching.

#### public void loadInvitations (OnInvitationsLoadedListener listener)

This method is deprecated.
See `loadInvitations(GoogleApiClient)`

Asynchronously load the list of invitations for the current game.

The result is delivered to the given listener on the main thread. If `disconnect()` is called before the result is ready it will not be delivered.

##### Parameters

listener | The listener that is called when the load is complete. The listener is called on the main thread.

#### public void loadLeaderboardMetadata (OnLeaderboardMetadataLoadedListener listener, boolean forceReload)

This method is deprecated.
See `loadLeaderboardMetadata(GoogleApiClient, boolean)`.

Asynchronously load the list of leaderboard metadata for this game.

The result is delivered to the given listener on the main thread. If `disconnect()` is called before the result is ready it will not be delivered.

##### Parameters

listener | The listener that is called when the load is complete. The listener is called on the main thread.
forceReload | If true, this call will clear any locally cached data and attempt to fetch the latest data from the server. This would commonly be used for something like a user-initiated refresh. Normally, this should be set to false to gain advantages of data caching.

#### public void loadLeaderboardMetadata (OnLeaderboardMetadataLoadedListener listener, String leaderboardId, boolean forceReload)

This method is deprecated.
See `loadLeaderboardMetadata(GoogleApiClient, String, boolean)`

Asynchronously load a specific leaderboard's metadata for this game.

The result is delivered to the given listener on the main thread. If `disconnect()` is called before the result is ready it will not be delivered.

##### Parameters

listener | The listener that is called when the load is complete. The listener is called on the main thread.
leaderboardId | ID of the leaderboard to load metadata for.
forceReload | If true, this call will clear any locally cached data and attempt to fetch the latest data from the server. This would commonly be used for something like a user-initiated refresh. Normally, this should be set to false to gain advantages of data caching.

#### public void loadMoreInvitablePlayers (OnPlayersLoadedListener listener, int pageSize)

This method is deprecated.
See `loadMoreInvitablePlayers(GoogleApiClient, int)`.

Asynchronously loads an additional page of invitable players. A new player buffer will be delivered that includes an extra page of results.

The result is delivered to the given listener on the main thread. If `disconnect()` is called before the result is ready it will not be delivered.

##### Parameters

listener | The listener that is called when the load is complete. The listener is called on the main thread.
pageSize | The number of additional entries to request. This must be a value between 1 and 25.

#### public void loadMoreScores (OnLeaderboardScoresLoadedListener listener, LeaderboardScoreBuffer buffer, int maxResults, int pageDirection)

This method is deprecated.
See `loadMoreScores(GoogleApiClient, LeaderboardScoreBuffer, int, int)`

Asynchronously loads an additional page of score data for the given score buffer. A new score buffer will be delivered that replaces the given buffer.

The result is delivered to the given listener on the main thread. If `disconnect()` is called before the result is ready it will not be delivered.

##### Parameters

listener | The listener that is called when the load is complete. The listener is called on the main thread.
buffer | The existing buffer that will be expanded. The buffer is allowed to be closed prior to being passed in to this method.
maxResults | The maximum number of scores to fetch per page. Must be between 1 and 25.
pageDirection | The direction to expand the buffer. Values are defined in `PageDirection`.

#### public void loadPlayer (OnPlayersLoadedListener listener, String playerId)

This method is deprecated.
See `loadPlayer(GoogleApiClient, String)`.

Asynchronously loads the profile for the requested player ID.

The result is delivered to the given listener on the main thread. If `disconnect()` is called before the result is ready it will not be delivered.

##### Parameters

listener | The listener that is called when the load is complete. The listener is called on the main thread.
playerId | The player ID to get full profile data for.

#### public void loadPlayerCenteredScores (OnLeaderboardScoresLoadedListener listener, String leaderboardId, int span, int leaderboardCollection, int maxResults, boolean forceReload)

This method is deprecated.
See `loadPlayerCenteredScores(GoogleApiClient, String, int, int, int, boolean)`

Asynchronously load the player-centered page of scores for a given leaderboard. If the player does not have a score on this leaderboard, this call will return the top page instead.

The result is delivered to the given listener on the main thread. If `disconnect()` is called before the result is ready it will not be delivered.

##### Parameters

listener | The listener that is called when the load is complete. The listener is called on the main thread.
leaderboardId | ID of the leaderboard.
span | Time span to retrieve data for. Valid values are `TIME_SPAN_DAILY`, `TIME_SPAN_WEEKLY`, or `TIME_SPAN_ALL_TIME`.
leaderboardCollection | The leaderboard collection to retrieve scores for. Valid values are either `COLLECTION_PUBLIC` or `COLLECTION_SOCIAL`.
maxResults | The maximum number of scores to fetch per page. Must be between 1 and 25.
forceReload | If true, this call will clear any locally cached data and attempt to fetch the latest data from the server. This would commonly be used for something like a user-initiated refresh. Normally, this should be set to false to gain advantages of data caching.

#### public void loadPlayerCenteredScores (OnLeaderboardScoresLoadedListener listener, String leaderboardId, int span, int leaderboardCollection, int maxResults)

This method is deprecated.
See `loadPlayerCenteredScores(GoogleApiClient, String, int, int, int)`

Asynchronously load the player-centered page of scores for a given leaderboard. If the player does not have a score on this leaderboard, this call will return the top page instead.

The result is delivered to the given listener on the main thread. If `disconnect()` is called before the result is ready it will not be delivered.

##### Parameters

listener | The listener that is called when the load is complete. The listener is called on the main thread.
leaderboardId | ID of the leaderboard.
span | Time span to retrieve data for. Valid values are `TIME_SPAN_DAILY`, `TIME_SPAN_WEEKLY`, or `TIME_SPAN_ALL_TIME`.
leaderboardCollection | The leaderboard collection to retrieve scores for. Valid values are either `COLLECTION_PUBLIC` or `COLLECTION_SOCIAL`.
maxResults | The maximum number of scores to fetch per page. Must be between 1 and 25.

#### public void loadTopScores (OnLeaderboardScoresLoadedListener listener, String leaderboardId, int span, int leaderboardCollection, int maxResults)

This method is deprecated.
See `loadTopScores(GoogleApiClient, String, int, int, int)`

Asynchronously load the top page of scores for a given leaderboard.

The result is delivered to the given listener on the main thread. If `disconnect()` is called before the result is ready it will not be delivered.

##### Parameters

listener | The listener that is called when the load is complete. The listener is called on the main thread.
leaderboardId | ID of the leaderboard.
span | Time span to retrieve data for. Valid values are `TIME_SPAN_DAILY`, `TIME_SPAN_WEEKLY`, or `TIME_SPAN_ALL_TIME`.
leaderboardCollection | The leaderboard collection to retrieve scores for. Valid values are either `COLLECTION_PUBLIC` or `COLLECTION_SOCIAL`.
maxResults | The maximum number of scores to fetch per page. Must be between 1 and 25.

#### public void loadTopScores (OnLeaderboardScoresLoadedListener listener, String leaderboardId, int span, int leaderboardCollection, int maxResults, boolean forceReload)

This method is deprecated.
See `loadTopScores(GoogleApiClient, String, int, int, int, boolean)`

Asynchronously load the top page of scores for a given leaderboard.

The result is delivered to the given listener on the main thread. If `disconnect()` is called before the result is ready it will not be delivered.

##### Parameters

listener | the listener that is called when the load is complete. The listener is called on the main thread.
leaderboardId | ID of the leaderboard.
span | Time span to retrieve data for. Valid values are `TIME_SPAN_DAILY`, `TIME_SPAN_WEEKLY`, or `TIME_SPAN_ALL_TIME`.
leaderboardCollection | The leaderboard collection to retrieve scores for. Valid values are either `COLLECTION_PUBLIC` or `COLLECTION_SOCIAL`.
maxResults | The maximum number of scores to fetch per page. Must be between 1 and 25.
forceReload | If true, this call will clear any locally cached data and attempt to fetch the latest data from the server. This would commonly be used for something like a user-initiated refresh. Normally, this should be set to false to gain advantages of data caching.

#### public void loadTurnBasedMatches (OnTurnBasedMatchesLoadedListener listener, int... matchTurnStatuses)

This method is deprecated.
See `loadMatchesByStatus(GoogleApiClient, int[])`

Asynchronously load turn-based matches for the current game. Matches with any specified turn status codes will be returned to the provided listener.

Valid turn status values are `MATCH_TURN_STATUS_INVITED`, `MATCH_TURN_STATUS_MY_TURN`, `MATCH_TURN_STATUS_THEIR_TURN`, or `MATCH_TURN_STATUS_COMPLETE`. Note that if your game implements both turn-based and real-time multiplayer, requesting `MATCH_TURN_STATUS_INVITED` will return invitations for both turn-based matches and real-time matches.

The result is delivered to the given listener on the main thread. If `disconnect()` is called before the result is ready it will not be delivered.

##### Parameters

listener | The listener that is called when the load is complete. The listener is called on the main thread.
matchTurnStatuses | List of turn statuses to request.

#### public void reconnect ()

This method is deprecated.
See `reconnect()`

Closes the current connection to Google Play services and creates a new connection.

This method closes the current connection then returns immediately and reconnects to the service in the background.

As with a regular `connect()` call, a call to this method will be followed by either `onConnected(Bundle)` if the connection is successful or `onConnectionFailed(ConnectionResult)` on a failure.

##### See Also

- `connect()`
- `disconnect()`
- `connect()`

#### public void registerConnectionCallbacks (GooglePlayServicesClient.ConnectionCallbacks listener)

This method is deprecated.
See `registerConnectionCallbacks(GoogleApiClient.ConnectionCallbacks)`.

Registers a listener to receive connection events from this `GooglePlayServicesClient`. If the service is already connected, the listener's `onConnected(Bundle)` method will be called immediately. Applications should balance calls to this method with calls to `unregisterConnectionCallbacks(ConnectionCallbacks)` to avoid leaking resources.

If the specified listener is already registered to receive connection events, this method will not add a duplicate entry for the same listener, but will still call the listener's `onConnected(Bundle)` method if currently connected.

Note that the order of messages received here may not be stable, so clients should not rely on the order that multiple listeners receive events in.

##### Parameters

listener | the listener where the results of the asynchronous `connect()` call are delivered.

#### public void registerConnectionFailedListener (GooglePlayServicesClient.OnConnectionFailedListener listener)

This method is deprecated.
See `registerConnectionFailedListener(GoogleApiClient.OnConnectionFailedListener)`.

Registers a listener to receive connection failed events from this `GooglePlayServicesClient`. Unlike `registerConnectionCallbacks(GooglePlayServicesClient.ConnectionCallbacks)`, if the service is not already connected, the listener's `onConnectionFailed(ConnectionResult)` method will not be called immediately. Applications should balance calls to this method with calls to `unregisterConnectionFailedListener(OnConnectionFailedListener)` to avoid leaking resources.

If the specified listener is already registered to receive connection failed events, this method will not add a duplicate entry for the same listener.

Note that the order of messages received here may not be stable, so clients should not rely on the order that multiple listeners receive events in.

##### Parameters

listener | the listener where the results of the asynchronous `connect()` call are delivered.

#### public void registerInvitationListener (OnInvitationReceivedListener listener)

This method is deprecated.
See `registerInvitationListener(GoogleApiClient, OnInvitationReceivedListener)`

Register a listener to intercept incoming invitations for the currently signed-in user. If a listener is registered by this method, the incoming invitation will not generate a status bar notification as long as this client remains connected.

Note that only one invitation listener may be active at a time. Calling this method while another invitation listener was previously registered will replace the original listener with the new one.

##### Parameters

listener | The listener that is called when a new invitation is received. The listener is called on the main thread.

#### public void registerMatchUpdateListener (OnTurnBasedMatchUpdateReceivedListener listener)

This method is deprecated.
See `registerMatchUpdateListener(GoogleApiClient, OnTurnBasedMatchUpdateReceivedListener)`

Register a listener to intercept incoming match updates for the currently signed-in user. If a listener is registered by this method, the incoming match update will not generate a status bar notification as long as this client remains connected.

Note that only one match update listener may be active at a time. Calling this method while another match update listener was previously registered will replace the original listener with the new one.

##### Parameters

listener | The listener that is called when a match update is received. The listener is called on the main thread.

#### public void rematchTurnBasedMatch (OnTurnBasedMatchInitiatedListener listener, String matchId)

This method is deprecated.
See `rematch(GoogleApiClient, String)`

Create a rematch of a previously completed turn-based match. The new match will have the same participants as the previous match. Note that only one rematch may be created from any single completed match.

##### Parameters

listener | The listener that is called when the match has been created. The listener is called on the main thread.
matchId | The ID of the previous match to re-create.

#### public void revealAchievement (String id)

This method is deprecated.
See `reveal(GoogleApiClient, String)`

Reveal a hidden achievement to the currently signed in player. If the achievement has already been unlocked, this will have no effect.

This is the fire-and-forget form of the API. Use this form if you don't need to know the status of the operation immediately. For most applications, this will be the preferred API to use, though note that the update may not be sent to the server until the next sync. See `revealAchievementImmediate(OnAchievementUpdatedListener, String)` if you need the operation to attempt to communicate to the server immediately or need to have the status code delivered to your application.

##### Parameters

id | The achievement ID to reveal

##### See Also

- `unlockAchievement(String)`

#### public void revealAchievementImmediate (OnAchievementUpdatedListener listener, String id)

This method is deprecated.
See `revealImmediate(GoogleApiClient, String)`

Reveal a hidden achievement to the currently signed in player. If the achievement is already visible, this will have no effect.

This form of the API will attempt to update the user's achievement on the server immediately, and will use the provided listener to inform the caller of the result of the operation.

The status code to indicate the success or failure of the operation is delivered to the given listener on the main thread. If `disconnect()` is called before the operation is completed, the status code will not be delivered.

##### Parameters

listener | The listener that is called when the reveal achievement is complete. The listener is called on the main thread.
id | The ID of the achievement to reveal

##### See Also

- `unlockAchievementImmediate(OnAchievementUpdatedListener, String)`

#### public int sendReliableRealTimeMessage (RealTimeReliableMessageSentListener listener, byte[] messageData, String roomId, String recipientParticipantId)

This method is deprecated.
See `sendReliableMessage(GoogleApiClient, ReliableMessageSentCallback, byte[], String, String)`

Send a message to a participant in a real-time room reliably. The caller will receive a callback to report the status of the send message operation. Throws an `IllegalArgumentException` if recipientParticipantId is not a valid participant or belongs to the current player. The maximum message size supported is `MAX_RELIABLE_MESSAGE_LEN` bytes.

##### Parameters

listener | The listener that is notified when the message has been sent.
messageData | The message to be sent. Should be at most `MAX_RELIABLE_MESSAGE_LEN` bytes.
roomId | ID of the room for which the message is being sent.
recipientParticipantId | The participant ID to send the message to.

##### Returns

- The token for the message sent, which is returned in callback `onRealTimeMessageSent(int, int, String)` or `STATUS_REAL_TIME_MESSAGE_FAILED` if the message failed to send.

#### public int sendUnreliableRealTimeMessage (byte[] messageData, String roomId, List<String> recipientParticipantIds)

This method is deprecated.
See `sendUnreliableMessage(GoogleApiClient, byte[], String, java.util.List)`

Send a message to one or more participants in a real-time room. The message delivery is not reliable and will not report status after completion. Throws an `IllegalArgumentException` if any participants in recipientParticipantIds are not valid or belong to the current player. The maximum message size supported is `MAX_UNRELIABLE_MESSAGE_LEN` bytes.

##### Parameters

messageData | The message to be sent. Should be at most `MAX_UNRELIABLE_MESSAGE_LEN` bytes.
roomId | ID of the room for which the message is being sent.
recipientParticipantIds | One or more participant IDs to send the message to.

##### Returns

- `STATUS_OK` on a successful attempt, `STATUS_REAL_TIME_MESSAGE_FAILED` if the message failed to send.

#### public int sendUnreliableRealTimeMessage (byte[] messageData, String roomId, String recipientParticipantId)

This method is deprecated.
See `sendUnreliableMessage(GoogleApiClient, byte[], String, String)`

Send a message to a participant in a real-time room. The message delivery is not reliable and will not report status after completion. Throws an `IllegalArgumentException` if recipientParticipantId is not a valid participant or belongs to the current player. The maximum message size supported is `MAX_UNRELIABLE_MESSAGE_LEN` bytes.

##### Parameters

messageData | The message to be sent. Should be at most `MAX_UNRELIABLE_MESSAGE_LEN` bytes.
roomId | ID of the room for which the message is being sent.
recipientParticipantId | The participant ID to send the message to.

##### Returns

- `STATUS_OK` on a successful attempt, `STATUS_REAL_TIME_MESSAGE_FAILED` if the message failed to send.

#### public int sendUnreliableRealTimeMessageToAll (byte[] messageData, String roomId)

This method is deprecated.
See `sendUnreliableMessageToAll(GoogleApiClient, byte[], String)`

Send a message to all participants in a real-time room. The message delivery is not reliable and will not report status after completion. The maximum message size supported is `MAX_UNRELIABLE_MESSAGE_LEN` bytes.

##### Parameters

messageData | The message to be sent. Should be at most `MAX_UNRELIABLE_MESSAGE_LEN` bytes.
roomId | ID of the room for which the message is being sent.

##### Returns

- `STATUS_OK` on a successful attempt, `STATUS_REAL_TIME_MESSAGE_FAILED` if the message failed to send.

#### public void setAchievementSteps (String id, int numSteps)

This method is deprecated.
See `setSteps(GoogleApiClient, String, int)`

Set an achievement to have at least the given number of steps completed. Calling this method while the achievement already has more steps than the provided value is a no-op. Once the achievement reaches the maximum number of steps, the achievement will automatically be unlocked, and any further mutation operations will be ignored.

This is the fire-and-forget form of the API. Use this form if you don't need to know the status of the operation immediately. For most applications, this will be the preferred API to use, though note that the update may not be sent to the server until the next sync. See `setAchievementStepsImmediate(OnAchievementUpdatedListener, String, int)` if you need the operation to attempt to communicate to the server immediately or need to have the status code delivered to your application.

##### Parameters

id | The ID of the achievement to modify.
numSteps | The number of steps to set the achievement to. Must be greater than 0.

#### public void setAchievementStepsImmediate (OnAchievementUpdatedListener listener, String id, int numSteps)

This method is deprecated.
See `setStepsImmediate(GoogleApiClient, String, int)`

Set an achievement to have at least the given number of steps completed. Calling this method while the achievement already has more steps than the provided value is a no-op. Once the achievement reaches the maximum number of steps, the achievement will automatically be unlocked, and any further mutation operations will be ignored.

This form of the API will attempt to update the user's achievement on the server immediately, and will use the provided listener to inform the caller of the result of the operation.

The status code to indicate the success or failure of the operation is delivered to the given listener on the main thread. If `disconnect()` is called before the operation is completed, the status code will not be delivered.

##### Parameters

listener | The listener that is called when the set operation is complete. The listener is called on the main thread.
id | The ID of the achievement to modify.
numSteps | The number of steps to set the achievement to. Must be greater than 0.

#### public void setGravityForPopups (int gravity)

This method is deprecated.
See `setGravityForPopups(GoogleApiClient, int)`.

Specifies the part of the screen at which games service popups (for example, "welcome back" or "achievement unlocked" popups) will be displayed using gravity.

Default value is `TOP`|`CENTER_HORIZONTAL`.

##### Parameters

gravity | The gravity which controls the placement of games service popups.

#### public void setViewForPopups (View gamesContentView)

This method is deprecated.
See `setViewForPopups(GoogleApiClient, View)`.

Sets the `View` to use as a content view for popups.

##### Parameters

gamesContentView | The view to use as a content view for popups. View cannot be null.

#### public void signOut (OnSignOutCompleteListener listener)

This method is deprecated.
See `signOut(GoogleApiClient)`

Asynchronously signs the current user out.

This call doesn't disconnect the GamesClient. As no user is signed in after this call is completed, subsequent calls to this client will very likely fail. You should either call disconnect() or finish your Activity after this call. The listener is called when sign-out is complete. If `disconnect()` is called before sign-out is complete, the listener will not be called.

##### Parameters

listener | The listener that is called when sign-out is complete. The listener is called on the main thread.

#### public void signOut ()

This method is deprecated.
See `signOut(GoogleApiClient)`

Asynchronously signs the current user out.

This call doesn't disconnect the GamesClient. As no user is signed in after this call is completed, subsequent calls to this client will very likely fail. You should either call disconnect() or finish your Activity after this call.

#### public void submitScore (String leaderboardId, long score, String scoreTag)

This method is deprecated.
See `submitScore(GoogleApiClient, String, long, String)`

Submit a score to a leaderboard for the currently signed in player. The score is ignored if it is worse (as defined by the leaderboard configuration) than a previously submitted score for the same player.

This form of the API is a fire-and-forget form. Use this if you do not need to be notified of the results of submitting the score, though note that the update may not be sent to the server until the next sync.

The meaning of the score value depends on the formatting of the leaderboard established in the developer console. Leaderboards support the following score formats:

- Fixed-point: `score` represents a raw value, and will be formatted based on the number of decimal places configured. A score of 1000 would be formatted as 1000, 100.0, or 10.00 for 0, 1, or 2 decimal places.
- Time: `score` represents an elapsed time in milliseconds. The value will be formatted as an appropriate time value.
- Currency: `score` represents a value in micro units. For example, in USD, a score of 100 would display as $0.0001, while a score of 1000000 would display as $1.00

For more details, please see Leaderboard Concepts.

##### Parameters

leaderboardId | The leaderboard to submit the score to.
score | The raw score value.
scoreTag | Optional metadata about this score. The value may contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986.

#### public void submitScore (String leaderboardId, long score)

This method is deprecated.
See `submitScore(GoogleApiClient, String, long)`

Submit a score to a leaderboard for the currently signed in player. The score is ignored if it is worse (as defined by the leaderboard configuration) than a previously submitted score for the same player.

This form of the API is a fire-and-forget form. Use this if you do not need to be notified of the results of submitting the score, though note that the update may not be sent to the server until the next sync.

The meaning of the score value depends on the formatting of the leaderboard established in the developer console. Leaderboards support the following score formats:

- Fixed-point: `score` represents a raw value, and will be formatted based on the number of decimal places configured. A score of 1000 would be formatted as 1000, 100.0, or 10.00 for 0, 1, or 2 decimal places.
- Time: `score` represents an elapsed time in milliseconds. The value will be formatted as an appropriate time value.
- Currency: `score` represents a value in micro units. For example, in USD, a score of 100 would display as $0.0001, while a score of 1000000 would display as $1.00

For more details, please see Leaderboard Concepts.

##### Parameters

leaderboardId | The leaderboard to submit the score to.
score | The raw score value.

#### public void submitScoreImmediate (OnScoreSubmittedListener listener, String leaderboardId, long score, String scoreTag)

This method is deprecated.
See `submitScoreImmediate(GoogleApiClient, String, long, String)`

Submit a score to a leaderboard for the currently signed in player. The score is ignored if it is worse (as defined by the leaderboard configuration) than a previously submitted score for the same player.

This form of the API will attempt to submit the score to the server immediately, and will use the provided listener to inform the caller of the result of the operation.

The status code to indicate the success or failure of the operation is delivered to the given listener on the main thread. If `disconnect()` is called before the operation is completed, the status code will not be delivered.

The meaning of the score value depends on the formatting of the leaderboard established in the developer console. Leaderboards support the following score formats:

- Fixed-point: `score` represents a raw value, and will be formatted based on the number of decimal places configured. A score of 1000 would be formatted as 1000, 100.0, or 10.00 for 0, 1, or 2 decimal places.
- Time: `score` represents an elapsed time in milliseconds. The value will be formatted as an appropriate time value.
- Currency: `score` represents a value in micro units. For example, in USD, a score of 100 would display as $0.0001, while a score of 1000000 would display as $1.00

For more details, please see this page.

##### Parameters

listener | `OnScoreSubmittedListener` to call when the score has been submitted.
leaderboardId | The leaderboard to submit the score to.
score | The raw score value.
scoreTag | Optional metadata about this score. The value may contain no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986.

##### See Also

- `OnScoreSubmittedListener`

#### public void submitScoreImmediate (OnScoreSubmittedListener listener, String leaderboardId, long score)

This method is deprecated.
See `submitScoreImmediate(GoogleApiClient, String, long)`

Submit a score to a leaderboard for the currently signed in player. The score is ignored if it is worse (as defined by the leaderboard configuration) than a previously submitted score for the same player.

This form of the API will attempt to submit the score to the server immediately, and will use the provided listener to inform the caller of the result of the operation.

The status code to indicate the success or failure of the operation is delivered to the given listener on the main thread. If `disconnect()` is called before the operation is completed, the status code will not be delivered.

The meaning of the score value depends on the formatting of the leaderboard established in the developer console. Leaderboards support the following score formats:

- Fixed-point: `score` represents a raw value, and will be formatted based on the number of decimal places configured. A score of 1000 would be formatted as 1000, 100.0, or 10.00 for 0, 1, or 2 decimal places.
- Time: `score` represents an elapsed time in milliseconds. The value will be formatted as an appropriate time value.
- Currency: `score` represents a value in micro units. For example, in USD, a score of 100 would display as $0.0001, while a score of 1000000 would display as $1.00

For more details, please see this page.

##### Parameters

listener | `OnScoreSubmittedListener` to call when the score has been submitted.
leaderboardId | The leaderboard to submit the score to.
score | The raw score value.

##### See Also

- `OnScoreSubmittedListener`

#### public void takeTurn (OnTurnBasedMatchUpdatedListener listener, String matchId, byte[] matchData, String pendingParticipantId)

This method is deprecated.
See `takeTurn(GoogleApiClient, String, byte[], String)`

Update a match with new turn data. The participant that is passed in as the pending participant will be notified that it is their turn to take action. If no pending participant is provided and the match has available auto-match slots, the match will wait for additional players to be found. If there are no auto-match slots available for this match, a pending participant ID is required.

For the final turn of the match, there is no need to call this method. Instead, call `finishTurnBasedMatch(OnTurnBasedMatchUpdatedListener, String)` directly.

##### Parameters

listener | The listener that is called when the match has been updated. The listener is called on the main thread.
matchId | ID of the match to update.
matchData | Data representing the new state of the match after this update. Limited to a maximum of `getMaxTurnBasedMatchDataSize()` bytes.
pendingParticipantId | ID of the participant who will be set to pending after this update succeeds, or `null` to wait for additional automatched players (if possible).

##### See Also

- `finishTurnBasedMatch(OnTurnBasedMatchUpdatedListener, String, byte[], List)`

#### public void takeTurn (OnTurnBasedMatchUpdatedListener listener, String matchId, byte[] matchData, String pendingParticipantId, ParticipantResult... results)

This method is deprecated.
See `takeTurn(GoogleApiClient, String, byte[], String, ParticipantResult[])`

Update a match with new turn data. The participant that is passed in as the pending participant will be notified that it is their turn to take action. If no pending participant is provided and the match has available auto-match slots, the match will wait for additional players to be found. If there are no auto-match slots available for this match, a pending participant ID is required.

For the final turn of the match, there is no need to call this method. Instead, call `finishTurnBasedMatch(OnTurnBasedMatchUpdatedListener, String)` directly.

##### Parameters

listener | The listener that is called when the match has been updated. The listener is called on the main thread.
matchId | ID of the match to update.
matchData | Data representing the new state of the match after this update. Limited to a maximum of `getMaxTurnBasedMatchDataSize()` bytes.
pendingParticipantId | ID of the participant who will be set to pending after this update succeeds, or `null` to wait for additional automatched players (if possible).

results

Optional list of `ParticipantResult` objects for this match. Note that the results reported here should be final - if results reported later conflict with these values, the returned value will indicate a conflicted result by returning `MATCH_RESULT_DISAGREED`. This is most useful for cases where a participant knows their results early. For example, a single elimination game where participants are eliminated as the game continues might wish to specify results for the eliminated participants here.

##### See Also

- `finishTurnBasedMatch(OnTurnBasedMatchUpdatedListener, String, byte[], List)`

#### public void takeTurn (OnTurnBasedMatchUpdatedListener listener, String matchId, byte[] matchData, String pendingParticipantId, List<ParticipantResult> results)

This method is deprecated.
See `takeTurn(GoogleApiClient, String, byte[], String, java.util.List)`

Update a match with new turn data. The participant that is passed in as the pending participant will be notified that it is their turn to take action. If no pending participant is provided and the match has available auto-match slots, the match will wait for additional players to be found. If there are no auto-match slots available for this match, a pending participant ID is required.

For the final turn of the match, there is no need to call this method. Instead, call `finishTurnBasedMatch(OnTurnBasedMatchUpdatedListener, String)` directly.

##### Parameters

listener | The listener that is called when the match has been updated. The listener is called on the main thread.
matchId | ID of the match to update.
matchData | Data representing the new state of the match after this update. Limited to a maximum of `getMaxTurnBasedMatchDataSize()` bytes.
pendingParticipantId | ID of the participant who will be set to pending after this update succeeds, or `null` to wait for additional automatched players (if possible).

results

Optional list of `ParticipantResult` objects for this match. Note that the results reported here should be final - if results reported later conflict with these values, the returned value will indicate a conflicted result by returning `MATCH_RESULT_DISAGREED`. This is most useful for cases where a participant knows their results early. For example, a single elimination game where participants are eliminated as the game continues might wish to specify results for the eliminated participants here.

##### See Also

- `finishTurnBasedMatch(OnTurnBasedMatchUpdatedListener, String, byte[], List)`

#### public void unlockAchievement (String id)

This method is deprecated.
See `unlock(GoogleApiClient, String)`

Unlock an achievement for the currently signed in player. If the achievement is hidden this will reveal it to the player.

This is the fire-and-forget form of the API. Use this form if you don't need to know the status of the operation immediately. For most applications, this will be the preferred API to use, though note that the update may not be sent to the server until the next sync. See `unlockAchievementImmediate(OnAchievementUpdatedListener, String)` if you need the operation to attempt to communicate to the server immediately or need to have the status code delivered to your application.

##### Parameters

id | The achievement ID to unlock

##### See Also

- `revealAchievement(String)`

#### public void unlockAchievementImmediate (OnAchievementUpdatedListener listener, String id)

This method is deprecated.
See `unlockImmediate(GoogleApiClient, String)`

Unlock an achievement for the currently signed in player. If the achievement is hidden this will reveal it to the player.

This form of the API will attempt to update the user's achievement on the server immediately, and will use the provided listener to inform the caller of the result of the operation.

The status code to indicate the success or failure of the operation is delivered to the given listener on the main thread. If `disconnect()` is called before the operation is completed, the status code will not be delivered.

##### Parameters

listener | The listener that is called when the unlock achievement is complete. The listener is called on the main thread.
id | The ID of the achievement to unlock.

##### See Also

- `revealAchievementImmediate(OnAchievementUpdatedListener, String)`

#### public void unregisterConnectionCallbacks (GooglePlayServicesClient.ConnectionCallbacks listener)

This method is deprecated.
See `unregisterConnectionCallbacks(GoogleApiClient.ConnectionCallbacks)`.

Removes a connection listener from this `GooglePlayServicesClient`. Note that removing a listener does not generate any callbacks.

If the specified listener is not currently registered to receive connection events, this method will have no effect.

##### Parameters

listener | the listener to unregister.

#### public void unregisterConnectionFailedListener (GooglePlayServicesClient.OnConnectionFailedListener listener)

This method is deprecated.
See `unregisterConnectionFailedListener(GoogleApiClient.OnConnectionFailedListener)`.

Removes a connection failed listener from the `GooglePlayServicesClient`. Note that removing a listener does not generate any callbacks.

If the specified listener is not currently registered to receive connection failed events, this method will have no effect.

##### Parameters

listener | the listener to unregister.

#### public void unregisterInvitationListener ()

This method is deprecated.
See `unregisterInvitationListener(GoogleApiClient)`

Unregisters this client's invitation listener, if any. Any new invitations will generate status bar notifications as normal.

#### public void unregisterMatchUpdateListener ()

This method is deprecated.
See `unregisterMatchUpdateListener(GoogleApiClient)`

Unregisters this client's match update listener, if any. Any new match updates will generate status bar notifications as normal.