Bermigrasi ke Layanan game Play v2 (Java atau Kotlin)

Dokumen ini menjelaskan cara memigrasikan game yang ada dari SDK game v1 ke SDK game v2.

Sebelum memulai

Anda dapat menggunakan IDE pilihan, seperti Android Studio, untuk memigrasikan game. Selesaikan langkah-langkah berikut sebelum Anda bermigrasi ke game v2:

  • Mendownload dan menginstal Android Studio
  • Game Anda harus menggunakan SDK game v1.
  • Anda dapat mengupgrade game untuk menggunakan SDK game v1 ke com.google.android.gms:play-services-games:24.0.0. Anda tidak boleh mengupgrade ke com.google.android.gms:play-services-games:25.0.0 karena API game v1 telah dihapus.

Perbarui dependensi

  1. Dalam file build.gradle modul Anda, temukan baris ini dalam dependensi tingkat modul.

    implementation "com.google.android.gms:play-services-games:+"

    Ganti dengan kode berikut:

    implementation "com.google.android.gms:play-services-games-v2:version"

    Ganti version dengan SDK game versi terbaru.

  2. Setelah memperbarui dependensi, pastikan Anda menyelesaikan semua langkah dalam dokumen ini.

Menentukan project ID

Untuk menambahkan project ID SDK Layanan game Play ke aplikasi Anda, selesaikan langkah-langkah berikut:

  1. Dalam file AndroidManifest.xml, tambahkan elemen dan atribut <meta-data> berikut ke elemen <application>:

    <manifest>
      <application>
        <meta-data android:name="com.google.android.gms.games.APP_ID"
                   android:value="@string/game_services_project_id"/>
      </application>
    </manifest>
    

    Tentukan referensi resource String @string/game_services_project_id menggunakan project ID layanan Game milik game Anda sebagai nilai. Project ID layanan Game Anda dapat ditemukan pada bagian nama game di halaman Konfigurasi di Konsol Google Play.

  2. Dalam file res/values/strings.xml, tambahkan referensi resource string dan tetapkan project ID Anda sebagai nilai. Contoh:

    <!-- 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>
    

Jalur migrasi

Jalur migrasi yang tepat untuk game Anda bergantung pada cara game tersebut menerapkan Layanan Play Games v1 dan menangani identitas pemain. Untuk memastikan transisi yang lancar dan mencegah hilangnya data pemain, identifikasi skenario yang paling sesuai dengan penyiapan yang ada dan ikuti langkah-langkah yang sesuai.

Opsi 1: Untuk Game yang IGA-nya terikat ke ID Pemain Layanan Play Games

Skenario ini berlaku untuk game yang telah menggunakan Player ID Layanan game Play sebagai satu-satunya ID untuk Akun Dalam Game (IGA) pemain dan belum pernah meminta atau menyimpan OpenID sebelumnya. Tantangan utamanya adalah menautkan IGA yang ada ke ID utama (Player ID) tanpa kehilangan koneksi ke progres pemain.OpenID

Alur migrasi mencakup langkah-langkah berikut:

  1. Saat game diluncurkan, SDK Layanan Play Games v2 akan otomatis dan diam-diam mengautentikasi platform.
  2. Menampilkan layar login yang menampilkan tombol Login dengan Google, menggantikan tombol Google Play. Misalnya, lihat 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: LOGIN INTERAKTIF (Dipanggil saat Tombol Diklik) --- // Memaksa sheet Pemilihan Akun / "Tambahkan Akun" muncul. 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());
    }
    

    } }

  3. Mengambil dua ID berbeda saat pemain mengetuk tombol Login dengan Google dan memilih Akun Google:

    • OpenID, yang merupakan ID utama untuk mengikat IGA.
    • Player ID Layanan Play Games, yang diambil menggunakan cakupan GAMES_LITE, untuk mencari IGA pemain di sistem backend Anda dan melakukan pengikatan. Untuk mengetahui informasi selengkapnya, lihat Mengambil Player ID.
  4. Akses IGA melalui alur Login dengan Google pada peluncuran game berikutnya, tanpa mewajibkan game menggunakan Player ID sebagai ID utama.

Mengambil Player ID

Anda dapat melakukan langkah 3 menggunakan implementasi sisi klien game.

  1. Panggil Android Credential Manager API untuk login pengguna dengan Akun Google.
  2. Setelah pengguna menyelesaikan alur Login dengan Google dan memilih Akun Google, terima objek hasil yang berisi token ID dan alamat email.
  3. Buat objek Akun dari alamat email.
  4. Panggil Authorization API dengan cakupan GAMES_LITE dan Akun.
  5. Jika akun memiliki pemberian izin yang sudah ada sebelumnya pada cakupan GAMES_LITE, Authorization API akan menampilkan token secara langsung dalam objek respons:
    1. Gunakan token respons untuk memanggil server Layanan Play Games dan mengambil Player ID Layanan Play Games.
    2. Verifikasi apakah Layanan Play Games Player ID ditautkan dengan akun dalam game.
      1. Ini menunjukkan pengguna yang kembali dari Layanan Play Games v1.
    3. Tautkan ID GAIA baru dengan akun Layanan Play Games v1 sebelumnya.
  6. Jika akun tidak memiliki pemberian izin yang sudah ada sebelumnya pada cakupan GAMES_LITE, Authorization API akan menampilkan PendingIntent:
    1. Hal ini menunjukkan bahwa pengguna tidak memiliki akun yang sudah ada dari Layanan Play Games v1.
    2. Buang PendingIntent dengan aman tanpa menampilkan UI apa pun.

Opsi 2: Untuk Game yang sudah mengikat IGA ke OpenID

Developer dalam grup ini memiliki jalur migrasi yang paling mudah. Jika akun dalam game Anda sudah terikat terutama ke OpenID, Anda hanya perlu melakukan migrasi SDK teknis standar dari v1 ke v2 seperti yang diuraikan dalam langkah-langkahnya.

Bermigrasi dari Login dengan Google yang tidak digunakan lagi

Ganti class GoogleSignInClient dengan class GamesSignInClient.

Java

Cari file dengan class 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);
}

Lalu, perbarui menjadi:

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

Cari file dengan class 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)
}

Lalu, perbarui menjadi:

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)
}

Perbarui kode GoogleSignIn

GoogleSignIn API tidak didukung di SDK game v2. Ganti kode GoogleSignIn API dengan GamesSignInClient API seperti yang ditunjukkan dalam contoh berikut.

Untuk meminta token akses sisi server, gunakan metode GamesSignInClient.requestServerSideAccess(). Untuk mengetahui informasi selengkapnya, lihat Memperbarui class akses sisi server.

Java

Cari file dengan class 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");
            }
        });
  }

Lalu, perbarui menjadi:

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

Cari file dengan class 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")
        }
    }
}

Lalu, perbarui menjadi:

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

Tambahkan kode GamesSignInClient

Jika pemain berhasil diautentikasi, hapus tombol login Layanan Play Games dari game Anda. Jika pengguna memilih untuk tidak melakukan autentikasi saat game diluncurkan, terus tampilkan tombol dengan ikon Layanan Play Games, dan mulai proses login dengan 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
            }
        }
  }

Menghapus kode logout

Hapus kode untuk GoogleSignInClient.signOut.

Hapus kode yang ditampilkan dalam contoh berikut:

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.
    }
}

Memeriksa keberhasilan autentikasi

Sertakan kode berikut untuk memeriksa apakah Anda telah diautentikasi secara otomatis dan menambahkan logika kustom jika tersedia.

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
        }
    }
}

Memperbarui nama dan metode class klien

Saat Anda bermigrasi ke game v2, metode yang digunakan untuk mendapatkan nama class klien berbeda. Gunakan metode PlayGames.getxxxClient() yang sesuai, bukan metode Games.getxxxClient().

Misalnya, untuk LeaderboardsClient gunakan PlayGames.getLeaderboardsClient(), bukan metode Games.getLeaderboardsClient().

Hapus kode apa pun yang terkait dengan class GamesClient dan GamesMetadataClient karena kita tidak memiliki class pengganti di Games v2.

Java

Cari kode untuk 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));
}

Lalu, perbarui menjadi:

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

Cari kode untuk 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))
}

Lalu, perbarui menjadi:

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)
}

Demikian pula, gunakan metode yang sesuai untuk klien berikut: AchievementsClient, EventsClient, GamesSignInClient, PlayerStatsClient, RecallClient, SnapshotsClient, atau PlayersClient.

Memperbarui class akses sisi server

Untuk meminta token akses sisi server, gunakan metode GamesSignInClient.requestServerSideAccess(), bukan metode GoogleSignInAccount.getServerAuthCode().

Untuk mengetahui informasi selengkapnya, lihat Mengirim kode autentikasi server.

Contoh berikut menunjukkan cara meminta token akses sisi server.

Java

Temukan kode untuk class 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();
        }
      }
    }
  

Lalu, perbarui menjadi:

  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

Temukan kode untuk class 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()
            }
        }
  }
  

Lalu, perbarui menjadi:

  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.
              }
        });
  }
  

Migrasi dari GoogleApiClient

Untuk integrasi lama, game Anda mungkin bergantung pada variasi GoogleApiClient API SDK Layanan game Play. Perangkat ini tidak digunakan lagi pada akhir 2017 dan digantikan oleh klien "tanpa koneksi". Untuk bermigrasi, Anda dapat mengganti class GoogleApiClient dengan yang setara "tanpa koneksi". Tabel berikut mencantumkan pemetaan class umum dari game v1 ke game v2:

games v2 (Saat ini) games v1 (Legacy)
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

Membangun dan menjalankan game

Untuk mem-build dan menjalankan di Android Studio, lihat Mem-build dan menjalankan aplikasi Anda.

Menguji game Anda

Pastikan game Anda berfungsi seperti yang dirancang dengan mengujinya. Pengujian yang Anda lakukan bergantung pada fitur game Anda.

Berikut adalah daftar pengujian umum yang dapat dijalankan.

  1. Login berhasil.

    1. Login otomatis berfungsi. Pengguna harus login ke Layanan Play Games saat meluncurkan game.

    2. Pop-up selamat datang ditampilkan.

      Contoh pop-up selamat datang.
      Contoh pop-up selamat datang (klik untuk memperbesar).

    3. Pesan log yang berhasil akan ditampilkan. Jalankan perintah berikut di terminal:

      adb logcat | grep com.google.android.

      Pesan log yang berhasil ditampilkan dalam contoh berikut:

      [$PlaylogGamesSignInAction$SignInPerformerSource@e1cdecc
      number=1 name=GAMES_SERVICE_BROKER>], returning true for shouldShowWelcomePopup.
      [CONTEXT service_id=1 ]
  2. Pastikan konsistensi komponen UI.

    1. Pop-up, papan peringkat, dan pencapaian ditampilkan dengan benar dan konsisten pada berbagai ukuran dan orientasi layar di antarmuka pengguna (UI) Layanan Play Games.

    2. Opsi logout tidak terlihat di UI Layanan Play Games.

    3. Pastikan Anda dapat mengambil ID Pemain dengan berhasil, dan jika berlaku, kemampuan sisi server berfungsi seperti yang diharapkan.

    4. Jika game menggunakan autentikasi sisi server, uji alur requestServerSideAccess secara menyeluruh. Pastikan server menerima kode autentikasi dan dapat menukarkannya dengan token akses. Uji skenario keberhasilan dan kegagalan untuk error jaringan, skenario client ID yang tidak valid.

Jika game Anda menggunakan salah satu fitur berikut, uji fitur tersebut untuk memastikan bahwa fitur tersebut berfungsi sama seperti sebelum migrasi:

  • Papan Peringkat: Kirim skor dan lihat papan peringkat. Periksa peringkat dan tampilan nama serta skor pemain yang benar.
  • Pencapaian: Buka kunci pencapaian dan verifikasi bahwa pencapaian tersebut dicatat dan ditampilkan dengan benar di UI Play Game.
  • Game Tersimpan: Jika game menggunakan game tersimpan, pastikan penyimpanan dan pemuatan progres game berfungsi dengan lancar. Hal ini sangat penting untuk diuji di beberapa perangkat dan setelah update aplikasi.

Tugas pascamigrasi

Selesaikan langkah-langkah berikut setelah Anda bermigrasi ke game v2.

Publikasikan game

Buat APK dan publikasikan game di Konsol Play.

  1. Di menu Android Studio, pilih Build > Build Bundles(s) / APK(s) > Build APK(s).
  2. Publikasikan game Anda. Untuk mengetahui informasi selengkapnya, lihat Memublikasikan aplikasi pribadi dari Konsol Play.