En este documento, se describe cómo migrar juegos existentes del SDK de games v1 al SDK de games v2.
Antes de comenzar
Puedes usar cualquier IDE que prefieras, como Android Studio, para migrar tu juego. Completa los siguientes pasos antes de migrar a la versión 2 de Games:
- Descarga e instala Android Studio
- Tu juego debe usar la versión 1 del SDK de juegos.
- Puedes actualizar tu juego para usar la versión 1 del SDK de juegos y
com.google.android.gms:play-services-games:24.0.0. No debes actualizar acom.google.android.gms:play-services-games:25.0.0porque se quitó la API de la versión 1 de los juegos.
Actualiza las dependencias
En el archivo
build.gradlede tu módulo, busca esta línea en las dependencias a nivel del módulo.implementation "com.google.android.gms:play-services-games:+"Reemplázala por el siguiente código:
implementation "com.google.android.gms:play-services-games-v2:version"Reemplaza version por la versión más reciente del SDK de juegos.
Después de actualizar las dependencias, asegúrate de completar todos los pasos de este documento.
Define el ID del proyecto
Para agregar el ID del proyecto del SDK de los Servicios de juego de Play a tu app, sigue estos pasos:
En el archivo
AndroidManifest.xml, agrega el siguiente elemento<meta-data>y los atributos al elemento<application>:<manifest> <application> <meta-data android:name="com.google.android.gms.games.APP_ID" android:value="@string/game_services_project_id"/> </application> </manifest>Define la referencia
@string/game_services_project_iddel recurso de cadenas usando como valor el ID del proyecto de los Servicios de juego. Puedes encontrar el ID del proyecto de los Servicios de juego debajo del nombre del juego en la página Configuración de Google Play Console.En el archivo
res/values/strings.xml, agrega una referencia del recurso de cadenas y establece el ID del proyecto como el valor. Por ejemplo:<!-- res/values/strings.xml --> <resources> <!-- Replace 0000000000 with your game’s project id. Example value shown above. --> <string translatable="false" name="game_services_project_id"> 0000000000 </string> </resources>
Rutas de migración
La ruta de migración correcta para tu juego depende de cómo implementa los Servicios de Play Games v1 y cómo controla la identidad del jugador. Para garantizar una transición sin problemas y evitar la pérdida de datos de los jugadores, identifica la situación que mejor se adapte a tu configuración existente y sigue los pasos correspondientes.
Opción 1: Para los juegos en los que el IGA está vinculado al ID de jugador de los Servicios de Play Games
Esta situación se aplica a los juegos que usaron Player ID de los Servicios de Play Games como el único identificador de la cuenta en el juego (IGA) de un jugador y que no solicitaron ni almacenaron un OpenID anteriormente. El desafío principal es vincular la IGA existente a un identificador principal (el OpenID) sin perder la conexión con el progreso del jugador.
El flujo de migración incluye los siguientes pasos:
- Cuando se inicia el juego, el SDK de la versión 2 de los Servicios de Play Games autentica la plataforma de forma automática y silenciosa.
Presenta una pantalla de acceso que incluya un botón de Acceder con Google, que reemplaza el botón de Google Play. Por ejemplo, consulta CredManBridge.java.
CredManBridge.java
package com.wickedcube.trivialkart; import android.accounts.Account; import android.content.Context; import android.util.Log; import android.os.CancellationSignal; import androidx.credentials.CredentialManager; import androidx.credentials.GetCredentialRequest; import androidx.credentials.GetCredentialResponse; import androidx.credentials.exceptions.GetCredentialException; import androidx.credentials.exceptions.NoCredentialException; import com.google.android.libraries.identity.googleid.GetGoogleIdOption; import com.google.android.libraries.identity.googleid.GoogleIdTokenCredential; import com.google.android.gms.auth.api.identity.AuthorizationClient; import com.google.android.gms.auth.api.identity.AuthorizationRequest; import com.google.android.gms.auth.api.identity.AuthorizationResult; import com.google.android.gms.common.api.ApiException; import com.google.android.gms.auth.api.identity.Identity; import com.google.android.gms.common.api.Scope; import com.unity3d.player.UnityPlayer; import java.util.Collections; import java.util.List; import java.util.concurrent.Executor; import java.util.concurrent.Executors;public class CredManBridge {
// --- MODE 1: SILENT SIGN-IN (Called on Awake) --- // Tries to auto-select an authorized account. If it fails, it does NOT show UI. public static void signInSilent(Context context, String webClientId) { CredentialManager credentialManager = CredentialManager.create(context); CancellationSignal cancellationSignal = new CancellationSignal(); Executor executor = Executors.newSingleThreadExecutor();
Log.d("CredMan", "Attempting Silent Sign-In..."); GetGoogleIdOption silentOption = new GetGoogleIdOption.Builder() .setFilterByAuthorizedAccounts(true) // Strict: Only authorized accounts .setServerClientId(webClientId) .setAutoSelectEnabled(true) // Auto-select if possible .build(); GetCredentialRequest silentRequest = new GetCredentialRequest.Builder() .addCredentialOption(silentOption) .build(); credentialManager.getCredentialAsync( context, silentRequest, cancellationSignal, executor, new androidx.credentials.CredentialManagerCallback<GetCredentialResponse, GetCredentialException>() { @Override public void onResult(GetCredentialResponse result) { Log.d("CredMan", "Silent Sign-In Successful!"); handleSignInResult(context, result, webClientId); } @Override public void onError(GetCredentialException e) { // Send a specific error code so Unity knows to just stay on the Start Screen Log.d("CredMan", "Silent sign-in failed. Keeping UI hidden."); UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "SilentFailed"); } } );}
// --- MODE 2: INTERACTIVE SIGN-IN (Called on Button Click) --- // Forces the Account Selection / "Add Account" sheet to appear. public static void signInInteractive(Context context, String webClientId) { CredentialManager credentialManager = CredentialManager.create(context); CancellationSignal cancellationSignal = new CancellationSignal(); Executor executor = Executors.newSingleThreadExecutor();
Log.d("CredMan", "Starting Interactive Sign-In..."); GetGoogleIdOption interactiveOption = new GetGoogleIdOption.Builder() .setFilterByAuthorizedAccounts(false) // Show ALL accounts (and "Add Account") .setServerClientId(webClientId) .setAutoSelectEnabled(false) // Force the UI to show .build(); GetCredentialRequest interactiveRequest = new GetCredentialRequest.Builder() .addCredentialOption(interactiveOption) .build(); credentialManager.getCredentialAsync( context, interactiveRequest, cancellationSignal, executor, new androidx.credentials.CredentialManagerCallback<GetCredentialResponse, GetCredentialException>() { @Override public void onResult(GetCredentialResponse result) { Log.d("CredMan", "Interactive Sign-In Successful!"); handleSignInResult(context, result, webClientId); } @Override public void onError(GetCredentialException e) { Log.e("CredMan", "Interactive Sign-In Canceled or Failed", e); UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "Canceled"); } } );}
private static void handleSignInResult(Context context, GetCredentialResponse result, String webClientId) { try { GoogleIdTokenCredential credential = GoogleIdTokenCredential.createFrom(result.getCredential().getData()); String email = credential.getId();
Account account = new Account(email, "com.google"); // Requesting GAMES_LITE scope to check for pre-existing V1 grants List<Scope> requestedScopes = Collections.singletonList(new Scope("https://www.googleapis.com/auth/games_lite")); AuthorizationRequest authRequest = new AuthorizationRequest.Builder() .setRequestedScopes(requestedScopes) .setAccount(account) .requestOfflineAccess(webClientId) .build(); AuthorizationClient authClient = Identity.getAuthorizationClient(context); authClient.authorize(authRequest) .addOnSuccessListener(authorizationResult -> { if (authorizationResult.getServerAuthCode() != null) { // CASE 1: RETURNING USER (Success) // The user has already granted GAMES_LITE in the past. // We got the code directly without showing UI. Log.i("CredMan", "PGS v1: Existing grant found. Returning user detected. Auth Code retrieved."); UnityPlayer.UnitySendMessage("AuthManager", "OnSignInSuccess", authorizationResult.getServerAuthCode()); } else if (authorizationResult.hasResolution()) { // CASE 2: NEW USER (PendingIntent) // The user has NOT granted GAMES_LITE before. The API returned a PendingIntent // (authorizationResult.getPendingIntent()) to show the consent screen. // As per your flow, we DISCARD this intent and do not show UI. Log.i("CredMan", "PGS v1: No existing grant (PendingIntent returned). This is a NEW user or they revoked access."); Log.i("CredMan", "PGS v1: Discarding PendingIntent. Proceeding as New User."); // Notify Unity that this is a "New User" so it can trigger V2 logic instead of failing UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "NewUser_NoGrant"); } else { // Edge Case: No code and no resolution? Log.e("CredMan", "PGS v1: Authorization success but no Auth Code or Resolution returned."); UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "No Auth Code returned"); } }) .addOnFailureListener(e -> { // CASE 3: GENERIC FAILURE Log.e("CredMan", "PGS v1: Authorization failed completely.", e); UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "Authorization Failed: " + e.getMessage()); }); } catch (Exception e) { UnityPlayer.UnitySendMessage("AuthManager", "OnSignInError", "Parsing Error: " + e.getMessage()); }} }
Recupera dos identificadores distintos cuando el jugador presiona el botón Acceder con Google y selecciona una Cuenta de Google:
- El
OpenID, que es el identificador principal para vincular la IGA. - El
Player IDde los Servicios de Play Games, que se recupera con el permisoGAMES_LITE, para buscar el IGA del jugador en tu sistema de backend y realizar la vinculación. Para obtener más información, consulta Cómo recuperarPlayer ID.
- El
Accede a la IGA a través del flujo de Acceder con Google en los lanzamientos posteriores del juego, sin necesidad de que los juegos usen
Player IDcomo identificador principal.
Recupera Player ID
Puedes realizar el paso 3 con una implementación del cliente del juego.
- Llama a la API de Credential Manager de Android para permitir que el usuario acceda con una Cuenta de Google.
- Después de que el usuario completa el flujo de Acceder con Google y selecciona una Cuenta de Google, recibe un objeto de resultado que contiene el token de ID y la dirección de correo electrónico.
- Construye un objeto Account a partir de la dirección de correo electrónico.
- Llama a la API de Authorization con el permiso
GAMES_LITEy la cuenta. - Si la cuenta tiene un permiso preexistente en el alcance
GAMES_LITE, la API de Authorization devuelve un token directamente en el objeto de respuesta:- Usa el token de respuesta para llamar a los servidores de Servicios de Play Games y recuperar el
Player IDde Servicios de Play Games. - Verifica si los Servicios de Play Games
Player IDestán vinculados con una cuenta del juego.- Indica que se trata de un usuario recurrente de los Servicios de Play Games v1.
- Vincula el nuevo ID de GAIA con la cuenta anterior de los Servicios de Play Games v1.
- Usa el token de respuesta para llamar a los servidores de Servicios de Play Games y recuperar el
- Si la cuenta no tiene un otorgamiento previo en el alcance de
GAMES_LITE, la API de Authorization devuelve unPendingIntent:- Esto indica que el usuario no tiene una cuenta existente de los Servicios de Play Games v1.
- Descarta de forma segura el objeto
PendingIntentsin mostrar ninguna IU.
Opción 2: Para los juegos que ya vinculan IGA a OpenID
Los desarrolladores de este grupo tienen la ruta de migración más sencilla. Si la cuenta del juego ya está vinculada principalmente a OpenID, solo debes realizar la migración técnica estándar del SDK de la versión 1 a la versión 2, como se describe en los pasos.
Cómo migrar desde el Acceso con Google obsoleto
Reemplaza la clase GoogleSignInClient por la clase GamesSignInClient.
Java
Ubica los archivos con la clase GoogleSignInClient.
import com.google.android.gms.auth.api.signin.GoogleSignIn;
import com.google.android.gms.auth.api.signin.GoogleSignInClient;
import com.google.android.gms.auth.api.signin.GoogleSignInOptions;
// ... existing code
@Override
public void onCreate(@Nullable Bundle bundle) {
super.onCreate(bundle);
// ... existing code
GoogleSignInOptions signInOption =
new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN).build();
// Client used to sign in to Google services
GoogleSignInClient googleSignInClient =
GoogleSignIn.getClient(this, signInOptions);
}
Y actualízala a lo siguiente:
import com.google.android.gms.games.PlayGamesSdk;
import com.google.android.gms.games.PlayGames;
import com.google.android.gms.games.GamesSignInClient;
// ... existing code
@Override
public void onCreate(){
super.onCreate();
PlayGamesSdk.initialize(this);
// Client used to sign in to Google services
GamesSignInClient gamesSignInClient =
PlayGames.getGamesSignInClient(getActivity());
}
Kotlin
Ubica los archivos con la clase GoogleSignInClient.
import com.google.android.gms.auth.api.signin.GoogleSignIn
import com.google.android.gms.auth.api.signin.GoogleSignInClient
import com.google.android.gms.auth.api.signin.GoogleSignInOptions
// ... existing code
val signInOptions = GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN
// ... existing code
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
val googleSignInClient: GoogleSignInClient =
GoogleSignIn.getClient(this, signInOptions)
}
Y actualízala a lo siguiente:
import com.google.android.gms.games.PlayGames
import com.google.android.gms.games.PlayGamesSdk
import com.google.android.gms.games.GamesSignInClient
// ... existing code
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
PlayGamesSdk.initialize(this)
// client used to sign in to Google services
val gamesSignInClient: GamesSignInClient =
PlayGames.getGamesSignInClient(this)
}
Actualiza el código de GoogleSignIn
La API de GoogleSignIn no se admite en la versión 2 del SDK de juegos. Reemplaza el código de la API de GoogleSignIn por la API de GamesSignInClient, como se muestra en el siguiente ejemplo.
Para solicitar un token de acceso del servidor, usa el método GamesSignInClient.requestServerSideAccess().
Para obtener más información, consulta Cómo actualizar las clases de acceso del servidor.
Java
Ubica los archivos con la clase GoogleSignIn.
// Request code used when invoking an external activity.
private static final int RC_SIGN_IN = 9001;
private boolean isSignedIn() {
GoogleSignInAccount account = GoogleSignIn.getLastSignedInAccount(this);
GoogleSignInOptions signInOptions =
GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN;
return GoogleSignIn.hasPermissions(account, signInOptions.getScopeArray());
}
private void signInSilently() {
GoogleSignInOptions signInOptions =
GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN;
GoogleSignInClient signInClient = GoogleSignIn.getClient(this, signInOptions);
signInClient
.silentSignIn()
.addOnCompleteListener(
this,
task -> {
if (task.isSuccessful()) {
// The signed-in account is stored in the task's result.
GoogleSignInAccount signedInAccount = task.getResult();
showSignInPopup();
} else {
// Perform interactive sign in.
startSignInIntent();
}
});
}
private void startSignInIntent() {
GoogleSignInClient signInClient = GoogleSignIn.getClient(this,
GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN);
Intent intent = signInClient.getSignInIntent();
startActivityForResult(intent, RC_SIGN_IN);
}
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == RC_SIGN_IN) {
GoogleSignInResult result =
Auth.GoogleSignInApi.getSignInResultFromIntent(data);
if (result.isSuccess()) {
// The signed-in account is stored in the result.
GoogleSignInAccount signedInAccount = result.getSignInAccount();
showSignInPopup();
} else {
String message = result.getStatus().getStatusMessage();
if (message == null || message.isEmpty()) {
message = getString(R.string.signin_other_error);
}
new AlertDialog.Builder(this).setMessage(message)
.setNeutralButton(android.R.string.ok, null).show();
}
}
}
private void showSignInPopup() {
Games.getGamesClient(requireContext(), signedInAccount)
.setViewForPopups(contentView)
.addOnCompleteListener(
task -> {
if (task.isSuccessful()) {
logger.atInfo().log("SignIn successful");
} else {
logger.atInfo().log("SignIn failed");
}
});
}
Y actualízala a lo siguiente:
private void signInSilently() {
gamesSignInClient.isAuthenticated().addOnCompleteListener(isAuthenticatedTask -> {
boolean isAuthenticated =
(isAuthenticatedTask.isSuccessful() &&
isAuthenticatedTask.getResult().isAuthenticated());
if (isAuthenticated) {
// Continue with Play Games Services
} else {
// If authentication fails, either disable Play Games Services
// integration or
// display a login button to prompt players to sign in.
// Use`gamesSignInClient.signIn()` when the login button is clicked.
}
});
}
@Override
protected void onResume() {
super.onResume();
// When the activity is inactive, the signed-in user's state can change;
// therefore, silently sign in when the app resumes.
signInSilently();
}Kotlin
Ubica los archivos con la clase GoogleSignIn.
// Request codes we use when invoking an external activity.
private val RC_SIGN_IN = 9001
// ... existing code
private fun isSignedIn(): Boolean {
val account = GoogleSignIn.getLastSignedInAccount(this)
val signInOptions = GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN
return GoogleSignIn.hasPermissions(account, *signInOptions.scopeArray)
}
private fun signInSilently() {
val signInOptions = GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN
val signInClient = GoogleSignIn.getClient(this, signInOptions)
signInClient.silentSignIn().addOnCompleteListener(this) { task ->
if (task.isSuccessful) {
// The signed-in account is stored in the task's result.
val signedInAccount = task.result
// Pass the account to showSignInPopup.
showSignInPopup(signedInAccount)
} else {
// Perform interactive sign in.
startSignInIntent()
}
}
}
private fun startSignInIntent() {
val signInClient = GoogleSignIn.getClient(this, GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN)
val intent = signInClient.signInIntent
startActivityForResult(intent, RC_SIGN_IN)
}
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
super.onActivityResult(requestCode, resultCode, data)
if (requestCode == RC_SIGN_IN) {
val result = Auth.GoogleSignInApi.getSignInResultFromIntent(data)
if (result.isSuccess) {
// The signed-in account is stored in the result.
val signedInAccount = result.signInAccount
showSignInPopup(signedInAccount) // Pass the account to showSignInPopup.
} else {
var message = result.status.statusMessage
if (message == null || message.isEmpty()) {
message = getString(R.string.signin_other_error)
}
AlertDialog.Builder(this)
.setMessage(message)
.setNeutralButton(android.R.string.ok, null)
.show()
}
}
}
private fun showSignInPopup(signedInAccount: GoogleSignInAccount) {
// Add signedInAccount parameter.
Games.getGamesClient(this, signedInAccount)
.setViewForPopups(contentView) // Assuming contentView is defined.
.addOnCompleteListener { task ->
if (task.isSuccessful) {
logger.atInfo().log("SignIn successful")
} else {
logger.atInfo().log("SignIn failed")
}
}
}Y actualízala a lo siguiente:
private fun signInSilently() {
gamesSignInClient.isAuthenticated.addOnCompleteListener { isAuthenticatedTask ->
val isAuthenticated = isAuthenticatedTask.isSuccessful &&
isAuthenticatedTask.result.isAuthenticated
if (isAuthenticated) {
// Continue with Play Games Services
} else {
// To handle a user who is not signed in, either disable Play Games Services integration
// or display a login button. Selecting this button calls `gamesSignInClient.signIn()`.
}
}
}
override fun onResume() {
super.onResume()
// Since the state of the signed in user can change when the activity is
// not active it is recommended to try and sign in silently from when the
// app resumes.
signInSilently()
}Agrega el código de GamesSignInClient
Si el jugador se autenticó correctamente, quita el botón de acceso de los Servicios de Play Games de tu juego. Si el usuario decide no autenticarse cuando se inicia el juego, sigue mostrando un botón con el ícono de los Servicios de Play Games y comienza el proceso de acceso con GamesSignInClient.signIn().
Java
private void startSignInIntent() {
gamesSignInClient
.signIn()
.addOnCompleteListener( task -> {
if (task.isSuccessful() && task.getResult().isAuthenticated()) {
// sign in successful
} else {
// sign in failed
}
});
}Kotlin
private fun startSignInIntent() {
gamesSignInClient
.signIn()
.addOnCompleteListener { task ->
if (task.isSuccessful && task.result.isAuthenticated) {
// sign in successful
} else {
// sign in failed
}
}
}Cómo quitar el código de salida
Quita el código de GoogleSignInClient.signOut.
Quita el código que se muestra en el siguiente ejemplo:
Java
// ... existing code
private void signOut() {
GoogleSignInClient signInClient = GoogleSignIn.getClient(this,
GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN);
signInClient.signOut().addOnCompleteListener(this,
new OnCompleteListener() {
@Override
public void onComplete(@NonNull Task task) {
// At this point, the user is signed out.
}
});
} Kotlin
// ... existing code
private fun signOut() {
val signInClient = GoogleSignIn.getClient(this, GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN)
signInClient.signOut().addOnCompleteListener(this) {
// At this point, the user is signed out.
}
}Cómo verificar la autenticación correcta
Incluye el siguiente código para verificar si te autenticaste automáticamente y agrega la lógica personalizada si la tienes disponible.
Java
private void checkIfAutomaticallySignedIn() {
gamesSignInClient.isAuthenticated().addOnCompleteListener(isAuthenticatedTask -> {
boolean isAuthenticated =
(isAuthenticatedTask.isSuccessful() &&
isAuthenticatedTask.getResult().isAuthenticated());
if (isAuthenticated) {
// Continue with Play Games Services
// If your game requires specific actions upon successful sign-in,
// you can add your custom logic here.
// For example, fetching player data or updating UI elements.
} else {
// Show a login button to ask players to sign-in. Clicking it should
// call GamesSignInClient.signIn().
}
});
}
Kotlin
private void checkIfAutomaticallySignedIn() {
gamesSignInClient.isAuthenticated()
.addOnCompleteListener { task ->
val isAuthenticated = task.isSuccessful && task.result?.isAuthenticated ?: false
if (isAuthenticated) {
// Continue with Play Games Services
} else {
// Disable your integration or show a login button
}
}
}
Actualiza los nombres y métodos de las clases de cliente
Cuando migres a la versión 2 de los juegos, los métodos que se usan para obtener los nombres de las clases de cliente serán diferentes. En su lugar, usa los métodos PlayGames.getxxxClient() correspondientes en lugar de los métodos Games.getxxxClient().
Por ejemplo, para LeaderboardsClient, usa PlayGames.getLeaderboardsClient() en lugar del método Games.getLeaderboardsClient().
Quita cualquier código relacionado con las clases GamesClient y GamesMetadataClient, ya que no tenemos ninguna clase de reemplazo en la versión 2 de los juegos.
Java
Ubica el código de LeaderboardsClient.
import com.google.android.gms.games.LeaderboardsClient;
import com.google.android.gms.games.Games;
@Override
public void onCreate(@Nullable Bundle bundle) {
super.onCreate(bundle);
// Get the leaderboards client using Play Games services.
LeaderboardsClient leaderboardsClient = Games.getLeaderboardsClient(this,
GoogleSignIn.getLastSignedInAccount(this));
}
Y actualízala a lo siguiente:
import com.google.android.gms.games.LeaderboardsClient;
import com.google.android.gms.games.PlayGames;
@Override
public void onCreate(@Nullable Bundle bundle) {
super.onCreate(bundle);
// Get the leaderboards client using Play Games services.
LeaderboardsClient leaderboardsClient = PlayGames.getLeaderboardsClient(getActivity());
}
Kotlin
Ubica el código de LeaderboardsClient.
import com.google.android.gms.games.LeaderboardsClient
import com.google.android.gms.games.Games
// Initialize the variables.
private lateinit var leaderboardsClient: LeaderboardsClient
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
leaderboardsClient = Games.getLeaderboardsClient(this,
GoogleSignIn.getLastSignedInAccount(this))
}Y actualízala a lo siguiente:
import com.google.android.gms.games.LeaderboardsClient
import com.google.android.gms.games.PlayGames
// Initialize the variables.
private lateinit var leaderboardsClient: LeaderboardsClient
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
leaderboardsClient = PlayGames.getLeaderboardsClient(this)
}De manera similar, usa los métodos correspondientes para los siguientes clientes: AchievementsClient, EventsClient, GamesSignInClient, PlayerStatsClient, RecallClient, SnapshotsClient o PlayersClient.
Actualiza las clases de acceso del servidor
Para solicitar un token de acceso del servidor, usa el método GamesSignInClient.requestServerSideAccess() en lugar del método GoogleSignInAccount.getServerAuthCode().
Para obtener más información, consulta Envía el código de autorización del servidor.
En el siguiente ejemplo, se muestra cómo solicitar un token de acceso del servidor.
Java
Busca el código de la clase GoogleSignInOptions.
private static final int RC_SIGN_IN = 9001;
private GoogleSignInClient googleSignInClient;
private void startSignInForAuthCode() {
/** Client ID for your backend server. */
String webClientId = getString(R.string.webclient_id);
GoogleSignInOptions signInOption = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN)
.requestServerAuthCode(webClientId)
.build();
GoogleSignInClient signInClient = GoogleSignIn.getClient(this, signInOption);
Intent intent = signInClient.getSignInIntent();
startActivityForResult(intent, RC_SIGN_IN);
}
/** Auth code to send to backend server */
private String mServerAuthCode;
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == RC_SIGN_IN) {
GoogleSignInResult result = Auth.GoogleSignInApi.getSignInResultFromIntent(data);
if (result.isSuccess()) {
mServerAuthCode = result.getSignInAccount().getServerAuthCode();
} else {
String message = result.getStatus().getStatusMessage();
if (message == null || message.isEmpty()) {
message = getString(R.string.signin_other_error);
}
new AlertDialog.Builder(this).setMessage(message)
.setNeutralButton(android.R.string.ok, null).show();
}
}
}
Y actualízala a lo siguiente:
private void startRequestServerSideAccess() {
GamesSignInClient gamesSignInClient = PlayGames.getGamesSignInClient(this);
gamesSignInClient
.requestServerSideAccess(OAUTH_2_WEB_CLIENT_ID,
/* forceRefreshToken= */ false, /* additional AuthScope */ scopes)
.addOnCompleteListener(task -> {
if (task.isSuccessful()) {
AuthResponse authresp = task.getResult();
// Send the authorization code as a string and a
// list of the granted AuthScopes that were granted by the
// user. Exchange for an access token.
// Verify the player with Play Games Services REST APIs.
} else {
// Authentication code retrieval failed.
}
});
}
Kotlin
Busca el código de la clase GoogleSignInOptions.
// ... existing code
private val RC_SIGN_IN = 9001
private lateinit var googleSignInClient: GoogleSignInClient
// Auth code to send to backend server.
private var mServerAuthCode: String? = null
private fun startSignInForAuthCode() {
// Client ID for your backend server.
val webClientId = getString(R.string.webclient_id)
val signInOption = GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN)
.requestServerAuthCode(webClientId)
.build()
googleSignInClient = GoogleSignIn.getClient(this, signInOption)
val intent = googleSignInClient.signInIntent
startActivityForResult(intent, RC_SIGN_IN)
}
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
super.onActivityResult(requestCode, resultCode, data)
if (requestCode == RC_SIGN_IN) {
val result = Auth.GoogleSignInApi.getSignInResultFromIntent(data)
if (result.isSuccess) {
mServerAuthCode = result.signInAccount.serverAuthCode
} else {
var message = result.status.statusMessage
if (message == null || message.isEmpty()) {
message = getString(R.string.signin_other_error)
}
AlertDialog.Builder(this).setMessage(message)
.setNeutralButton(android.R.string.ok, null).show()
}
}
}
Y actualízala a lo siguiente:
private void startRequestServerSideAccess() {
GamesSignInClient gamesSignInClient = PlayGames.getGamesSignInClient(this);
gamesSignInClient
.requestServerSideAccess(OAUTH_2_WEB_CLIENT_ID, /* forceRefreshToken= */ false,
/* additional AuthScope */ scopes)
.addOnCompleteListener(task -> {
if (task.isSuccessful()) {
AuthResponse authresp = task.getResult();
// Send the authorization code as a string and a
// list of the granted AuthScopes that were granted by the
// user. Exchange for an access token.
// Verify the player with Play Games Services REST APIs.
} else {
// Authentication code retrieval failed.
}
});
}
Migra desde GoogleApiClient
En el caso de las integraciones existentes, es posible que tu juego dependa de la variante de API GoogleApiClient del SDK de los Servicios de juego de Play. Esta función dejó de estar disponible a fines de 2017 y se reemplazó por clientes "sin conexión".
Para migrar, puedes reemplazar la clase GoogleApiClient por un equivalente "sin conexión".
En la siguiente tabla, se enumeran las asignaciones de clases comunes de la versión 1 a la versión 2 de la API de Games:
| games v2 (actual) | games v1 (heredado) |
|---|---|
| com.google.android.gms.games.AchievementsClient | com.google.android.gms.games.achievement.Achievements |
| com.google.android.gms.games.LeaderboardsClient | com.google.android.gms.games.leaderboard.Leaderboard |
| com.google.android.gms.games.SnapshotsClient | com.google.android.gms.games.snapshot.Snapshots |
| com.google.android.gms.games.PlayerStatsClient | com.google.android.gms.games.stats.PlayerStats |
| com.google.android.gms.games.PlayersClient | com.google.android.gms.games.Players |
| com.google.android.gms.games.GamesClientStatusCodes | com.google.android.gms.games.GamesStatusCodes |
Compila y ejecuta el juego
Para compilar y ejecutar en Android Studio, consulta Cómo compilar y ejecutar tu app.
Cómo probar tu juego
Prueba el juego para asegurarte de que funcione según lo previsto. Las pruebas que realices dependerán de las funciones del juego.
A continuación, se incluye una lista de pruebas comunes que se pueden ejecutar.
Acceso correcto.
El acceso automático funciona. El usuario debe acceder a los Servicios de Play Games cuando inicie el juego.
Se muestra la ventana emergente de bienvenida.
Ejemplo de ventana emergente de bienvenida (haz clic para agrandar). Se muestran los mensajes de registro correctos. Ejecuta el siguiente comando en la terminal:
adb logcat | grep com.google.android.
En el siguiente ejemplo, se muestra un mensaje de registro exitoso:
[
$PlaylogGamesSignInAction$SignInPerformerSource@e1cdecc number=1 name=GAMES_SERVICE_BROKER>], returning true for shouldShowWelcomePopup. [CONTEXT service_id=1 ]
Garantiza la coherencia de los componentes de la IU.
Las ventanas emergentes, las tablas de clasificación y los logros se muestran de forma correcta y coherente en varios tamaños y orientaciones de pantalla en la interfaz de usuario (IU) de los Servicios de Play Games.
La opción para salir no está visible en la IU de los Servicios de Play Games.
Asegúrate de poder recuperar el ID de jugador correctamente y, si corresponde, de que las capacidades del servidor funcionen según lo esperado.
Si el juego usa la autenticación del servidor, prueba a fondo el flujo de
requestServerSideAccess. Asegúrate de que el servidor reciba el código de autorización y pueda intercambiarlo por un token de acceso. Prueba las situaciones de éxito y de error para los errores de red y las situaciones declient IDno válidas.
Si tu juego usaba alguna de las siguientes funciones, pruébalas para asegurarte de que funcionen igual que antes de la migración:
- Tablas de clasificación: Envía puntuaciones y consulta las tablas de clasificación. Verifica la clasificación y la visualización correctas de los nombres y las puntuaciones de los jugadores.
- Logros: Desbloquea logros y verifica que se registren y muestren correctamente en la IU de Play Juegos.
- Juegos guardados: Si el juego usa juegos guardados, asegúrate de que guardar y cargar el progreso del juego funcione sin problemas. Esto es especialmente importante para probar en varios dispositivos y después de las actualizaciones de la app.
Tareas posteriores a la migración
Completa los siguientes pasos después de migrar a la versión 2 de la API de Games.
Publica el juego
Crea los APKs y publica el juego en Play Console.
- En el menú de Android Studio, selecciona Build > Build Bundles(s) / APK(s) > Build APK(s).
- Publica tu juego. Para obtener más información, consulta Cómo publicar apps privadas desde Play Console.