GamesClient

public class GamesClient extends GoogleApi<Games.GamesOptions>

A client to interact with games basic functionality.

Inherited Field Summary

From class com.google.android.gms.common.api.GoogleApi

protected final GoogleApiManager

zabm

Public Method Summary

Task<Bundle>	getActivationHint() Returns a Task which asynchronously loads a Bundle that may contain an information regarding to the previous user's action.
Task<String>	getAppId() Returns a Task which asynchronously loads the application ID linked to this client instance.
Task<String>	getCurrentAccountName() Returns a Task which asynchronously loads the name of the currently selected account.
Task<Intent>	getSettingsIntent() Returns a Task which asynchronously loads an Intent to show the Settings screen that allows the user to configure Games-related features for the current game.
Task<Void>	setGravityForPopups(int gravity) Returns a Task which asynchronously sets the part of the screen at which games service pop-ups (for example, "welcome back" or "achievement unlocked" popups) will be displayed using gravity.
Task<Void>	setViewForPopups(View gamesContentView) Returns a Task which asynchronously sets the View to use as a content view for popups.

Inherited Method Summary

From class com.google.android.gms.common.api.GoogleApi

GoogleApiClient	asGoogleApiClient()
ClientSettings.Builder	createClientSettingsBuilder()
Task<Boolean>	disconnectService()
<A extends Api.AnyClient, T extends ApiMethodImpl<? extends Result, A>> T	doBestEffortWrite(ApiMethodImpl arg0)
<TResult, A extends Api.AnyClient> Task<TResult>	doBestEffortWrite(TaskApiCall<A, TResult> arg0)
<A extends Api.AnyClient, T extends ApiMethodImpl<? extends Result, A>> T	doRead(ApiMethodImpl arg0)
<TResult, A extends Api.AnyClient> Task<TResult>	doRead(TaskApiCall<A, TResult> arg0)
<A extends Api.AnyClient> Task<Void>	doRegisterEventListener(RegistrationMethods arg0)
<A extends Api.AnyClient, T extends RegisterListenerMethod<A, ?>, U extends UnregisterListenerMethod<A, ?>> Task<Void>	doRegisterEventListener(RegisterListenerMethod arg0, UnregisterListenerMethod arg1)
Task<Boolean>	doUnregisterEventListener(ListenerKey arg0)
<TResult, A extends Api.AnyClient> Task<TResult>	doWrite(TaskApiCall<A, TResult> arg0)
<A extends Api.AnyClient, T extends ApiMethodImpl<? extends Result, A>> T	doWrite(ApiMethodImpl arg0)
final Api<Games.GamesOptions>	getApi()
Games.GamesOptions	getApiOptions()
Context	getApplicationContext()
final int	getInstanceId()
Looper	getLooper()
<L> ListenerHolder<L>	registerListener(Object arg0, String arg1)
zace	zaa(Context arg0, Handler arg1)
Api.Client	zaa(Looper arg0, zaa<Games.GamesOptions> arg1)
final zai<Games.GamesOptions>	zak()

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(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Public Methods

public Task<Bundle> getActivationHint ()

Returns a Task which asynchronously loads a Bundle that may contain an information regarding to the previous user's action.

The Task returned will not be null, but the Bundle returned from the Task may be null if it was already received or there is no related data found.

Unless a new user action is performed all the subsequent calls will return a Task with a null Bundle.

A Bundle 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).
• EXTRA_REQUESTS if the user wanted to accept one or more requests. The value contained here is a list of GameRequest objects which can be accessed with getParcelableArrayList(String).
• EXTRA_SNAPSHOT_METADATA if the user wanted to resume a saved game. The value contained here is a SnapshotMetadata object which can be accessed with getParcelable(String).
• EXTRA_QUEST if the user wanted to accept a specific quest. The value contained here is a Quest which can be accessed with getParcelable(String).

public Task<String> getAppId ()

Returns a Task which asynchronously loads the application ID linked to this client instance.

Required Scopes: SCOPE_GAMES_LITE

public Task<String> getCurrentAccountName ()

Returns a Task which asynchronously loads the name of the currently selected account. This is the account the user has chosen to use for Google Play Games.

The returned Task can fail with a RemoteException.

Note that your app must have <uses-permission android:name="android.permission.GET_ACCOUNTS" /> declared in your manifest in order to use this method. Otherwise the Task will fail with SecurityException.

public Task<Intent> getSettingsIntent ()

Returns a Task which asynchronously loads an Intent to show the Settings screen that allows the user to configure Games-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.

The returned Task can fail with a RemoteException.

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

Required Scopes: SCOPE_GAMES_LITE

public Task<Void> setGravityForPopups (int gravity)

Returns a Task which asynchronously sets the part of the screen at which games service pop-ups (for example, "welcome back" or "achievement unlocked" popups) will be displayed using gravity.

Default value is TOP|CENTER_HORIZONTAL.

Required Scopes: SCOPE_GAMES_LITE

Parameters

gravity	The gravity which controls the placement of games service pop-ups.

public Task<Void> setViewForPopups (View gamesContentView)

Returns a Task which asynchronously sets the View to use as a content view for popups.

Required Scopes: SCOPE_GAMES_LITE

Parameters

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