FeatureParam element represents a parameter specified for a
- ERROR(/SectionFeature).SectionFeature.
@@ -3551,7 +3557,7 @@ containing a value of this type.
The FeatureParam element represents a parameter specified for a
- ERROR(/SectionFeature).
+ SectionFeature.
Includes the following attributes:
Sets the content url for targeting purposes.
+
+ |
+
+
+
+ ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
+
+
+
+
+ + public + + + + + PublisherAdRequest.Builder + + setContentUrl + (String contentUrl) ++
+
+
+
+
+
+
+
+
+Sets the content url for targeting purposes. +
diff --git a/docs/html/reference/com/google/android/gms/ads/doubleclick/PublisherAdRequest.html b/docs/html/reference/com/google/android/gms/ads/doubleclick/PublisherAdRequest.html
index 570da678fd2fe07b37c7d38359babbd8dd396457..87b23867c238ed5391a6c807eb556fac5959f41f 100644
--- a/docs/html/reference/com/google/android/gms/ads/doubleclick/PublisherAdRequest.html
+++ b/docs/html/reference/com/google/android/gms/ads/doubleclick/PublisherAdRequest.html
@@ -459,12 +459,6 @@ onkeyup="return search_changed(event, false, '/')" />
Wallet
- Returns the content url targeting information.
+
+
+
+
+
+ + public + + + + + String + + getContentUrl + () ++
+
+
+
+
+
+
+
+
+Returns the content url targeting information. Returns
diff --git a/docs/html/reference/com/google/android/gms/ads/doubleclick/PublisherAdView.html b/docs/html/reference/com/google/android/gms/ads/doubleclick/PublisherAdView.html
index f644ddadf4c0f88b1afde169e6e8d0e7fcaf4796..2cbf6dd5b5feebb0c443c8e0ae9cd1f48fbab5f2 100644
--- a/docs/html/reference/com/google/android/gms/ads/doubleclick/PublisherAdView.html
+++ b/docs/html/reference/com/google/android/gms/ads/doubleclick/PublisherAdView.html
@@ -459,12 +459,6 @@ onkeyup="return search_changed(event, false, '/')" />
Wallet
-
diff --git a/docs/html/reference/com/google/android/gms/analytics/CampaignTrackingReceiver.html b/docs/html/reference/com/google/android/gms/analytics/CampaignTrackingReceiver.html
new file mode 100644
index 0000000000000000000000000000000000000000..673f149e04a971615142536a3521dc6019adff59
--- /dev/null
+++ b/docs/html/reference/com/google/android/gms/analytics/CampaignTrackingReceiver.html
@@ -0,0 +1,1607 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 
+
+
+
+
+
+to top
+
+
+
+
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
+
+  Known Indirect Subclasses
+
+
+
+
+
+
+ StandardExceptionParser
+
+
+
+
+ |
-
- This interface is deprecated.
- See SubmitScoreResult.
-
Class Overview
-Listener for getting status back after submitting a score to a leaderboard.
+This interface is responsible for parsing a Throwable and providing
+ a short, meaningful description to report to Google Analytics.
+
+ This class can be used in conjugation with the ExceptionReporter.
+
+ + UncaughtExceptionHandler myHandler = new ExceptionReporter( + myTracker, // Currently used Tracker. + GAServiceManager.getInstance(), // GAServiceManager singleton. + Thread.getDefaultUncaughtExceptionHandler(), // Current default uncaught exception handler. + context); // Context of the application. + + myHandler.setExceptionParser(new MyExceptionParser()); + // Where MyExceptionParser provides a custom description for various exceptions. +@@ -786,21 +852,22 @@ onkeyup="return search_changed(event, false, '/')" /> - +
Throwable suitable for
+ reporting to Google Analytics.- public - - - abstract - - void + public + + + abstract + + String - onScoreSubmitted - (int statusCode, SubmitScoreResult result) + getDescription + (String threadName, Throwable t)
Called when a leaderboard score has been submitted. The statusCode indicates whether or not - the score was successfully submitted to the servers. -
- Possible status codes include: -
-
-
STATUS_OKif the score was successfully submitted to the server. -
- STATUS_NETWORK_ERROR_OPERATION_DEFERREDif the device is offline or - was otherwise unable to post the score to the server. The score was stored locally and will - be posted to the server the next time the device is online and is able to perform a sync (no - further action is required from the client).
- STATUS_CLIENT_RECONNECT_REQUIREDif theGamesClientneeds to - reconnect to the service before attempting to submit the score.
- STATUS_LICENSE_CHECK_FAILEDif the game is not licensed to the user. -
- STATUS_INTERNAL_ERRORif an unexpected error occurred in the service. -
-
Return a short description of a Throwable suitable for
+ reporting to Google Analytics.
Parameters
| statusCode - | A status code indicating the result of the operation. | +threadName + | the name of the Thread that got the exception, or null |
|---|---|---|---|
| result - | Detailed results of the operation, which includes data regarding whether this
- was the new high score for any of the supported time spans. Note that the results
- will only be populated if statusCode is STATUS_OK.
- |
+ t + | the Throwable |
Returns
+- the description +
+From interface
+
+ java.lang.Thread.UncaughtExceptionHandler
+
+Throws
-| IOException - | If an I/O error occurs while performing the request. - | -
|---|
Returns
+- A
PendingResultwhich can be used to track the progress of the request. +
disconnect().+ + public + static + final + int + + CANCELED +
+The client canceled the connection by calling
+ disconnect(). Only returned by
+ blockingConnect(long, TimeUnit).
+
+ + public + static + final + int + + INTERRUPTED +
+An interrupt occurred while waiting for the connection complete. Only returned by
+ blockingConnect(long, TimeUnit).
+
+ + public + static + final + int + + TIMEOUT +
+The timeout was exceeded while waiting for the connection to complete. Only returned by
+ blockingConnect(long, TimeUnit).
+
+
+
+ -
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
+
-
+
- + Setup + + +
-
+ + + Reference + ++ + + + + + + + + ++ + + + + + + + diff --git a/docs/html/reference/com/google/android/gms/common/GooglePlayServicesClient.ConnectionCallbacks.html b/docs/html/reference/com/google/android/gms/common/GooglePlayServicesClient.ConnectionCallbacks.html index 9c84a1185aa886cc491400da732fdeb88b801cd6..12448d6c7d11b82cd4aee187f015ab8e79c5e5e9 100644 --- a/docs/html/reference/com/google/android/gms/common/GooglePlayServicesClient.ConnectionCallbacks.html +++ b/docs/html/reference/com/google/android/gms/common/GooglePlayServicesClient.ConnectionCallbacks.html @@ -459,12 +459,6 @@ onkeyup="return search_changed(event, false, '/')" /> Wallet
- + +
-
+
- + Overview + +
- + Getting Started + +
- + Implementing GCM Client + + +
- + User Notifications + +
- + Advanced Topics + +
- + Migration + +
-
+
+
+
+
+
+
+
+
++ ++ ++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ++ + + + ++ +Summary: + + + + + + + Inherited Constants + + + + + + | Ctors + + + + + | Methods + + + + + | Inherited Methods + +| [Expand All] + +++ + + + +++ public + + + + class ++ + + +
ErrorDialogFragment
+ + + + + + + + + + + + + extends DialogFragment
+ + + + + + + + + +++ ++ + +
+ + + + + + + ++ + + + +java.lang.Object ++ + + + +↳ + +android.app.Fragment ++ + + + +↳ + +android.app.DialogFragment ++ + + + +↳ + +com.google.android.gms.common.ErrorDialogFragment ++ + ++ + + + + + + + + + + + + + + + +Class Overview
+Wraps the
Dialogreturned by +getErrorDialog(int, Activity, int)by using +DialogFragmentso that it can be properly managed by the +Activity. ++ Use this class only if you are targeting API 12 and above. Otherwise, use + SupportErrorDialogFragment. +
+ + + + + ++ + ++ + + + + + + + + + + + + + + + + + + + + + + + + + +Summary
+ + + + + + + + + + + + + + + + + +
+ + + + + + + + + + ++ [Expand] + Inherited Constants+ + + + + + + + + + ++ + From class
+android.app.DialogFragment
+++++ ++ + + + + + + + + ++ + From interface
+android.content.ComponentCallbacks2
+++++ +
+ + + + + + + +Public Constructors + + + + ++ + + + + + ++ ErrorDialogFragment() + +
+ + + + + + + + +Public Methods + + + + ++ + + + static + + ErrorDialogFragment ++ newInstance(Dialog dialog, DialogInterface.OnCancelListener cancelListener) + +Create a+ +DialogFragmentfor displaying the +getErrorDialog(int, Activity, int)with an OnCancelListener.+ + + + ++ + + + static + + ErrorDialogFragment ++ newInstance(Dialog dialog) + +Create a+ +DialogFragmentfor displaying the +getErrorDialog(int, Activity, int).+ + + + ++ + + + + + void ++ onCancel(DialogInterface dialog) + ++ + + + ++ + + + + + Dialog ++ onCreateDialog(Bundle savedInstanceState) + +Returns a+ +Dialogcreated by +getErrorDialog(int, Activity, int)with the provided + errorCode, activity, request code, and cancel listener.+ + + + ++ + + + + + void ++ show(FragmentManager manager, String tag) + +
+ + ++ [Expand] + Inherited Methods+ + + + ++
+From class
+
+ android.app.DialogFragment
+
+++++ ++ + + + ++
+From class
+
+ android.app.Fragment
+
+++++ ++ + + + ++
+From class
+
+ java.lang.Object
+
+++++ ++ + + + ++
+From interface
+
+ android.content.ComponentCallbacks
+
+++++ ++ + + + ++
+From interface
+
+ android.content.ComponentCallbacks2
+
+++++ ++ + + + ++
+From interface
+
+ android.content.DialogInterface.OnCancelListener
+
+++++ ++ + + + ++
+From interface
+
+ android.content.DialogInterface.OnDismissListener
+
+++++ ++ + + ++
+From interface
+
+ android.view.View.OnCreateContextMenuListener
+
+++++ +Public Constructors
+ + + + + +++ + + + + + + + + + + + + ++ + public + + + + + + + ErrorDialogFragment + () +
++ + + + +++ +++ +Public Methods
+ + + + + +++ + + + ++ + public + static + + + + ErrorDialogFragment + + newInstance + (Dialog dialog, DialogInterface.OnCancelListener cancelListener) +
++ + + + +++ +++Create a
DialogFragmentfor displaying the +getErrorDialog(int, Activity, int)with an OnCancelListener.++Parameters
++
++ +dialog + The +Dialogcreated by +getErrorDialog(int, Activity, int).+ +cancelListener + A +DialogInterface.OnCancelListenerfor when a user cancels the + DialogFragment.++ +Returns
+- The
ErrorDialogFragment. +
++ + + + ++ + public + static + + + + ErrorDialogFragment + + newInstance + (Dialog dialog) +
++ + + + +++ +++Create a
DialogFragmentfor displaying the +getErrorDialog(int, Activity, int).++Parameters
++
++ +dialog + The +Dialogcreated by +getErrorDialog(int, Activity, int).++ +Returns
+- The
ErrorDialogFragment. +
++ + + + ++ + public + + + + + void + + onCancel + (DialogInterface dialog) +
++ + + + +++ +++ +++ + + + ++ + public + + + + + Dialog + + onCreateDialog + (Bundle savedInstanceState) +
++ + + + +++ +++Returns a
Dialogcreated by +getErrorDialog(int, Activity, int)with the provided + errorCode, activity, request code, and cancel listener.++ +Parameters
++
++ +savedInstanceState + Not used. + +++ + + + + + + + + + + + + ++ + public + + + + + void + + show + (FragmentManager manager, String tag) +
++ + + + +++ +++ + - The
-
-
- + +
- Setup + - -
- Setup + - -
- Setup +
AppStateManager and GoogleApiClient.
- GoogleApiClient and Games.
- + + public + static + + + + boolean + + showErrorDialogFragment + (int errorCode, Activity activity, int requestCode) +
+Display a DialogFragment for an error code returned by
+ isGooglePlayServicesAvailable(Context).
Parameters
+| errorCode + | error code returned by
+ isGooglePlayServicesAvailable(Context) call. If
+ errorCode is SUCCESS then this
+ does nothing. |
+
|---|---|
| activity + | parent activity for creating the dialog, also used for + identifying language to display dialog in. | +
| requestCode + | The requestCode given when calling + startActivityForResult. | +
Returns
+- true if the dialog is shown, false otherwise
Throws
+| RuntimeException + | if API level is below 11 and activity is not a
+ FragmentActivity. |
+
|---|
See Also
+ ++ + public + static + + + + boolean + + showErrorDialogFragment + (int errorCode, Activity activity, int requestCode, DialogInterface.OnCancelListener cancelListener) +
+Display a DialogFragment for an error code returned by
+ isGooglePlayServicesAvailable(Context).
Parameters
+| errorCode + | error code returned by
+ isGooglePlayServicesAvailable(Context) call. If
+ errorCode is SUCCESS then this
+ does nothing |
+
|---|---|
| activity + | parent activity for creating the dialog, also used for + identifying language to display dialog in. | +
| requestCode + | The requestCode given when calling + startActivityForResult. | +
| cancelListener + | The DialogInterface.OnCancelListener to
+ invoke if the dialog is canceled. |
+
Returns
+- true if the dialog is shown, false otherwise.
Throws
+| RuntimeException + | if API level is below 11 and activity is not a
+ FragmentActivity. |
+
|---|
See Also
+ ++ + public + static + final + String + + DRIVE_APPFOLDER +
+Scope for accessing appfolder files from Google Drive. +
Scopes for access user-authorized files from Google Drive. +
Scope for access user-authorized files from Google Drive.
+ + public + static + final + String + + DRIVE_FULL +
+Scope for access to all of a user's files in Google Drive. +
GoogleApiClient to service the call. The client must be
- connected using connect() before invoking this method.
+ connected using connect() before invoking this method.
GoogleApiClient to service the call. The client must be
- connected using connect() before invoking this method.
+ connected using connect() before invoking this method.
GoogleApiClient to service the call. The client must be
- connected using connect() before invoking this method.connect() before invoking this method.
GoogleApiClient to service the call. The client must be
- connected using connect() before invoking this method.connect() before invoking this method.
GoogleApiClient to service the call. The client must be
- connected before invoking this method.
+ connected before invoking this method.
+ + public + + + abstract + + PendingResult<Status> + + commitAndCloseContents + (GoogleApiClient apiClient, Contents contents, MetadataChangeSet changeSet) +
+Closes the previously opened contents, updates the Metadata associated with this file, and
+ commits any changes if the contents were open for write. After invoking this method, the
+ contents are no longer valid. New contents should not be closed via this method. Instead,
+ use them to create a new file via
+ createFile(GoogleApiClient, MetadataChangeSet, Contents) or
+ newCreateFileActivityBuilder().
Parameters
+| apiClient + | The GoogleApiClient to service the call. The client must be
+ connected before invoking this method. |
+
|---|---|
| contents + | The contents that will be saved and closed. | +
| changeSet + | The set of changes that will be applied to the Metadata. Only include the + specific fields that should be updated. | +
Returns
+- a PendingResult which can be used to verify the success of the operation. +
GoogleApiClient to service the call. The client must be
- connected before invoking this method.GoogleApiClient to service the call. The client must be
- connected before invoking this method.MODE_READ_ONLY, MODE_READ_WRITE and MODE_WRITE_ONLY.MODE_READ_ONLY, MODE_READ_WRITE and MODE_WRITE_ONLY.
null.null.
GoogleApiClient to service the call. The client must be
- connected before invoking this method.GoogleApiClient to service the call. The client must be
- connected before invoking this method.+ + public + + + abstract + + PendingResult<Status> + + addChangeListener + (GoogleApiClient apiClient, Listener<ChangeEvent> listener) +
+Adds a new listener for changes on this resources. The listener will remain active for
+ the duration of the current GoogleApiClient connection or until the
+ removeChangeListener(GoogleApiClient, DriveEvent.Listener method is called with the same listener argument.
See Also
+ ++ + public + + + abstract + + PendingResult<DriveApi.MetadataBufferResult> + + listParents + (GoogleApiClient apiClient) +
+Retrieves a collection of metadata for all of the parents of this resource that the calling + app has been authorized to view.
Parameters
+| apiClient + | The GoogleApiClient to service the call. |
+
|---|
Returns
+- a PendingResult which can be used to retrieve the parents list. +
+ + public + + + abstract + + PendingResult<Status> + + removeChangeListener + (GoogleApiClient apiClient, Listener<ChangeEvent> listener) +
+Removes a listener for changes on this resource that was previously added by
GoogleApiClient to service the call. The client must be
- connected when this method is invoked.CONTENT_NOT_AVAILABLE_LOCALLY when the content is not available on
+ the device or CONTENT_AVAILABLE_LOCALLY when the content is available on the
+ device.|
- [Expand]
- Inherited Methods | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
-
-From class
+ Date
+ |
+ Returns the last time this resource was modified by anyone.
-
-
-
-
-
- | ||||||||||||
|
- |
-From interface
- com.google.android.gms.common.data.Freezable
-
-
-
-
-
- | ||||||||||||
Public Constructors
- -- - public - - - - - - - Metadata - () -
-|
+ [Expand]
+ Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
+
+From class
+
+ java.lang.Object
+
+
+
+
+
+
+ | |||||||||||
|
+
+From interface
+
+ com.google.android.gms.common.data.Freezable
+
+
+
+
+
+
+ | |||||||||||
Constants
+ + + + + + ++ + public + static + final + int + + CONTENT_AVAILABLE_LOCALLY +
+The content is available on the device. +
+ + public + static + final + int + + CONTENT_NOT_AVAILABLE_LOCALLY +
+The content is not available on the device. +
Public Constructors
+ + + + + ++ + public + + + + + + + Metadata + () +
+Public Methods
+ + + + + ++ + public + + + + + String + + getAlternateLink + () +
+Returns a link for opening the file using a relevant Google editor or viewer. +
+ + public + + + + + int + + getContentAvailability + () +
+Returns CONTENT_NOT_AVAILABLE_LOCALLY when the content is not available on
+ the device or CONTENT_AVAILABLE_LOCALLY when the content is available on the
+ device.
+
+ + public + + + + + Date + + getCreatedDate + () +
+Returns the create time for this resource. +
+ + public + + + + + String + + getDescription + () +
+A short description of the file. +
+ + public + + + + + DriveId + + getDriveId + () +
+Returns the id of the resource
+ + public + + + + + String + + getEmbedLink + () +
+A link for embedding the file. +
+ + public + + + + + String + + getFileExtension + () +
+The file extension used when downloading this file. +
+ + public + + + + + long + + getFileSize + () +
+The size of the file in bytes. + +
This is only populated for files with content stored in Drive. +
+ + public + + + + + Date + + getLastViewedByMeDate + () +
+Returns the last time this resource was viewed by the user. +
+ + public + + + + + String + + getMimeType + () +
+Returns the MIME type of the resource
+ + public + + + + + Date + + getModifiedByMeDate + () +
+Returns the last time this resource was modified by the user. +
+ + public + + + + + Date + + getModifiedDate + () +
+Returns the last time this resource was modified by anyone. +
+ + public - - + String + + getOriginalFilename + () +
+Public Methods
++ + public + + + + + long + + getQuotaBytesUsed + () +
+The number of quota bytes used by this file. +
@@ -1430,7 +2282,7 @@ From interface Date - getCreatedDate + getSharedWithMeDate ()
Returns the create time for this resource. +
Returns the time at which this resource was shared with the user.
@@ -1458,9 +2310,9 @@ From interface - DriveId + String - getDriveId + getTitle ()
Returns the id of the resource
Returns the title of the resource
@@ -1489,7 +2341,7 @@ From interface String - getMimeType + getWebContentLink ()
Returns the MIME type of the resource
A link for downloading the content of the file in a browser using cookie based + authentication. +
@@ -1516,9 +2370,9 @@ From interface - Date + String - getModifiedByMeDate + getWebViewLink ()
Returns the last time this resource was modified by the user. +
A link only available on public folders for viewing their static web assets (HTML, CSS, JS, + etc) via Google Drive's Website Hosting.
@@ -1546,9 +2401,9 @@ From interface - Date + boolean - getModifiedDate + isEditable ()
Returns the last time this resource was modified by anyone. +
Returns true if this resource can be edited by the current user.
@@ -1576,9 +2431,9 @@ From interface - Date + boolean - getSharedWithMeDate + isFolder ()
Returns the time at which this resource was shared with the user. +
Returns true if this Metadata is for a folder.
@@ -1606,9 +2461,9 @@ From interface - String + boolean - getTitle + isInAppFolder ()
Returns the title of the resource
Returns true if this resource is in the Application Folder. + +
The App Folder contains hidden files stored in a user's Drive that are only + accessible to the creating app. @see + https://developers.google.com/drive/appdata +
@@ -1637,7 +2497,7 @@ From interface boolean - isEditable + isPinnable ()
Returns true if this resource can be edited by the current user. +
Returns true if the file can be pinned. Not all shortcut app MIME types are pinnable.
@@ -1667,7 +2527,7 @@ From interface boolean - isFolder + isPinned ()
Returns true if this Metadata is for a folder. +
Returns true if this resource has been pinned (a request has been made to make the content + available offline). +
+ + public + + + + + boolean + + isRestricted + () +
+Whether viewers are prevented from downloading this file. +
+ + public + + + + + boolean + + isShared + () +
+Returns true if this resource is a shared resource.
+ + public + + + + + boolean + + isViewed + () +
+Whether this file has been viewed by this user. +
+ + public + + + + + MetadataChangeSet.Builder + + setIndexableText + (String text) +
++ + public + + + + + MetadataChangeSet.Builder + + setLastViewedByMeDate + (Date date) +
++ + public + + + + + MetadataChangeSet.Builder + + setPinned + (boolean pinned) +
++ + public + + + + + MetadataChangeSet.Builder + + setViewed + (boolean viewed) +
++ + public + + + + + String + + getIndexableText + () +
++ + public + + + + + Date + + getLastViewedByMeDate + () +
++ + public + + + + + Boolean + + isPinned + () +
++ + public + + + + + Boolean + + isViewed + () +
+| apiClient - | The GoogleApiClient to service the call. The client must be connected
- before invoking this method.
+ | The GoogleApiClient to service the call. The client must be
+ connected
+ before invoking this method.
|
|---|
+
+
+ -
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
+
-
+
- + Setup + + +
-
+ + + Reference + +@@ -141,7 +141,7 @@ href="//fonts.googleapis.com/css?family=Roboto:regular,medium,thin,italic,medium ru-lang="Проектирование" ko-lang="디자인" ja-lang="設計" - es-lang="Diseñar" + es-lang="Diseñar" >Design+ + + + + + + + + ++ + + + + + + + diff --git a/docs/html/reference/com/google/android/gms/games/OnSignOutCompleteListener.html b/docs/html/reference/com/google/android/gms/drive/events/DriveEvent.Listener.html similarity index 90% rename from docs/html/reference/com/google/android/gms/games/OnSignOutCompleteListener.html rename to docs/html/reference/com/google/android/gms/drive/events/DriveEvent.Listener.html index 6ac2c4acbdc85b468880eab074391ed2e68730d7..5c6438d997e6b614d56a45b76fd516b0dc13e43d 100644 --- a/docs/html/reference/com/google/android/gms/games/OnSignOutCompleteListener.html +++ b/docs/html/reference/com/google/android/gms/drive/events/DriveEvent.Listener.html @@ -83,7 +83,7 @@ -
- + +
-
+
- + Overview + +
- + Getting Started + +
- + Implementing GCM Client + + +
- + User Notifications + +
- + Advanced Topics + +
- + Migration + +
-
+
+
+
+
+
+
+
+
++ ++ ++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ++ + + + ++ +Summary: + + + + + + + Inherited Constants + + + + | Fields + + + + + + + | Methods + + + + + | Inherited Methods + +| [Expand All] + +++ + + + +++ public + + final + + class ++ + + +
ChangeEvent
+ + + + + extends Object
+ + + + + + + implements + + Parcelable + + ResourceEvent + + + + + +++ ++ + +
+ + + + + + + ++ + + + +java.lang.Object ++ + + + +↳ + +com.google.android.gms.drive.events.ChangeEvent ++ + ++ + + + + + + + + + + + + + + + +Class Overview
+Sent when a
+ + + + + +DriveResourcehas had a change to itsContentsorMetadata. + Refer toDriveEventfor additional information about event listeners. + + Refer toDriveEventfor general information about event listeners and +addChangeListener(GoogleApiClient, DriveEvent.Listenerfor how to create them. +) + + ++ + + + + + + + + + + + + + + + + + + + + + + +Summary
+ + + + + + + + + + + + + + + + + +
+ + + + + ++ [Expand] + Inherited Constants+ + + + ++ + From interface
+android.os.Parcelable
+++++ ++ + + + + ++ + From interface
+com.google.android.gms.drive.events.DriveEvent
+++++ +
+ + + + + + + + + + + + +Fields + + + + ++ public + static + final + Creator<ChangeEvent> CREATOR ++
+ + + + + + + + +Public Methods + + + + ++ + + + + + int ++ describeContents() + ++ + + + ++ + + + + + DriveId ++ getDriveId() + +Returns the+ +DriveIdof the resource that has changed.+ + + + ++ + + + + + int ++ getType() + +Returns the type of an event.+ ++ + + + ++ + + + + + boolean ++ hasContentChanged() + +Returns+ +trueif the content has changed for this resource.+ + + + ++ + + + + + boolean ++ hasMetadataChanged() + +Returns+ +trueif the metadata has changed for this resource.+ + + + ++ + + + + + String ++ toString() + ++ + + + ++ + + + + + void ++ writeToParcel(Parcel dest, int flags) + +
+ + ++ [Expand] + Inherited Methods+ + + + ++
+From class
+
+ java.lang.Object
+
+++++ ++ + + + ++
+From interface
+
+ android.os.Parcelable
+
+++++ ++ + + + ++
+From interface
+
+ com.google.android.gms.drive.events.DriveEvent
+
+++++ ++ + + ++
+From interface
+
+ com.google.android.gms.drive.events.ResourceEvent
+
+++++ +Fields
+ + + + + + + + + + + + + + + + + + + + + + + +Public Methods
+ + + + + +++ + + + ++ + public + + + + + int + + describeContents + () +
++ + + + +++ +++ +++ + + + ++ + public + + + + + DriveId + + getDriveId + () +
++ + + + +++ +++ +Returns the
DriveIdof the resource that has changed. +++ + + + ++ + public + + + + + int + + getType + () +
++ + + + +++ +++ +Returns the type of an event. See the
TYPE_*constants for possible values. +++ + + + ++ + public + + + + + boolean + + hasContentChanged + () +
++ + + + +++ +++ +Returns
trueif the content has changed for this resource. +++ + + + ++ + public + + + + + boolean + + hasMetadataChanged + () +
++ + + + +++ +++ +Returns
trueif the metadata has changed for this resource. +++ + + + ++ + public + + + + + String + + toString + () +
++ + + + +++ +++ +++ + + + + + + + + + + + + ++ + public + + + + + void + + writeToParcel + (Parcel dest, int flags) +
++ + + + +++ +++ +
OnSignOutCompleteListener | Android Developers +DriveEvent.Listener | Android Developers - + +
- Develop
- Distribute
public - - - + static + + interface -@@ -705,10 +711,10 @@ onkeyup="return search_changed(event, false, '/')" />OnSignOutCompleteListener
+DriveEvent.Listener
+ + + - - -- - - + @@ -719,15 +725,11 @@ onkeyup="return search_changed(event, false, '/')" />com.google.android.gms.games.OnSignOutCompleteListener + +com.google.android.gms.drive.events.DriveEvent.Listener<E extends com.google.android.gms.drive.events.DriveEvent> --
- This interface is deprecated.
- SeePendingResult. -Class Overview
-Listener for receiving a callback when a sign-out is complete.
+Listens for Drive events of a particular type. +
@@ -786,21 +788,19 @@ onkeyup="return search_changed(event, false, '/')" /> - +abstract - - - - + + + + void - onSignOutComplete() - -Called once the signout operation is complete.- + onEvent(E event) ++@@ -141,7 +141,7 @@ href="//fonts.googleapis.com/css?family=Roboto:regular,medium,thin,italic,medium ru-lang="Проектирование" ko-lang="디자인" ja-lang="設計" - es-lang="Diseñar" + es-lang="Diseñar" >Design@@ -893,17 +892,17 @@ onkeyup="return search_changed(event, false, '/')" /> diff --git a/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/OnTurnBasedMatchInitiatedListener.html b/docs/html/reference/com/google/android/gms/drive/events/DriveEvent.html similarity index 72% rename from docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/OnTurnBasedMatchInitiatedListener.html rename to docs/html/reference/com/google/android/gms/drive/events/DriveEvent.html index 688ae0cfdbfc0583e34d365da511bed00953eb65..7853ac0ba7eb4ac7be24e9821c7e953189aed78e 100644 --- a/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/OnTurnBasedMatchInitiatedListener.html +++ b/docs/html/reference/com/google/android/gms/drive/events/DriveEvent.html @@ -83,7 +83,7 @@ -- public - - - abstract - + public + + + abstract + void - onSignOutComplete - () + onEvent + (E event)
- - + +- -+ +Called once the signout operation is complete. -
OnTurnBasedMatchInitiatedListener | Android Developers +DriveEvent | Android Developers - Develop
- Distribute
- +- - + + - - - + + + - - - + + +- + @@ -667,32 +673,52 @@ onkeyup="return search_changed(event, false, '/')" /> + + + + + + + + +@@ -702,17 +728,22 @@ Summary:Summary: + Nested Classes + + + + + + | Constants + | Inherited Constants - Methods - + | Methods + + + | Inherited Methods + | [Expand All]- - - + + +public - - - + + + interface -@@ -724,10 +755,10 @@ Summary:OnTurnBasedMatchInitiatedListener
+DriveEvent
+ + + + + + implements + + Parcelable - - -- - - + @@ -746,27 +777,27 @@ Summary:com.google.android.gms.games.multiplayer.turnbased.OnTurnBasedMatchInitiatedListener + +com.google.android.gms.drive.events.DriveEvent @@ -775,15 +806,20 @@ Summary:--
- This interface is deprecated.
- SeeTurnBasedMultiplayer.InitiateMatchResult. -Class Overview
-Listener for receiving callbacks when a match has been initiated.
+Base interface implemented by all Drive event types. An application can express interest in + receiving events by adding an event listener. +
+ An event listener implements the
@@ -813,17 +849,99 @@ Summary: + +DriveEvent.Listenerinterface for a particular event type and + receives a direct callback from the Drive service to a client application that is + currently connected. A listener is added by calling the appropriate +addmethod on theListener DriveResourceof interest or on +DriveApifor listeners that are not resource-specific. Listeners are active for the + duration of the current connection or until theremovemethod is + called on the same entity with the same callback parameter. +Listener
@@ -746,27 +780,21 @@ Summary:Nested Classes + + + + + + + + + + + + + + + + + ++ + + + + interface DriveEvent.Listener<E extends DriveEvent> +Listens for Drive events of a particular type. +
+ + + + +Constants + + + + +int +TYPE_CHANGE +Event type that indicates a resource change. +
@@ -842,21 +960,21 @@ Summary: - ++ [Expand] + Inherited Constants+ ++ From interface
+android.os.Parcelable
+++++ +abstract - - - - - void + + + + + int- onTurnBasedMatchInitiated(int statusCode, TurnBasedMatch match) - -Called when match has been initiated.- + getType() + +Returns the type of an event.+
+ + @@ -889,6 +1073,56 @@ Summary: + ++ [Expand] + Inherited Methods+ + + ++
+From interface
+
+ android.os.Parcelable
+
+++++ +Constants
+ + + + + + +++ + + + @@ -908,63 +1142,31 @@ Summary: - + -+ + public + static + final + int + + TYPE_CHANGE +
++ + + + +++ +++Event type that indicates a resource change.
++ + +See Also
+ ++ Constant Value: + + + 1 + (0x00000001) + + ++ ++@@ -141,7 +141,7 @@ href="//fonts.googleapis.com/css?family=Roboto:regular,medium,thin,italic,medium ru-lang="Проектирование" ko-lang="디자인" ja-lang="設計" - es-lang="Diseñar" + es-lang="Diseñar" >Design@@ -981,17 +1183,17 @@ Summary: diff --git a/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/OnTurnBasedMatchCanceledListener.html b/docs/html/reference/com/google/android/gms/drive/events/ResourceEvent.html similarity index 73% rename from docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/OnTurnBasedMatchCanceledListener.html rename to docs/html/reference/com/google/android/gms/drive/events/ResourceEvent.html index 92800bdd8a1d0da944267da6df10294b8824f984..69c91a1cf5a4c41825eff66ebd3308d84a3b8d08 100644 --- a/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/OnTurnBasedMatchCanceledListener.html +++ b/docs/html/reference/com/google/android/gms/drive/events/ResourceEvent.html @@ -83,7 +83,7 @@ -- public - - - abstract - - void + public + + + abstract + + int - onTurnBasedMatchInitiated - (int statusCode, TurnBasedMatch match) + getType + ()
- - + +- --Called when match has been initiated. This happens when the player creates a new match, or - when the player joins an existing match. Possible status codes include: -
-
-
STATUS_OKif data was successfully loaded and is up-to-date.
- STATUS_MATCH_ERROR_ALREADY_REMATCHEDif this is an attempt to rematch - a match which has already had a rematch created.
- STATUS_NETWORK_ERROR_OPERATION_FAILEDif the attempt to initiate the - match failed due to network error. -STATUS_MULTIPLAYER_ERROR_NOT_TRUSTED_TESTERif one of the users in - the match is not a trusted tester of a game which is not yet published.
- STATUS_MULTIPLAYER_ERROR_INVALID_OPERATIONif the server rejected the - operation.
- STATUS_MULTIPLAYER_DISABLEDif the game does not support multiplayer. -
- STATUS_CLIENT_RECONNECT_REQUIREDif theGamesClientneeds to - reconnect to the service to perform this operation.
- STATUS_INTERNAL_ERRORif an unexpected error occurred in the service. -
-
-+ +Parameters
--
-- -statusCode - A status code indicating the result of the operation. -- -match - The newly initiated -TurnBasedMatchobject. Note that this may be null, - depending on the status code returned. -Returns the type of an event. See the
TYPE_*constants for possible values. +OnTurnBasedMatchCanceledListener | Android Developers +ResourceEvent | Android Developers - Develop
- Distribute
- +- - - TurnBasedMultiplayerListener - - + + + ChangeEvent + +@@ -775,15 +803,11 @@ Summary:-@@ -908,61 +1120,32 @@ Summary: - + --
- This interface is deprecated.
- SeeTurnBasedMultiplayer.CancelMatchResult. -Class Overview
-Listener for receiving callbacks when a match has been canceled.
+Base interface for
@@ -826,6 +850,83 @@ Summary: + +DriveEventtypes related to a specific resource. +
+ + @@ -842,31 +943,142 @@ Summary: - ++ [Expand] + Inherited Constants+ + + + ++ + From interface
+android.os.Parcelable
+++++ ++ + + ++ + From interface
+com.google.android.gms.drive.events.DriveEvent
+++++ +abstract - - - - - void + + + + + DriveId ++ getDriveId() + +Returns the id of the Drive resource that triggered the event, or+ +nullif not + resource-specific.+ [Expand] + Inherited Methods+ + + + ++
+From interface
+
+ android.os.Parcelable
+
+++++ ++ ++
+From interface
+
+ com.google.android.gms.drive.events.DriveEvent
+
+++++ ++@@ -979,17 +1162,17 @@ Summary: diff --git a/docs/html/reference/com/google/android/gms/drive/events/package-summary.html b/docs/html/reference/com/google/android/gms/drive/events/package-summary.html new file mode 100644 index 0000000000000000000000000000000000000000..caa0c2181df70e833c62a34d8005fcff05455fdf --- /dev/null +++ b/docs/html/reference/com/google/android/gms/drive/events/package-summary.html @@ -0,0 +1,779 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +- public - - - abstract - - void + public + + + abstract + + DriveId - onTurnBasedMatchCanceled - (int statusCode, String matchId) + getDriveId + ()
- - + +- --Called when the match has been canceled. Possible status codes include: -
-
-
STATUS_OKif the match was successfully canceled.
- STATUS_NETWORK_ERROR_OPERATION_DEFERREDif the attempt to leave the - match resulted in a network error. The operation was stored locally, and will be retried the - next time the device comes online. No further action is required.
- STATUS_MATCH_ERROR_LOCALLY_MODIFIEDif the match has already been - modified locally and has changes waiting to be synced to the server. The cancel operation was - not executed.
- STATUS_MULTIPLAYER_ERROR_INVALID_OPERATIONif the server rejected the - operation.
- STATUS_MULTIPLAYER_DISABLEDif the game does not support multiplayer. -
- STATUS_CLIENT_RECONNECT_REQUIREDif theGamesClientneeds to - reconnect to the service to perform this operation.
- STATUS_INTERNAL_ERRORif an unexpected error occurred in the service. -
-
-+ +Parameters
--
-- -statusCode - A status code indicating the result of the operation. -- -matchId - The ID of the match that was canceled. - -Returns the id of the Drive resource that triggered the event, or
nullif not + resource-specific. +com.google.android.gms.drive.events | Android Developers + + + + + + + + + + + + + + + + + + + + + + + +++ + + + + + + + + + + + + + + + + + + ++++ ++ + + + + + + +
+
+
+ +
Protected Constructors
- - - - - -- - protected - - - - - - - CollectionMetadataField - (String fieldName) -
-+ + public + + final + + + int + + getVersionAdded + () +
+Returns the version of GMS Core that this field was added in. See + GmsVersion for a list of version numbers. +
Protected Constructors
- - - - - -- - protected - - - - - - - OrderedMetadataField - (String fieldName) -
-- - protected - - - - - - - OrderedMetadataField - (String fieldName, Collection<String> dataHolderFieldNames) -
-filters.value is a substring of field.filters.@@ -1427,7 +1432,7 @@ From class Filter and - (List<Filter> filters) + (Iterable<Filter> filters)
Returns a filter that matches items which are matched by all of the provided filter - parameters. +
Returns a filter which checks whether value is a substring of field.
+ This filter can only be used with fields that contain a string value.
Returns a filter which checks if the value of field is greater than or equal to
- value.
+ value. This filter can only be used with fields that have a sort order.
@@ -1703,7 +1708,7 @@ From class Filter or - (List<Filter> filters) + (Iterable<Filter> filters)
+ + public + static + final + MetadataField<Boolean> + + IS_PINNED +
+Whether the user has pinned the item. +
+ + public + static + final + OrderedMetadataField<Date> + + LAST_VIEWED_BY_ME +
+The date this resource was most recently viewed by the user. +
+ + public + + + + + String + + getFeaturedImageUrl + () +
++ + public + + + + + String + + getHiResImageUrl + () +
++ + public + + + + + String + + getIconImageUrl + () +
++ + public + + + + + boolean + + isMuted + () +
+| Constants | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| String | +EXTRA_PLAYER_IDS | +Used to return a list of player IDs. | +|||||||||
Constants
+ + + + + + ++ + public + static + final + String + + EXTRA_PLAYER_IDS +
+Used to return a list of player IDs. Retrieve with
+ getStringArrayListExtra(String).
+
+ Also used to pass in a list of player IDs for preselecting players. Set with
+ putStringArrayListExtra(String, java.util.ArrayList).
See Also
+ ++ + public + static + final + Requests + + Requests +
+Methods for interacting with requests. +
+ + public + static + final + int + + RESULT_SEND_REQUEST_FAILED +
+Result code sent back to the calling Activity when sending a request from the "send request" + screen failed. The logs will contain more detailed information.
See Also
+ +
-
-
- -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - Setup - -
-
- - - Reference - -- - - - - - - - - -
- - -
-
-
- - Overview - -
- - Getting Started - -
- - Implementing GCM Client - - -
- - User Notifications - -
- - Advanced Topics - -
- - Migration - -
-
-
-
-
-
-
-
-
-
-- -- - - - - - - - - - - - - - - - - - -- - - - -- -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.
- - - - - -
- SeeGoogleApiClientandGames. - -- - -@@ -1042,6 +1055,44 @@ onkeyup="return search_changed(event, false, '/')" /> + + +Summary
- - - - -
@@ -917,8 +930,8 @@ onkeyup="return search_changed(event, false, '/')" /> Constant Value: - -1 - (0xffffffff) + 7 + (0x00000007)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
-
----- -- - - --
-From interface
-
- com.google.android.gms.common.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 withgetParcelableExtra(String)- orgetParcelable(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
- -- 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
- -- 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
- -- 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
- -- Constant Value: - - - "player_search_results" - - -- --- - - - - -- - public - static - final - String - - EXTRA_ROOM -
-- - - - --- --- - -Used to return a
Room. Retrieve withgetParcelableExtra(String). -- Constant Value: - - - "room" - - -- --- - - - - -- - public - static - final - String - - EXTRA_TURN_BASED_MATCH -
-- - - - --- --- - -Used to return a
TurnBasedMatch. Retrieve with -getParcelableExtra(String)orgetParcelable(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.
-
- SeeacceptInvitation(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.
-
- SeecancelMatch(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.
-
- SeecancelMatch(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.
-
- SeeclearAll(GoogleApiClient)- -- -Clear all notifications for the current game and signed-in player.
-- - - - -- - public - - - - - void - - clearNotifications - (int notificationTypes) -
-- - - - -----
- This method is deprecated.
-
- Seeclear(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.
-
- Seeconnect(). - --Connect to the games service. -
- This method should be called fromonStart()or -onStart(). - - This method will return immediately, and -onConnected(Bundle)will be called if the - connection is successful. -- The Bundle provided to
onConnectedmay be null. If not null, it can contain the - following keys: --
-
EXTRA_INVITATIONif the user wanted to accept an invitation to a multiplayer - game. The value contained here is anInvitationwhich can be accessed with -getParcelable(String).
- EXTRA_TURN_BASED_MATCHif the user wanted to take action in a turn-based match. - The value contained here is aTurnBasedMatchwhich can be accessed with -getParcelable(String).
-
-- -See Also
- --- - - - -- - public - - - - - void - - createRoom - (RoomConfig config) -
-- - - - -----
- This method is deprecated.
-
- Seecreate(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 callbackonRoomCreated(int, Room)to - the given RoomUpdateListener in theRoomConfig. 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.
-
- SeecreateMatch(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
- --- - - - -- - public - - - - - void - - declineRoomInvitation - (String invitationId) -
-- - - - -----
- This method is deprecated.
-
- SeedeclineInvitation(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.
-
- SeedeclineInvitation(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.
-
- Seedisconnect(). - -- -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.
-
- SeedismissInvitation(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.
-
- SeedismissInvitation(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.
-
- SeedismissMatch(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.
-
- SeefinishMatch(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 -ParticipantResultobjects for this match. The client which - callsfinishMatchis 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.
-
- SeefinishMatch(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_COMPLETEif 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.
-
- SeefinishMatch(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 -ParticipantResultobjects for this match. The client which - callsfinishMatchis 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
- --- - - - -- - public - - - - - Intent - - getAchievementsIntent - () -
-- - - - -----
- This method is deprecated.
-
- SeegetAchievementsIntent(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_REQUIREDmay be returned as the - resultCode inonActivityResult(int, int, Intent)if the GamesClient ends up in an inconsistent - state.-- -Returns
-- An
Intentthat can be started to view the currently signed in player's - achievements.
-- - - - -- - public - - - - - Intent - - getAllLeaderboardsIntent - () -
-- - - - -----
- This method is deprecated.
-
- SeegetAllLeaderboardsIntent(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_REQUIREDmay be returned as the - resultCode inonActivityResult(int, int, Intent)if the GamesClient ends up in an inconsistent - state.-- -Returns
-- An
Intentthat can be started to view the list of leaderboards for a game.
-- - - - -- - public - - - - - String - - getAppId - () -
-- - - - -----
- This method is deprecated.
-
- SeegetAppId(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.
-
- SeegetCurrentAccountName(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
GamesClientmust 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_ACCOUNTSpermission.-- - - - -- - public - - - - - Game - - getCurrentGame - () -
-- - - - -----
- This method is deprecated.
-
- SeegetCurrentGame(GoogleApiClient). - ---- -Returns
-Gamemetadata for the current game. May be null if the metadata is not - available locally.
-- - - - -- - public - - - - - Player - - getCurrentPlayer - () -
-- - - - -----
- This method is deprecated.
-
- SeegetCurrentPlayer(GoogleApiClient). - ---- -Returns
-Playerrepresenting 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.
-
- SeegetCurrentPlayerId(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.
-
- SeegetInvitationInboxIntent(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 beRESULT_OKand the data - intent will contain the selected invitation as a parcelable extra in -EXTRA_INVITATION.-- -Returns
-- An
Intentthat can be started to view the invitation inbox UI.
-- - - - -- - public - - - - - Intent - - getLeaderboardIntent - (String leaderboardId) -
-- - - - -----
- This method is deprecated.
-
- SeegetLeaderboardIntent(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_REQUIREDmay be returned as the - resultCode inonActivityResult(int, int, Intent)if the GamesClient ends up in an inconsistent - state.--Parameters
--
-- -leaderboardId - The ID of the leaderboard to view. --- -Returns
-- An
Intentthat can be started to view the specified leaderboard.
-- - - - -- - public - - - - - Intent - - getMatchInboxIntent - () -
-- - - - -----
- This method is deprecated.
-
- SeegetInboxIntent(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 beRESULT_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_MATCHorEXTRA_INVITATION.-- -Returns
-- An
Intentthat can be started to view the match inbox.
-- - - - -- - public - - - - - int - - getMaxTurnBasedMatchDataSize - () -
-- - - - -----
- This method is deprecated.
-
- SeegetMaxMatchDataSize(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.
-
- SeegetPlayerSearchIntent(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 inEXTRA_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
Intentthat can be started to display the player selector.
-- - - - -- - public - - - - - Intent - - getRealTimeSelectOpponentsIntent - (int minPlayers, int maxPlayers, boolean allowAutomatch) -
-- - - - -----
- This method is deprecated.
-
- SeegetSelectOpponentsIntent(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, -
minPlayerswould be 1 andmaxPlayerswould be 3. -- If the user canceled, the result will be
RESULT_CANCELED. If the user - selected players, the result will beRESULT_OK, and the data intent will - contain the selected player IDs inEXTRA_PLAYERSand the minimum and maximum numbers - of additional auto-match players inEXTRA_MIN_AUTOMATCH_PLAYERSand -EXTRA_MAX_AUTOMATCH_PLAYERSrespectively. The player IDs inEXTRA_PLAYERS- will include only the other players selected, not the current player. -- If the
allowAutomatchparameter 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
Intentthat can be started to display the player selector.
-- - - - -- - public - - - - - Intent - - getRealTimeSelectOpponentsIntent - (int minPlayers, int maxPlayers) -
-- - - - -----
- This method is deprecated.
-
- SeegetSelectOpponentsIntent(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, -
minPlayerswould be 1 andmaxPlayerswould be 3. -- If the user canceled, the result will be
RESULT_CANCELED. If the user - selected players, the result will beRESULT_OK, and the data intent will - contain the selected player IDs inEXTRA_PLAYERSand the minimum and maximum numbers - of additional auto-match players inEXTRA_MIN_AUTOMATCH_PLAYERSand -EXTRA_MAX_AUTOMATCH_PLAYERSrespectively. The player IDs inEXTRA_PLAYERS- will include only the other players selected, not the current player. -- This method is the equivalent of calling -
getRealTimeSelectOpponentsIntent(int, int, boolean)with theallowAutomatch- 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
Intentthat can be started to display the player selector.
-- -See Also
- --- - - - -- - public - - - - - RealTimeSocket - - getRealTimeSocketForParticipant - (String roomId, String participantId) -
-- - - - -----
- This method is deprecated.
-
- SeegetSocketForParticipant(GoogleApiClient, String, String)- --Returns a
RealTimeSocketfor 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 -IllegalArgumentExceptionif 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.
-
- SeegetWaitingRoomIntent(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 beRESULT_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
Roomobject inEXTRA_ROOMthat 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. SettingminParticipantsToStartto 0 means that "Start playing" will - always be available, and a value ofMAX_VALUEwill 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 isRESULT_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 -Roomobject 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
Intentthat can be started to display the waiting room screen.
-- -See Also
- --- - - - -- - public - - - - - Intent - - getSettingsIntent - () -
-- - - - -----
- This method is deprecated.
-
- SeegetSettingsIntent(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_REQUIREDmay be returned as the - resultCode inonActivityResult(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
Intentthat can be started to view the GamesClient Settings UI.
-- - - - -- - public - - - - - void - - getTurnBasedMatch - (OnTurnBasedMatchLoadedListener listener, String matchId) -
-- - - - -----
- This method is deprecated.
-
- SeeloadMatch(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.
-
- SeegetSelectOpponentsIntent(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, -
minPlayerswould be 1 andmaxPlayerswould be 3. -- If the user canceled, the result will be
RESULT_CANCELED. If the user - selected players, the result will beRESULT_OK, and the data intent will - contain the selected player IDs inEXTRA_PLAYERSand the minimum and maximum numbers - of additional auto-match players inEXTRA_MIN_AUTOMATCH_PLAYERSand -EXTRA_MAX_AUTOMATCH_PLAYERSrespectively. The player IDs inEXTRA_PLAYERS- will include only the other players selected, not the current player. -- If the
allowAutomatchparameter 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
Intentthat can be started to display the player selector.
-- - - - -- - public - - - - - Intent - - getTurnBasedSelectOpponentsIntent - (int minPlayers, int maxPlayers) -
-- - - - -----
- This method is deprecated.
-
- SeegetSelectOpponentsIntent(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, -
minPlayerswould be 1 andmaxPlayerswould be 3. -- If the user canceled, the result will be
RESULT_CANCELED. If the user - selected players, the result will beRESULT_OK, and the data intent will - contain the selected player IDs inEXTRA_PLAYERSand the minimum and maximum numbers - of additional auto-match players inEXTRA_MIN_AUTOMATCH_PLAYERSand -EXTRA_MAX_AUTOMATCH_PLAYERSrespectively. The player IDs inEXTRA_PLAYERS- will include only the other players selected, not the current player. -- This method is the equivalent of calling -
getTurnBasedSelectOpponentsIntent(int, int, boolean)with theallowAutomatch- 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
Intentthat can be started to display the player selector.
-- - - - -- - public - - - - - void - - incrementAchievement - (String id, int numSteps) -
-- - - - -----
- This method is deprecated.
-
- Seeincrement(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.
-
- SeeincrementImmediate(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.
-
- SeeisConnected(). - --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.
-
- SeeisConnecting(). - --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.
-
- SeeisConnectionCallbacksRegistered(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.
-
- SeeisConnectionFailedListenerRegistered(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.
-
- Seejoin(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.
-
- Seeleave(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.
-
- SeeleaveMatch(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.
-
- SeeleaveMatchDuringTurn(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 -nullto wait for additional automatched players (if - possible).-- - - - -- - public - - - - - void - - loadAchievements - (OnAchievementsLoadedListener listener, boolean forceReload) -
-- - - - -----
- This method is deprecated.
-
- Seeload(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.
-
- SeeloadCurrentPlayerLeaderboardScore(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_PUBLICor -COLLECTION_SOCIAL.-- - - - -- - public - - - - - void - - loadGame - (OnGamesLoadedListener listener) -
-- - - - -----
- This method is deprecated.
-
- SeeloadGame(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.
-
- SeeloadInvitablePlayers(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.
-
- SeeloadInvitations(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.
-
- SeeloadLeaderboardMetadata(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.
-
- SeeloadLeaderboardMetadata(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.
-
- SeeloadMoreInvitablePlayers(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.
-
- SeeloadMoreScores(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.
-
- SeeloadPlayer(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.
-
- SeeloadPlayerCenteredScores(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_PUBLICor -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.
-
- SeeloadPlayerCenteredScores(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_PUBLICor -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.
-
- SeeloadTopScores(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_PUBLICor -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.
-
- SeeloadTopScores(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_PUBLICor -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.
-
- SeeloadMatchesByStatus(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_INVITEDwill 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.
-
- Seereconnect()- --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 oronConnectionFailed(ConnectionResult)- on a failure.-- -See Also
- --- - - - -- - public - - - - - void - - registerConnectionCallbacks - (GooglePlayServicesClient.ConnectionCallbacks listener) -
-- - - - -----
- This method is deprecated.
-
- SeeregisterConnectionCallbacks(GoogleApiClient.ConnectionCallbacks). - --Registers a listener to receive connection events from this
GooglePlayServicesClient. - If the service is already connected, the listener'sonConnected(Bundle)- method will be called immediately. Applications should balance calls to this method with - calls tounregisterConnectionCallbacks(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.
-
- SeeregisterConnectionFailedListener(GoogleApiClient.OnConnectionFailedListener). - --Registers a listener to receive connection failed events from this -
GooglePlayServicesClient. UnlikeregisterConnectionCallbacks(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.
-
- SeeregisterInvitationListener(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.
-
- SeeregisterMatchUpdateListener(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.
-
- Seerematch(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.
-
- Seereveal(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
- --- - - - -- - public - - - - - void - - revealAchievementImmediate - (OnAchievementUpdatedListener listener, String id) -
-- - - - -----
- This method is deprecated.
-
- SeerevealImmediate(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
- --- - - - -- - public - - - - - int - - sendReliableRealTimeMessage - (RealTimeReliableMessageSentListener listener, byte[] messageData, String roomId, String recipientParticipantId) -
-- - - - -----
- This method is deprecated.
-
- SeesendReliableMessage(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 -
IllegalArgumentExceptionif recipientParticipantId is not a valid participant or - belongs to the current player. The maximum message size supported is -MAX_RELIABLE_MESSAGE_LENbytes.--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_LENbytes.- -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_FAILEDif the message failed to send.
-- - - - -- - public - - - - - int - - sendUnreliableRealTimeMessage - (byte[] messageData, String roomId, List<String> recipientParticipantIds) -
-- - - - -----
- This method is deprecated.
-
- SeesendUnreliableMessage(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 -
IllegalArgumentExceptionif any participants in recipientParticipantIds are not - valid or belong to the current player. The maximum message size supported is -MAX_UNRELIABLE_MESSAGE_LENbytes.--Parameters
--
-- -messageData - The message to be sent. Should be at most - -MAX_UNRELIABLE_MESSAGE_LENbytes.- -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_OKon 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.
-
- SeesendUnreliableMessage(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 -
IllegalArgumentExceptionif recipientParticipantId is not a valid participant or - belongs to the current player. The maximum message size supported is -MAX_UNRELIABLE_MESSAGE_LENbytes.--Parameters
--
-- -messageData - The message to be sent. Should be at most - -MAX_UNRELIABLE_MESSAGE_LENbytes.- -roomId - ID of the room for which the message is being sent. -- -recipientParticipantId - The participant ID to send the message to. --- -Returns
-STATUS_OKon 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.
-
- SeesendUnreliableMessageToAll(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_LENbytes.--Parameters
--
-- -messageData - The message to be sent. Should be at most - -MAX_UNRELIABLE_MESSAGE_LENbytes.- -roomId - ID of the room for which the message is being sent. --- -Returns
-STATUS_OKon 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.
-
- SeesetSteps(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.
-
- SeesetStepsImmediate(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.
-
- SeesetGravityForPopups(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.
-
- SeesetViewForPopups(GoogleApiClient, View). - --Sets the
Viewto 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.
-
- SeesignOut(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. Ifdisconnect()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.
-
- SeesignOut(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.
-
- SeesubmitScore(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:
scorerepresents 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:
scorerepresents an elapsed time in milliseconds. The value will be - formatted as an appropriate time value.
- - Currency:
scorerepresents 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.
-
- SeesubmitScore(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:
scorerepresents 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:
scorerepresents an elapsed time in milliseconds. The value will be - formatted as an appropriate time value.
- - Currency:
scorerepresents 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.
-
- SeesubmitScoreImmediate(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:
scorerepresents 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:
scorerepresents an elapsed time in milliseconds. The value will be - formatted as an appropriate time value.
- - Currency:
scorerepresents 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 - OnScoreSubmittedListenerto 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
- --- - - - -- - public - - - - - void - - submitScoreImmediate - (OnScoreSubmittedListener listener, String leaderboardId, long score) -
-- - - - -----
- This method is deprecated.
-
- SeesubmitScoreImmediate(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:
scorerepresents 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:
scorerepresents an elapsed time in milliseconds. The value will be - formatted as an appropriate time value.
- - Currency:
scorerepresents 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 - OnScoreSubmittedListenerto call when the score has been submitted.- -leaderboardId - The leaderboard to submit the score to. -- -score - The raw score value. --- -See Also
- --- - - - -- - public - - - - - void - - takeTurn - (OnTurnBasedMatchUpdatedListener listener, String matchId, byte[] matchData, String pendingParticipantId) -
-- - - - -----
- This method is deprecated.
-
- SeetakeTurn(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 -nullto wait for additional automatched players (if - possible).-- - - - -- - public - - - - - void - - takeTurn - (OnTurnBasedMatchUpdatedListener listener, String matchId, byte[] matchData, String pendingParticipantId, ParticipantResult... results) -
-- - - - -----
- This method is deprecated.
-
- SeetakeTurn(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 -nullto wait for additional automatched players (if - possible).- -results - Optional list of -ParticipantResultobjects 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 - returningMATCH_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.-- - - - -- - public - - - - - void - - takeTurn - (OnTurnBasedMatchUpdatedListener listener, String matchId, byte[] matchData, String pendingParticipantId, List<ParticipantResult> results) -
-- - - - -----
- This method is deprecated.
-
- SeetakeTurn(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 -nullto wait for additional automatched players (if - possible).- -results - Optional list of -ParticipantResultobjects 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 - returningMATCH_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.-- - - - -- - public - - - - - void - - unlockAchievement - (String id) -
-- - - - -----
- This method is deprecated.
-
- Seeunlock(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
- --- - - - -- - public - - - - - void - - unlockAchievementImmediate - (OnAchievementUpdatedListener listener, String id) -
-- - - - -----
- This method is deprecated.
-
- SeeunlockImmediate(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
- --- - - - -- - public - - - - - void - - unregisterConnectionCallbacks - (GooglePlayServicesClient.ConnectionCallbacks listener) -
-- - - - -----
- This method is deprecated.
-
- SeeunregisterConnectionCallbacks(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.
-
- SeeunregisterConnectionFailedListener(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.
-
- SeeunregisterInvitationListener(GoogleApiClient)- -- -Unregisters this client's invitation listener, if any. Any new invitations will generate - status bar notifications as normal.
-- - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/docs/html/reference/com/google/android/gms/games/GamesMetadata.LoadGamesResult.html b/docs/html/reference/com/google/android/gms/games/GamesMetadata.LoadGamesResult.html index a75210a3b8a9e0d97efd8769cfe4be45ae7a66bd..b360d1aa4eaf10021ae97c155f811f2c60ee82eb 100644 --- a/docs/html/reference/com/google/android/gms/games/GamesMetadata.LoadGamesResult.html +++ b/docs/html/reference/com/google/android/gms/games/GamesMetadata.LoadGamesResult.html @@ -459,12 +459,6 @@ onkeyup="return search_changed(event, false, '/')" /> Wallet - -- - public - - - - - void - - unregisterMatchUpdateListener - () -
-- - - - -----
- This method is deprecated.
-
- SeeunregisterMatchUpdateListener(GoogleApiClient)- -- -Unregisters this client's match update listener, if any. Any new match updates will generate - status bar notifications as normal.
- Setup
+ - -- Setup
+ - -- Setup
+++ + + diff --git a/docs/html/reference/com/google/android/gms/games/OnGamesLoadedListener.html b/docs/html/reference/com/google/android/gms/games/OnGamesLoadedListener.html deleted file mode 100644 index 8bbb99f9c456ceb9e6216dd03340880d43c4b4bd..0000000000000000000000000000000000000000 --- a/docs/html/reference/com/google/android/gms/games/OnGamesLoadedListener.html +++ /dev/null @@ -1,965 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -+ + public + static + final + int + + NOTIFICATION_TYPE_REQUEST +
++ + + + +++ +++ + +Notification type for requests.
+ Constant Value: + + + 4 + (0x00000004) + + ++ +OnGamesLoadedListener | Android Developers - - - - - - - - - - - - - - - - - - - - - - --- - - - - - - - - - - - - - - - - - - ---- -- - - - - - - -
-
-
- ---to top - - - --
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - Setup - -
-
- - - Reference - -- - - - - - - - - -- - - - - - - - diff --git a/docs/html/reference/com/google/android/gms/games/OnPlayersLoadedListener.html b/docs/html/reference/com/google/android/gms/games/OnPlayersLoadedListener.html deleted file mode 100644 index 93788231602e236386c717b1e76a924628e136d1..0000000000000000000000000000000000000000 --- a/docs/html/reference/com/google/android/gms/games/OnPlayersLoadedListener.html +++ /dev/null @@ -1,964 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
OnPlayersLoadedListener | Android Developers - - - - - - - - - - - - - - - - - - - - - - --- - - - - - - - - - - - - - - - - - - ---- -- - - - - - - -
-
-
- -
- - -
+ + public + + + + + String + + getHiResImageUrl + () +
++ + public + + + + + String + + getIconImageUrl + () +
++ + public + + + abstract + + PendingResult<Players.LoadPlayersResult> + + loadConnectedPlayers + (GoogleApiClient apiClient, boolean forceReload) +
+Asynchronously loads a list of players that have connected to this game (and that + the user has permission to know about). +
+ Required API: API
+ Required Scopes: SCOPE_GAMES
Parameters
+| apiClient + | The GoogleApiClient to service the call. |
+
|---|---|
| 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. + | +
-
-
- Achievements.LoadAchievementsResult.
- Achievements.UpdateAchievementResult.
-
-
-
- -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - Setup - -
-
- - - Reference - -- - - - - - - - - -- - - - - - - - diff --git a/docs/html/reference/com/google/android/gms/games/leaderboard/OnLeaderboardScoresLoadedListener.html b/docs/html/reference/com/google/android/gms/games/leaderboard/OnLeaderboardScoresLoadedListener.html deleted file mode 100644 index c74335c73a66560d6c200a969a7d6765d92078d4..0000000000000000000000000000000000000000 --- a/docs/html/reference/com/google/android/gms/games/leaderboard/OnLeaderboardScoresLoadedListener.html +++ /dev/null @@ -1,969 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
OnLeaderboardScoresLoadedListener | Android Developers - - - - - - - - - - - - - - - - - - - - - - --- - - - - - - - - - - - - - - - - - - ---- -- - - - - - - -
-
-
- ---to top - - - --
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - Setup - -
-
- - - Reference - -- - - - - - - - - -- - - - - - - - diff --git a/docs/html/reference/com/google/android/gms/games/leaderboard/OnPlayerLeaderboardScoreLoadedListener.html b/docs/html/reference/com/google/android/gms/games/leaderboard/OnPlayerLeaderboardScoreLoadedListener.html deleted file mode 100644 index 955eb39fd6feae44318c70c835c621b271fa21ec..0000000000000000000000000000000000000000 --- a/docs/html/reference/com/google/android/gms/games/leaderboard/OnPlayerLeaderboardScoreLoadedListener.html +++ /dev/null @@ -1,964 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
OnPlayerLeaderboardScoreLoadedListener | Android Developers - - - - - - - - - - - - - - - - - - - - - - --- - - - - - - - - - - - - - - - - - - ---- -- - - - - - - -
-
-
- -
-
-
-
Leaderboards.LeaderboardMetadataResult.
- Leaderboards.LoadScoresResult.
- Leaderboards.LoadPlayerScoreResult.
- SubmitScoreResult.
- ScoreSubmissionData.
- Returns
- Variant specified for this invitation, if any. diff --git a/docs/html/reference/com/google/android/gms/games/multiplayer/InvitationBuffer.html b/docs/html/reference/com/google/android/gms/games/multiplayer/InvitationBuffer.html index 3490232b27d88b7574440d79468718675226f3f1..327d47fc780bfddddd92e16bcb88476b1b921f74 100644 --- a/docs/html/reference/com/google/android/gms/games/multiplayer/InvitationBuffer.html +++ b/docs/html/reference/com/google/android/gms/games/multiplayer/InvitationBuffer.html @@ -459,12 +459,6 @@ onkeyup="return search_changed(event, false, '/')" /> Wallet
Returns
- Variant specified for this invitation, if any. diff --git a/docs/html/reference/com/google/android/gms/games/multiplayer/Invitations.LoadInvitationsResult.html b/docs/html/reference/com/google/android/gms/games/multiplayer/Invitations.LoadInvitationsResult.html index f3f9b53ccdd43f42dfecb58b4aee4cea4835fcc6..c2b2e64926213143272ded87468b3d7a617ca4de 100644 --- a/docs/html/reference/com/google/android/gms/games/multiplayer/Invitations.LoadInvitationsResult.html +++ b/docs/html/reference/com/google/android/gms/games/multiplayer/Invitations.LoadInvitationsResult.html @@ -459,12 +459,6 @@ onkeyup="return search_changed(event, false, '/')" /> Wallet
+ + public + + + abstract + + PendingResult<Invitations.LoadInvitationsResult> + + loadInvitations + (GoogleApiClient apiClient, int sortOrder) +
+Asynchronously load the list of invitations for the current game. +
+ Required API: API
+ Required Scopes: SCOPE_GAMES
Parameters
+| apiClient + | The GoogleApiClient to service the call. |
+
|---|---|
| sortOrder + | How to sort the returned invitations. Must be either
+ SORT_ORDER_MOST_RECENT_FIRST or
+ SORT_ORDER_SOCIAL_AGGREGATION. |
+
Returns
+PendingResultto access the data when available. +
Asynchronously load the list of invitations for the current game. +
Asynchronously load the list of invitations for the current game. Invitations are returned + sorted by most recent first.
Required API: API
Required Scopes: SCOPE_GAMES
Room.TurnBasedMatch.@@ -1055,7 +1069,7 @@ onkeyup="return search_changed(event, false, '/')" /> final String - EXTRA_PLAYERS + EXTRA_ROOM
Used to return a list of player IDs. Retrieve with
- getStringArrayListExtra(String).
See Also
- -Used to return a Room. Retrieve with getParcelableExtra(String).
+
@@ -1098,7 +1107,7 @@ onkeyup="return search_changed(event, false, '/')" /> final String - EXTRA_ROOM + EXTRA_TURN_BASED_MATCH
Used to return a Room. Retrieve with getParcelableExtra(String).
+
Used to return a TurnBasedMatch. Retrieve with
+ getParcelableExtra(String) or getParcelable(String).
@@ -1134,9 +1144,9 @@ onkeyup="return search_changed(event, false, '/')" /> public static final - String + int - EXTRA_TURN_BASED_MATCH + MAX_RELIABLE_MESSAGE_LEN
Used to return a TurnBasedMatch. Retrieve with
- getParcelableExtra(String) or getParcelable(String).
+
This gives the maximum message size supported via the
+ sendReliableMessage(GoogleApiClient, RealTimeMultiplayer.ReliableMessageSentCallback, byte[], String, String) methods (excluding protocol headers).
@@ -1175,7 +1186,7 @@ onkeyup="return search_changed(event, false, '/')" /> final int - MAX_RELIABLE_MESSAGE_LEN + MAX_UNRELIABLE_MESSAGE_LEN
This gives the maximum message size supported via the
- sendReliableMessage(GoogleApiClient, RealTimeMultiplayer.ReliableMessageSentCallback, byte[], String, String) methods (excluding protocol headers).
+
This gives the maximum (unfragmented) message size supported via the
+ sendUnreliableMessage(GoogleApiClient, byte[], String, String) methods (excluding protocol headers).
@@ -1215,7 +1226,7 @@ onkeyup="return search_changed(event, false, '/')" /> final int - MAX_UNRELIABLE_MESSAGE_LEN + SORT_ORDER_MOST_RECENT_FIRST
This gives the maximum (unfragmented) message size supported via the
- sendUnreliableMessage(GoogleApiClient, byte[], String, String) methods (excluding protocol headers).
+
Sort multiplayer activities by their last-modified timestamp with most recent first.
+ + public + static + final + int + + SORT_ORDER_SOCIAL_AGGREGATION +
+Sort multiplayer activities such that activities from players in the user's circles are + returned first. +
|
-
- Known Indirect Subclasses
-
-
-
-
-
-
- TurnBasedMultiplayerListener
-
-
-
-
- |
-
-
- + + public + + + + + String + + getHiResImageUrl + () +
++ + public + + + + + String + + getIconImageUrl + () +
+Invitations.LoadInvitationsResult.
- Parameters
diff --git a/docs/html/reference/com/google/android/gms/games/multiplayer/realtime/RealTimeMultiplayer.html b/docs/html/reference/com/google/android/gms/games/multiplayer/realtime/RealTimeMultiplayer.html index af074942f298304dc69706bd7bad9f0e1a632d4b..69fdd45fab8d764cbbd86d78e0ddb71dc6f6b191 100644 --- a/docs/html/reference/com/google/android/gms/games/multiplayer/realtime/RealTimeMultiplayer.html +++ b/docs/html/reference/com/google/android/gms/games/multiplayer/realtime/RealTimeMultiplayer.html @@ -459,12 +459,6 @@ onkeyup="return search_changed(event, false, '/')" /> WalletminPlayers would be 1 and maxPlayers would be 3.
+ Players may be preselected by specifying a list of player IDs in the
+ EXTRA_PLAYER_IDS extra on the returned intent.
+
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
+ contain the selected player IDs in EXTRA_PLAYER_IDS 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,
+ EXTRA_PLAYER_IDS 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
@@ -1408,13 +1417,16 @@ onkeyup="return search_changed(event, false, '/')" />
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.
+ Players may be preselected by specifying a list of player IDs in the
+ EXTRA_PLAYER_IDS extra on the returned intent.
+
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
+ contain the selected player IDs in EXTRA_PLAYER_IDS 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,
+ EXTRA_PLAYER_IDS will include only the other players selected,
not the current player.
This method is the equivalent of calling @@ -1910,7 +1922,7 @@ onkeyup="return search_changed(event, false, '/')" /> - +
@@ -1922,7 +1934,7 @@ onkeyup="return search_changed(event, false, '/')" /> int - sendUnreliableMessageToAll + sendUnreliableMessageToOthers (GoogleApiClient apiClient, byte[] messageData, String roomId)
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.
+
Send a message to all participants in a real-time room, excluding the current player. The
+ message delivery is not reliable and will not report status after completion. The maximum
+ message size supported is MAX_UNRELIABLE_MESSAGE_LEN bytes.
Required API: API
Required Scopes: SCOPE_GAMES
Parameters
+ + public + + + + + boolean + + hasData + () +
+Helper method to return whether or not this response contains any data.
Returns
+- whether or not this response contains any non-empty buffers. +
-
-
- -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - Setup - - - -
- Setup +
-
@@ -669,25 +675,6 @@ onkeyup="return search_changed(event, false, '/')" />-Summary: - - - - - - - - - - - - Methods - - - - -| [Expand All] -@@ -736,43 +723,6 @@ Summary: -
-- - Known Indirect Subclasses
-
- --- - - TurnBasedMultiplayerListener - - -- -diff --git a/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/OnTurnBasedMatchUpdatedListener.html b/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/OnTurnBasedMatchUpdatedListener.html deleted file mode 100644 index 41877a58efbdd37cbbd663e39246bdeef4a012cf..0000000000000000000000000000000000000000 --- a/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/OnTurnBasedMatchUpdatedListener.html +++ /dev/null @@ -1,1028 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -OnTurnBasedMatchUpdatedListener | Android Developers - - - - - - - - - - - - - - - - - - - - - - --- - - - - - - - - - - - - - - - - - - ---- -- - - - - - - -
-
-
- ---to top - - - --
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - Setup - -
-
- - - Reference - -- - - - - - - - - -- - - - - - - - diff --git a/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/TurnBasedMatch.html b/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/TurnBasedMatch.html index 50aa56f632f5bdc8140d33be5b50a20e2d7743dc..f04c05f6605f9aad5945e4ecbab3923f6d3ada75 100644 --- a/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/TurnBasedMatch.html +++ b/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/TurnBasedMatch.html @@ -459,12 +459,6 @@ onkeyup="return search_changed(event, false, '/')" /> Wallet
- - -
-
-
- - Overview - -
- - Getting Started - -
- - Implementing GCM Client - - -
- - User Notifications - -
- - Advanced Topics - -
- - Migration - -
-
-
-
-
-
-
-
-
-
-- -- -- - - - -- - - - -- -Summary: - - - - - - - - - - - - Methods - - - - -| [Expand All] - --- - - - --- public - - - - interface -- - - -
OnTurnBasedMatchUpdatedListener
- - - - - - - - --- -- - -
- - - - - - -- - - - -com.google.android.gms.games.multiplayer.turnbased.OnTurnBasedMatchUpdatedListener -
- - -- - Known Indirect Subclasses
-
- --- - - TurnBasedMultiplayerListener - - -- --- - - - - - - - - - - - - - - - --
- This interface is deprecated.
- -
- SeeTurnBasedMultiplayer.UpdateMatchResult. - -Class Overview
-Listener for receiving callbacks when a match has been updated.
- - - - - -- - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -Summary
- - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- - - - - - - -Public Methods - - - - -- abstract - - - - - void -- onTurnBasedMatchUpdated(int statusCode, TurnBasedMatch match) - -Called when match has been updated.- -Public Methods
- - - - - --- - - - - - - - - - - - - -- - public - - - abstract - - void - - onTurnBasedMatchUpdated - (int statusCode, TurnBasedMatch match) -
-- - - - --- ---Called when match has been updated. Possible status codes include: -
-
-
STATUS_OKif data was successfully loaded and is up-to-date.
- STATUS_NETWORK_ERROR_OPERATION_DEFERREDif the attempt to leave the - match resulted in a network error. The operation was stored locally, and will be retried the - next time the device comes online. No further action is required.
- STATUS_MATCH_ERROR_LOCALLY_MODIFIEDif the match has already been - modified locally and has changes waiting to be synced to the server. The update operation was - not executed.
- STATUS_MATCH_ERROR_INACTIVE_MATCHif the match has already - transitioned into an inactive state on the server.
- STATUS_MATCH_ERROR_OUT_OF_DATE_VERSIONif the local match state was - out of date. In this case, the updated match will be returned.
- STATUS_MULTIPLAYER_ERROR_NOT_TRUSTED_TESTERif one of the users in - the match is not a trusted tester of a game which is not yet published.
- STATUS_MULTIPLAYER_ERROR_INVALID_OPERATIONif the server rejected the - operation.
- STATUS_MULTIPLAYER_DISABLEDif the game does not support multiplayer. -
- STATUS_CLIENT_RECONNECT_REQUIREDif theGamesClientneeds to - reconnect to the service to perform this operation.
- STATUS_INTERNAL_ERRORif an unexpected error occurred in the service. -
-
-- -Parameters
--
-- -statusCode - A status code indicating the result of the operation. -- -match - The updated -TurnBasedMatchobject. Note that this may be null, depending - on the status code returned. -
-
-
- - -
- Setup +
-
-
-
CharArrayBuffer.@@ -1996,7 +2073,7 @@ From interface final int - MATCH_VARIANT_ANY + MATCH_VARIANT_DEFAULT
+ + public + + + abstract + + String + + getDescription + () +
+Returns
+- Description of this match. +
+ + public + + + abstract + + void + + getDescription + (CharArrayBuffer dataOut) +
+Loads the match description into the given CharArrayBuffer.
Parameters
+| dataOut + | The buffer to load the data into. + | +
|---|
+ + public + + + abstract + + Participant + + getDescriptionParticipant + () +
+Get the participant representing the primary opponent in the match.
Returns
+- The participant representing the primary opponent in the match. +
+ + public + + + abstract + + String + + getDescriptionParticipantId + () +
+Get the ID of another participant in the match that can be used when describing the + participants the user is playing with. For example, in a four player match this might be + used to state "Martha (and 2 others)".
Returns
+- The participant ID of the primary opponent in the match. +
- Variant specified for this match, if any. A variant is an optional
developer-controlled parameter describing the type of game to play, ranging from
1-1023 (inclusive). If this match had no variant specified, returns
-
MATCH_VARIANT_ANY. +MATCH_VARIANT_DEFAULT.
Parameters
| int | -MATCH_VARIANT_ANY | +MATCH_VARIANT_DEFAULT | Constant used to indicate that the variant for a match is unspecified. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Loads the match description into the given
+
+ CharArrayBuffer. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Get the participant representing the primary opponent in the match.
+
+ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Get the ID of another participant in the match that can be used when describing the
+ participants the user is playing with.
+
+ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Loads the match description into the given
+
+ CharArrayBuffer. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Get the participant representing the primary opponent in the match.
+
+ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Get the ID of another participant in the match that can be used when describing the
+ participants the user is playing with.
+
+ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
+
+
+
+
+
++ + public + + + + + String + + getDescription + () ++
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
++ + public + + + + + void + + getDescription + (CharArrayBuffer dataOut) ++
+
+
+
+
+
+
+
+
+Loads the match description into the given
+
+
+ Parameters+
+
+
+
+
+
++ + public + + + + + Participant + + getDescriptionParticipant + () ++
+
+
+
+
+
+
+
+
+Get the participant representing the primary opponent in the match.
+
+
+ Returns+
+
+
+
+ + public + + + + + String + + getDescriptionParticipantId + () ++
+
+
+
+
+
+
+
+
+Get the ID of another participant in the match that can be used when describing the + participants the user is playing with. For example, in a four player match this might be + used to state "Martha (and 2 others)".
+
+
+ Returns+
diff --git a/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/TurnBasedMultiplayer.CancelMatchResult.html b/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/TurnBasedMultiplayer.CancelMatchResult.html
index 58bbe98979bedb44f2e32f88bed6dea49ba645d1..f73293b83810a81c59bd9105c3c4918c13a7d5b9 100644
--- a/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/TurnBasedMultiplayer.CancelMatchResult.html
+++ b/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/TurnBasedMultiplayer.CancelMatchResult.html
@@ -459,12 +459,6 @@ onkeyup="return search_changed(event, false, '/')" />
Wallet
- |
Asynchronously load turn-based matches for the current game.
@@ -1183,6 +1189,24 @@ onkeyup="return search_changed(event, false, '/')" />
+ PendingResult<TurnBasedMultiplayer.LoadMatchesResult>
+ |
+ Asynchronously load turn-based matches for the current game.
+
+ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
minPlayers would be 1 and maxPlayers would be 3.
+ Players may be preselected by specifying a list of player IDs in the
+
If the user canceled, the result will be
If the
+ Players may be preselected by specifying a list of player IDs in the
+
If the user canceled, the result will be This method is the equivalent of calling @@ -2267,7 +2297,72 @@ onkeyup="return search_changed(event, false, '/')" /> - + + +
+
+
+
+
+ + public + + + abstract + + PendingResult<TurnBasedMultiplayer.LoadMatchesResult> + + loadMatchesByStatus + (GoogleApiClient apiClient, int invitationSortOrder, int[] matchTurnStatuses) ++
+
+
+
+
+
+
+
+
+Asynchronously load turn-based matches for the current game. Matches with any specified turn + status codes will be returned. +
+ Valid turn status values are
+ Required API:
+
+ Parameters+
+
+
+ Returns+
@@ -2280,7 +2375,7 @@ onkeyup="return search_changed(event, false, '/')" /> PendingResult<TurnBasedMultiplayer.LoadMatchesResult> loadMatchesByStatus - (GoogleApiClient apiClient, int... matchTurnStatuses) + (GoogleApiClient apiClient, int[] matchTurnStatuses)
diff --git a/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/TurnBasedMultiplayerListener.html b/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/TurnBasedMultiplayerListener.html
deleted file mode 100644
index d658a5339e4722a8cea2e3f4c3fc33d753c53c95..0000000000000000000000000000000000000000
--- a/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/TurnBasedMultiplayerListener.html
+++ /dev/null
@@ -1,1314 +0,0 @@
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-to top
-
-
-
-
GamesClient |
-
- This class is deprecated.
- See |
- GoogleApiClient and Games.
- GamesClient.Builder |
-
- This class is deprecated.
- See |
- GoogleApiClient.Builder.
- GamesStatusCodes |
Status codes for Games results. |
diff --git a/docs/html/reference/com/google/android/gms/games/request/GameRequest.html b/docs/html/reference/com/google/android/gms/games/request/GameRequest.html
new file mode 100644
index 0000000000000000000000000000000000000000..545bb626c3c410cd7d5dd0b6646325a2f1e344af
--- /dev/null
+++ b/docs/html/reference/com/google/android/gms/games/request/GameRequest.html
@@ -0,0 +1,1910 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+to top
+
+
+
+
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
-
- This class is deprecated.
- See ScoreSubmissionData.
-
Class Overview
-Data object representing the result of submitting a score to a leaderboard.
+DataBuffer implementation containing Request details.
+
| Nested Classes | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| SubmitScoreResult.Result | -Simple data class containing the result data for a particular time span. | -||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Public Constructors | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-
@@ -908,54 +1000,47 @@ Summary:
-
+
--
- This interface is deprecated. Class Overview-Listener for receiving callbacks when matches have been loaded. +Result delivered when requests have loaded. Possible status codes include: +
Called when matches have been loaded.
-
+ getRequests(int requestType)
+
+ Retrieves any loaded requests of the specified type.
+
+ - public - - - abstract - - void + public + + + abstract + + GameRequestBuffer - onTurnBasedMatchesLoaded - (int statusCode, LoadMatchesResponse response) + getRequests + (int requestType)
-
-
+
+
-
-
@@ -973,17 +1058,17 @@ Summary:
diff --git a/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/OnTurnBasedMatchLeftListener.html b/docs/html/reference/com/google/android/gms/games/request/Requests.UpdateRequestsResult.html
similarity index 75%
rename from docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/OnTurnBasedMatchLeftListener.html
rename to docs/html/reference/com/google/android/gms/games/request/Requests.UpdateRequestsResult.html
index be3fe90d57b01918216b0105e445efbf751934f2..cb5fd9cb30ee5fa1d8a8b7d48c3543b93a979be5 100644
--- a/docs/html/reference/com/google/android/gms/games/multiplayer/turnbased/OnTurnBasedMatchLeftListener.html
+++ b/docs/html/reference/com/google/android/gms/games/request/Requests.UpdateRequestsResult.html
@@ -83,7 +83,7 @@
-Called when matches have been loaded. Possible status codes include: -
Retrieves any loaded requests of the specified type. Note that if Parameters
+
Returns+
com.google.android.gms.games.request.Requests.UpdateRequestsResult |
+ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
- Known Indirect Subclasses
-
-
-
-
-
-
- TurnBasedMultiplayerListener
-
-
-
-
- |
-
- This interface is deprecated.
- See TurnBasedMultiplayer.LeaveMatchResult.
-
Class Overview
-Listener for receiving callbacks when a player leaves a turn-based match.
+Result delivered when requests are updated. Possible status codes include: +
-
+
STATUS_OKif all of the requests updated successfully.
+ STATUS_NETWORK_ERROR_OPERATION_FAILEDif the update operation + failed due to network error.
+ STATUS_REQUEST_UPDATE_PARTIAL_SUCCESSif only some of the + updates could be successfully applied.
+ STATUS_REQUEST_UPDATE_TOTAL_FAILUREif all of the update + operations failed with hard errors. Retrying will not change this result.
+ STATUS_CLIENT_RECONNECT_REQUIREDif the client needs to + reconnect to the service to access this data.
+ STATUS_INTERNAL_ERRORif an unexpected error occurred in the + service.
+
|
+ [Expand]
+ Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
+
+From interface
+
+ com.google.android.gms.common.api.Releasable
+
+
+
+
+
+
+ | |||||||||||
|
+
+From interface
+
+ com.google.android.gms.common.api.Result
+
+
+
+
+
+
+ | |||||||||||
- public - - - abstract - - void + public + + + abstract + + Set<String> - onTurnBasedMatchLeft - (int statusCode, TurnBasedMatch match) + getRequestIds + ()
Called when the player has left the match. Possible status codes include: -
-
-
STATUS_OKif the player successfully left the match.
- STATUS_NETWORK_ERROR_OPERATION_DEFERREDif the attempt to leave the - match resulted in a network error. The operation was stored locally, and will be retried the - next time the device comes online. No further action is required.
- STATUS_MATCH_ERROR_LOCALLY_MODIFIEDif the match has already been - modified locally and has changes waiting to be synced to the server. The leave operation was - not executed.
- STATUS_MATCH_ERROR_INACTIVE_MATCHif the match has already - transitioned into an inactive state on the server.
- STATUS_MATCH_ERROR_OUT_OF_DATE_VERSIONif the local match state was - out of date. In this case, the updated match will be returned.
- STATUS_MULTIPLAYER_ERROR_INVALID_OPERATIONif the server rejected the - operation.
- STATUS_MULTIPLAYER_DISABLEDif the game does not support multiplayer. -
- STATUS_CLIENT_RECONNECT_REQUIREDif theGamesClientneeds to - reconnect to the service to perform this operation.
- STATUS_INTERNAL_ERRORif an unexpected error occurred in the service. -
-
Provides the set of all the request IDs that were used for the update. This set does not + preserve the original order in which updates were performed or added to the + RequestUpdateOutcomes object.
Returns
+- The set of all the external request IDs that were a part of the update operation. +
+ + public + + + abstract + + int + + getRequestOutcome + (String requestId) +
+Retrieve the outcome of updating the specified request. If the request ID was not part of + the original update operation, this will throw an exception.
Parameters
| statusCode - | A status code indicating the result of the operation. | -||
|---|---|---|---|
| match - | The updated TurnBasedMatch object. Note that this may be null, depending
- on the status code returned.
- |
+ requestId + | The external request ID to lookup. |
Returns
+- The outcome of the update for the given request. +
+
+
+ -
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
+
+
-
+
- + Setup + + +
-
+ + + Reference + ++ + + + + + + + + +
- + +
-
+
- + Overview + +
- + Getting Started + +
- + Implementing GCM Client + + +
- + User Notifications + +
- + Advanced Topics + +
- + Migration + +
-
+
+
+
+
+
+
+
+
++ ++ + + + ++ + + + ++ +++ + + + +++ public + + + + interface ++ + + +
Requests
+ + + + + + + + +++ + +
+ + + + + + + ++ + + + +com.google.android.gms.games.request.Requests ++ + ++ + + + + + + + + + + + + + + + +Class Overview
+Entry point for request functionality. +
+ + + + + ++ + +Summary
+ + + + +
@@ -785,23 +783,8 @@ Summary:Nested Classes + + + ++ + + + + interface Requests.LoadRequestsResult +Result delivered when requests have loaded. ++ + + + + + + + + + + + + + + + + ++ + + + + interface Requests.UpdateRequestsResult +Result delivered when requests are updated. +
+ + + + + + + + + + + + + + + + + +Constants + + + +String +EXTRA_REQUESTS +Used to return a list of +GameRequestobjects.+ + + +int +REQUEST_DEFAULT_LIFETIME_DAYS +Value used to signal the server to use the default request lifetime. ++ + + +int +REQUEST_DIRECTION_INBOUND +Load only inbound requests (where the loading player is the recipient). ++ + + +int +REQUEST_DIRECTION_OUTBOUND +Load only outbound requests (where the loading player is the sender). ++ + + +int +REQUEST_UPDATE_OUTCOME_FAIL +Constant indicating that the request update failed. ++ + + +int +REQUEST_UPDATE_OUTCOME_RETRY +Constant indicating that the request update failed but should be retried. ++ + + +int +REQUEST_UPDATE_OUTCOME_SUCCESS +Constant indicating that the request update was a success. ++ + + +int +REQUEST_UPDATE_TYPE_ACCEPT +Constant indicating that the request should be accepted. ++ + + +int +REQUEST_UPDATE_TYPE_DISMISS +Constant indicating that the request should be dismissed. ++ + + +int +SORT_ORDER_EXPIRING_SOON_FIRST +Sort requests with the requests expiring soonest first. ++ + + + +int +SORT_ORDER_SOCIAL_AGGREGATION +Sort requests such that requests from players in the user's circles are returned first. +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +Public Methods + + + + ++ abstract + + + + + PendingResult<Requests.UpdateRequestsResult> ++ acceptRequest(GoogleApiClient apiClient, String requestId) + +Accepts the specified request.+ ++ + + + ++ abstract + + + + + PendingResult<Requests.UpdateRequestsResult> ++ acceptRequests(GoogleApiClient apiClient, List<String> requestIds) + +Accepts the specified requests as a batch operation.+ ++ + + + ++ abstract + + + + + PendingResult<Requests.UpdateRequestsResult> ++ dismissRequest(GoogleApiClient apiClient, String requestId) + +Dismisses the specified request.+ ++ + + + ++ abstract + + + + + PendingResult<Requests.UpdateRequestsResult> ++ dismissRequests(GoogleApiClient apiClient, List<String> requestIds) + +Dismisses the specified requests as a batch operation.+ ++ + + + ++ abstract + + + + + ArrayList<GameRequest> ++ getGameRequestsFromBundle(Bundle extras) + +This method takes a+ +Bundleobject and extracts theGameRequestlist provided.+ + + + ++ abstract + + + + + ArrayList<GameRequest> ++ getGameRequestsFromInboxResponse(Intent response) + +This method takes an+ +Intentobject and extracts theGameRequestlist provided + as an extra.+ + + + ++ abstract + + + + + Intent ++ getInboxIntent(GoogleApiClient apiClient) + +Returns an intent that will let the user see and manage any outstanding requests.+ ++ + + + ++ abstract + + + + + int ++ getMaxLifetimeDays(GoogleApiClient apiClient) + +Gets the maximum lifetime of a request in days.+ ++ + + + ++ abstract + + + + + int ++ getMaxPayloadSize(GoogleApiClient apiClient) + +Gets the maximum data size of a request payload in bytes.+ ++ + + + ++ abstract + + + + + Intent ++ getSendIntent(GoogleApiClient apiClient, int type, byte[] payload, int requestLifetimeDays, Bitmap icon, String description) + +Returns an intent that will let the user send a request to another player.+ ++ + + + ++ abstract + + + + + PendingResult<Requests.LoadRequestsResult> ++ loadRequests(GoogleApiClient apiClient, int requestDirection, int types, int sortOrder) + +Loads requests for the current game.+ ++ + + + ++ abstract + + + + + void ++ registerRequestListener(GoogleApiClient apiClient, OnRequestReceivedListener listener) + +Register a listener to intercept incoming requests for the currently signed-in user.+ ++ + + + ++ abstract + + + + + void ++ unregisterRequestListener(GoogleApiClient apiClient) + +Unregisters this client's request listener, if any.+ +Constants
+ + + + + + +++ + + + + ++ + public + static + final + String + + EXTRA_REQUESTS +
++ + + + +++ +++ + +Used to return a list of
GameRequestobjects. Retrieve with +getParcelableArrayListExtra(String)or +getParcelableArrayList(String). ++ Constant Value: + + + "requests" + + ++ +++ + + + + ++ + public + static + final + int + + REQUEST_DEFAULT_LIFETIME_DAYS +
++ + + + +++ +++ + +Value used to signal the server to use the default request lifetime. +
+ Constant Value: + + + -1 + (0xffffffff) + + ++ +++ + + + + ++ + public + static + final + int + + REQUEST_DIRECTION_INBOUND +
++ + + + +++ +++ + +Load only inbound requests (where the loading player is the recipient). +
+ Constant Value: + + + 0 + (0x00000000) + + ++ +++ + + + + ++ + public + static + final + int + + REQUEST_DIRECTION_OUTBOUND +
++ + + + +++ +++ + +Load only outbound requests (where the loading player is the sender). +
+ Constant Value: + + + 1 + (0x00000001) + + ++ +++ + + + + ++ + public + static + final + int + + REQUEST_UPDATE_OUTCOME_FAIL +
++ + + + +++ +++ + +Constant indicating that the request update failed.
+ Constant Value: + + + 1 + (0x00000001) + + ++ +++ + + + + ++ + public + static + final + int + + REQUEST_UPDATE_OUTCOME_RETRY +
++ + + + +++ +++ + +Constant indicating that the request update failed but should be retried.
+ Constant Value: + + + 2 + (0x00000002) + + ++ +++ + + + + ++ + public + static + final + int + + REQUEST_UPDATE_OUTCOME_SUCCESS +
++ + + + +++ +++ + +Constant indicating that the request update was a success.
+ Constant Value: + + + 0 + (0x00000000) + + ++ +++ + + + + ++ + public + static + final + int + + REQUEST_UPDATE_TYPE_ACCEPT +
++ + + + +++ +++ + +Constant indicating that the request should be accepted.
+ Constant Value: + + + 0 + (0x00000000) + + ++ +++ + + + + ++ + public + static + final + int + + REQUEST_UPDATE_TYPE_DISMISS +
++ + + + +++ +++ + +Constant indicating that the request should be dismissed.
+ Constant Value: + + + 1 + (0x00000001) + + ++ +++ + + + + ++ + public + static + final + int + + SORT_ORDER_EXPIRING_SOON_FIRST +
++ + + + +++ +++ + +Sort requests with the requests expiring soonest first. +
+ Constant Value: + + + 0 + (0x00000000) + + ++ +++ + + + + + + + + + + + + + + + + + + ++ + public + static + final + int + + SORT_ORDER_SOCIAL_AGGREGATION +
++ + + + +++ +++ + +Sort requests such that requests from players in the user's circles are returned first. +
+ Constant Value: + + + 1 + (0x00000001) + + ++ +Public Methods
+ + + + + +++ + + + ++ + public + + + abstract + + PendingResult<Requests.UpdateRequestsResult> + + acceptRequest + (GoogleApiClient apiClient, String requestId) +
++ + + + +++ +++Accepts the specified request. If the result of this operation is +
REQUEST_UPDATE_OUTCOME_SUCCESS, the player successfully accepted the + request. ++ Required API:
API
+ Required Scopes:SCOPE_GAMES++Parameters
++
++ +apiClient + The +GoogleApiClientto service the call.+ +requestId + The ID of the request to accept. +++ +Returns
+PendingResultto access the data when available. +
++ + + + ++ + public + + + abstract + + PendingResult<Requests.UpdateRequestsResult> + + acceptRequests + (GoogleApiClient apiClient, List<String> requestIds) +
++ + + + +++ +++Accepts the specified requests as a batch operation. If the result of this operation is +
REQUEST_UPDATE_OUTCOME_SUCCESS, the player successfully accepted the + requests. ++ Required API:
API
+ Required Scopes:SCOPE_GAMES++Parameters
++
++ +apiClient + The +GoogleApiClientto service the call.+ +requestIds + The IDs of the requests to accept. +++ +Returns
+PendingResultto access the data when available. +
++ + + + ++ + public + + + abstract + + PendingResult<Requests.UpdateRequestsResult> + + dismissRequest + (GoogleApiClient apiClient, String requestId) +
++ + + + +++ +++Dismisses the specified request. If the result of this operation is +
REQUEST_UPDATE_OUTCOME_SUCCESS, the request will be deleted from local + storage. Note that dismissing a request does not inform the sender of the action. ++ Required API:
API
+ Required Scopes:SCOPE_GAMES++Parameters
++
++ +apiClient + The +GoogleApiClientto service the call.+ +requestId + The ID of the request to dismiss. +++ +Returns
+PendingResultto access the data when available. +
++ + + + ++ + public + + + abstract + + PendingResult<Requests.UpdateRequestsResult> + + dismissRequests + (GoogleApiClient apiClient, List<String> requestIds) +
++ + + + +++ +++Dismisses the specified requests as a batch operation. If the result of this operation is +
REQUEST_UPDATE_OUTCOME_SUCCESS, the requests will be deleted from local + storage. Note that dismissing a request does not inform the sender of the action. ++ Required API:
API
+ Required Scopes:SCOPE_GAMES++Parameters
++
++ +apiClient + The +GoogleApiClientto service the call.+ +requestIds + The ID of the requests to dismiss. +++ +Returns
+PendingResultto access the data when available. +
++ + + + ++ + public + + + abstract + + ArrayList<GameRequest> + + getGameRequestsFromBundle + (Bundle extras) +
++ + + + +++ +++This method takes a
Bundleobject and extracts theGameRequestlist provided. + If theBundleis invalid or does not contain the correct data, this method returns an + empty list.++Parameters
++
++ +extras + The +Bundleto parse forGameRequestobjects.++ +Returns
+- An
ArrayListofGameRequestobjects that were selected for action. +
++ + + + ++ + public + + + abstract + + ArrayList<GameRequest> + + getGameRequestsFromInboxResponse + (Intent response) +
++ + + + +++ +++This method takes an
Intentobject and extracts theGameRequestlist provided + as an extra. Specifically, this method is useful in parsing the returnedIntentthat + was returned as the response from the request inboxIntent. If theIntentis + invalid or does not contain the correct extra data, this method returns an empty list.++Parameters
++
++ +response + The +Intentresponse from the requests inbox.++Returns
+- An
ArrayListofGameRequestobjects that were selected for action + in the request inbox. +
++ +See Also
+ +++ + + + ++ + public + + + abstract + + Intent + + getInboxIntent + (GoogleApiClient apiClient) +
++ + + + +++ +++Returns an intent that will let the user see and manage any outstanding requests. 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 any requests to accept, the result will beRESULT_OKand the data + intent will contain the selected requests as a parcelable extra inEXTRA_REQUESTS. ++ Required API:
API
+ Required Scopes:SCOPE_GAMES++Parameters
++
++ +apiClient + The +GoogleApiClientto service the call.++ +Returns
+- An
Intentthat can be started to view the request inbox UI. +
++ + + + ++ + public + + + abstract + + int + + getMaxLifetimeDays + (GoogleApiClient apiClient) +
++ + + + +++ +++Gets the maximum lifetime of a request in days. This is guaranteed to be at least 14 days. +
+ 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. ++ Required API:
API
+ Required Scopes:SCOPE_GAMES++Parameters
++
++ +apiClient + The +GoogleApiClientto service the call.++ +Returns
+- The maximum request lifetime in days. +
++ + + + ++ + public + + + abstract + + int + + getMaxPayloadSize + (GoogleApiClient apiClient) +
++ + + + +++ +++Gets the maximum data size of a request payload in bytes. Guaranteed to be at least 2 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. ++ Required API:
API
+ Required Scopes:SCOPE_GAMES++Parameters
++
++ +apiClient + The +GoogleApiClientto service the call.++ +Returns
+- The maximum data size per request in bytes. +
++ + + + ++ + public + + + abstract + + Intent + + getSendIntent + (GoogleApiClient apiClient, int type, byte[] payload, int requestLifetimeDays, Bitmap icon, String description) +
++ + + + +++ +++Returns an intent that will let the user send a request to another player. 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 request was + sent successfully, the result will beRESULT_OK. If the request could not be + sent, the result will beRESULT_SEND_REQUEST_FAILED. ++ Required API:
API
+ Required Scopes:SCOPE_GAMES++Parameters
++
++ +apiClient + The +GoogleApiClientto service the call.+ +type + The type of the request to send. May be either +TYPE_GIFTor +TYPE_WISH.+ +payload + A byte array of data to send with the request. May be a maximum of + +getMaxPayloadSize(GoogleApiClient)bytes.+ +requestLifetimeDays + How long (in days) this request should last if the recipient takes + no action. Must be at least 1 day and no more than + +getMaxLifetimeDays(GoogleApiClient). To use the server default, use +REQUEST_DEFAULT_LIFETIME_DAYS.+ +icon + A Bitmap to display as the request icon. ++ +description + String describing the item. Displayed to the user to add context. +++ +Returns
+- An
Intentthat can be started to launch the "Send Request" UI. +
++ + + + ++ + public + + + abstract + + PendingResult<Requests.LoadRequestsResult> + + loadRequests + (GoogleApiClient apiClient, int requestDirection, int types, int sortOrder) +
++ + + + +++ +++Loads requests for the current game. Requests with any of the specified types will be + returned. +
+ Possible types include
TYPE_GIFTor +TYPE_WISH. Types may be joined together as a bitmask to request + multiple types. ++ Required API:
API
+ Required Scopes:SCOPE_GAMES++Parameters
++
++ +apiClient + The +GoogleApiClientto service the call.+ +requestDirection + The direction of requests to load. Must be either + +REQUEST_DIRECTION_INBOUNDor +REQUEST_DIRECTION_OUTBOUND.+ +types + Mask indicating the types of requests to load. ++ +sortOrder + The sort order to use for sorting the requests. Must be either + +SORT_ORDER_EXPIRING_SOON_FIRSTor +SORT_ORDER_SOCIAL_AGGREGATION.++ +Returns
+PendingResultto access the data when available. +
++ + + + ++ + public + + + abstract + + void + + registerRequestListener + (GoogleApiClient apiClient, OnRequestReceivedListener listener) +
++ + + + +++ +++Register a listener to intercept incoming requests for the currently signed-in user. If a + listener is registered by this method, the incoming request will not generate a status bar + notification as long as this client remains connected. +
+ Note that only one request listener may be active at a time. Calling this method while + another request listener was previously registered will replace the original listener with + the new one. +
+ Required API:
API
+ Required Scopes:SCOPE_GAMES++ +Parameters
++
++ +apiClient + The +GoogleApiClientto service the call.+ +listener + The listener that is called when a new request is received. The listener is + called on the main thread. + +++ + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/html/reference/com/google/android/gms/games/request/package-summary.html b/docs/html/reference/com/google/android/gms/games/request/package-summary.html new file mode 100644 index 0000000000000000000000000000000000000000..d3f76a25ee68f5bf338b6b7e7564a5c8d3f5a90e --- /dev/null +++ b/docs/html/reference/com/google/android/gms/games/request/package-summary.html @@ -0,0 +1,791 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ++ + public + + + abstract + + void + + unregisterRequestListener + (GoogleApiClient apiClient) +
++ + + + +++ +++Unregisters this client's request listener, if any. Any new requests will generate status bar + notifications as normal. +
+ Required API:
API
+ Required Scopes:SCOPE_GAMES++ +Parameters
++
++ +apiClient + The +GoogleApiClientto service the call. +com.google.android.gms.games.request | Android Developers + + + + + + + + + + + + + + + + + + + + + + + +++ + + + + + + + + + + + + + + + + + + ++++ ++ + + + + + + +
+
+
+ +Class Overview
-A metadata field which holds a string value of values. Instances of this class (such as the - static values in
SearchableField) can be used to - create "substring" filters for file queries.- For example, the following code will find all files with "pizza" in the title:
-
- Filter titleFilter = Filters.substring(SearchableField.TITLE, "pizza"); - Query query = new Query.Builder().addFilters(titleFilter).build(); - for (Metadata metadata : Drive.DriveApi.query(apiClient, query).await().getMetadataBuffer()) { - System.out.println(metadata.getTitle()); - } --- Note that you must pass a
StringMetadataFieldto theFilters.substringmethod; - a plainMetadataFieldcannot be used as part of an "substring" query. However, every -StringMetadataFieldis also aMetadataField, so you can use a -StringMetadataFieldwithFilters.eq(for example, if you want to find a - file with an exact title). +A class that encapsulates options for the Address APIs. Currently this is just the theme of + any UI elements the user interacts with.
@@ -847,6 +830,26 @@ Summary: + +
+ + @@ -857,82 +860,60 @@ Summary: - +Fields + + + + ++ public + + final + int theme +Theme to use for system UI elements that the user will interact with. +- - - - - + + + + + - StringMetadataField(String fieldName) - + Address.AddressOptions() + +Uses the default theme+THEME_HOLO_DARK.
- + +
|
- [Expand]
- Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
-
-From class
- com.google.android.gms.drive.metadata.MetadataField
-
-
-
-
-
- | |||||||||||
|
+ [Expand]
+ Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| @@ -950,182 +931,182 @@ From class | |||||||||||