Play Games Hizmetleri v2'ye taşıma (Java veya Kotlin)

Bu dokümanda, mevcut oyunların games v1 SDK'sından games v2 SDK'sına nasıl taşınacağı açıklanmaktadır.

Başlamadan önce

Oyununuzu taşımak için Android Studio gibi tercih ettiğiniz IDE'yi kullanabilirsiniz. games v2'ye geçmeden önce aşağıdaki adımları tamamlayın:

Bağımlılıkları güncelleme

  1. Modülünüzün build.gradle dosyasında, modül düzeyindeki bağımlılıklarda bu satırı bulun.

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

    Aşağıdaki kodla değiştirin:

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

    version yerine oyun SDK'sının en son sürümünü girin.

  2. Bağımlılıkları güncelledikten sonra bu belgedeki tüm adımları tamamladığınızdan emin olun.

Desteği sonlandırılan Google ile oturum açma özelliğinden taşıma

GoogleSignInClient sınıfını GamesSignInClient sınıfıyla değiştirin.

Java

GoogleSignInClient sınıfına ait dosyaları bulun.

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

    val signInOptions = GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN
    // Client used to sign in to Google services
    GoogleSignInClient googleSignInClient =
        GoogleSignIn.getClient(this, signInOptions);
}

Ardından şu şekilde güncelleyin:

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();
    // Client used to sign in to Google services
    GamesSignInClient gamesSignInClient =
        PlayGames.getGamesSignInClient(getActivity());
}

Kotlin

GoogleSignInClient sınıfına ait dosyaları bulun.

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

Ardından şu şekilde güncelleyin:

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

GoogleSignIn kodunu güncelleme

GoogleSignIn API ve kapsamları, games v2 SDK'sında desteklenmez. OAuth 2.0 kapsamları için GoogleSignIn API kodunu aşağıdaki örnekte gösterildiği gibi GamesSignInClient API ile değiştirin:

Java

GoogleSignIn sınıfına ve kapsamlarına sahip dosyaları bulun.

// 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");
            }
        });
  }

Ardından şu şekilde güncelleyin:

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

GoogleSignIn sınıfına ve kapsamlarına sahip dosyaları bulun.

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

Ardından şu şekilde güncelleyin:

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

GamesSignInClient kodunu ekleme

Oyuncu başarıyla oturum açtıysa Play Oyun Hizmetleri oturum açma düğmesini oyununuzdan kaldırın. Kullanıcı oyun başlatıldığında oturum açmayı tercih etmezse Play Oyun Hizmetleri simgesini içeren bir düğme göstermeye devam edin ve GamesSignInClient.signIn() ile giriş işlemini başlatın.

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

Oturum kapatma kodunu kaldırma

GoogleSignInClient.signOut için kodu kaldırın.

Aşağıdaki örnekte gösterilen kodu kaldırın:

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

Otomatik oturum açmanın başarılı olup olmadığını kontrol etme

Otomatik olarak oturum açıp açmadığınızı kontrol etmek için aşağıdaki kodu ekleyin ve varsa özel mantığı ekleyin.

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 {
        // Disable your integration with Play Games Services or 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
        }
    }
}

İstemci sınıfı adlarını ve yöntemlerini güncelleme

games v2'ye geçiş yaptığınızda istemci sınıfı adlarını almak için kullanılan yöntemler farklıdır. Games.getxxxClient() yöntemleri yerine ilgili PlayGames.getxxxClient() yöntemlerini kullanın.

Örneğin, LeaderboardsClient için Games.getLeaderboardsClient() yöntemi yerine PlayGames.getLeaderboardsClient() yöntemini kullanın.

Java

LeaderboardsClient için kodu bulun.

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

Ardından şu şekilde güncelleyin:

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

LeaderboardsClient için kodu bulun.

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

Ardından şu şekilde güncelleyin:

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

Benzer şekilde, aşağıdaki istemciler için ilgili yöntemleri kullanın: AchievementsClient, EventsClient, GamesSignInClient, PlayerStatsClient, RecallClient, SnapshotsClient veya PlayersClient.

Sunucu tarafı erişim sınıflarını güncelleme

Sunucu tarafı erişim jetonu istemek için GoogleSignInAccount.getServerAuthCode() yöntemi yerine GamesSignInClient.requestServerSideAccess() yöntemini kullanın.

Aşağıdaki örnekte, sunucu tarafı erişim jetonunun nasıl isteneceği gösterilmektedir.

Java

GoogleSignInOptions sınıfının kodunu bulun.

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

Ardından şu şekilde güncelleyin:

  private void startRequestServerSideAccess() {
      GamesSignInClient gamesSignInClient = PlayGames.getGamesSignInClient(this);
      gamesSignInClient
          .requestServerSideAccess(OAUTH_2_WEB_CLIENT_ID, /* forceRefreshToken= */ false)
          .addOnCompleteListener(task -> {
              if (task.isSuccessful()) {
                  String serverAuthToken = task.getResult();
                  // Send authentication code to the backend game server.
                  // Exchange for an access token.
                  // Verify the player with Play Games Services REST APIs.
              } else {
                // Authentication code retrieval failed.
              }
        });
  }

Kotlin

GoogleSignInOptions sınıfının kodunu bulun.

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

Ardından şu şekilde güncelleyin:

  private void startRequestServerSideAccess() {
  GamesSignInClient gamesSignInClient = PlayGames.getGamesSignInClient(this);
      gamesSignInClient
          .requestServerSideAccess(OAUTH_2_WEB_CLIENT_ID, /* forceRefreshToken= */ false)
          .addOnCompleteListener(task -> {
              if (task.isSuccessful()) {
                  String serverAuthToken = task.getResult();
                  // Send authentication code to the backend game server.
                  // Exchange for an access token.
                  // Verify the player with Play Games Services REST APIs.
              } else {
                // Authentication code retrieval failed.
              }
        });
  }

GoogleApiClient'ten taşıma

Mevcut eski entegrasyonlarda oyununuz Play Games Hizmetleri SDK'sının GoogleApiClient API varyantını kullanıyor olabilir. Bu protokol 2017'nin sonlarında desteği sonlandırıldı ve "bağlantısız" istemcilerle değiştirildi. Taşıma işlemi için GoogleApiClient sınıfını "bağlantısız" eşdeğeriyle değiştirebilirsiniz. Aşağıdaki tabloda, oyunlar v1 ile oyunlar v2 arasındaki ortak sınıf eşlemeleri listelenmiştir:

games v2 (Mevcut) games v1 (Eski)
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

Oyunu derleyip çalıştırma

Android Studio'da derleyip çalıştırmak için Uygulamanızı derleyip çalıştırma başlıklı makaleyi inceleyin.

Oyununuzu test etme

Oyununuzu test ederek tasarlandığı gibi çalıştığından emin olun. Yaptığınız testler oyununuzun özelliklerine bağlıdır.

Aşağıda, çalıştırılacak yaygın testlerin listesi verilmiştir.

  1. Başarılı oturum açma.

    1. Otomatik oturum açma özelliği çalışır. Kullanıcı, oyunu başlattığında Play Games Hizmetleri'nde oturum açmış olmalıdır.

    2. Karşılama pop-up'ı gösterilir.

      Örnek karşılama pop-up'ı.
      Örnek karşılama pop-up'ı (büyütmek için tıklayın).

    3. Başarılı günlük mesajları gösterilir. Terminalde aşağıdaki komutu çalıştırın:

      adb logcat | grep com.google.android.

      Aşağıdaki örnekte başarılı bir günlük mesajı gösterilmektedir:

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

  2. Kullanıcı arayüzü bileşenlerinin tutarlı olmasını sağlayın.

    1. Pop-up'lar, skor tabloları ve başarılar, Play Oyun Hizmetleri kullanıcı arayüzünde (UI) çeşitli ekran boyutlarında ve yönlerinde doğru ve tutarlı şekilde gösterilir.

    2. Oturum kapatma seçeneği Play Oyun Hizmetleri kullanıcı arayüzünde görünmüyor.

    3. Oynatıcı kimliğini başarıyla alabildiğinizden ve varsa sunucu tarafı özelliklerinin beklendiği gibi çalıştığından emin olun.

    4. Oyunda sunucu tarafı kimlik doğrulama kullanılıyorsa requestServerSideAccess akışını ayrıntılı bir şekilde test edin. Sunucunun kimlik doğrulama kodunu aldığından ve bu kodu bir erişim jetonuyla değiştirebildiğinden emin olun. Ağ hataları ve geçersiz client ID senaryoları için hem başarılı hem de başarısız senaryoları test edin.

Oyununuz aşağıdaki özelliklerden herhangi birini kullanıyorsa taşıma işleminden önceki gibi çalıştıklarından emin olmak için bunları test edin:

  • Skor tabloları: Puanlar gönderin ve skor tablolarını görüntüleyin. Sıralama, oyuncu adları ve puanlarının doğru şekilde gösterilip gösterilmediğini kontrol edin.
  • Başarılar: Başarıların kilidini açın ve Play Games kullanıcı arayüzünde doğru şekilde kaydedilip görüntülendiğini doğrulayın.
  • Kayıtlı Oyunlar: Oyunda kayıtlı oyunlar kullanılıyorsa oyun ilerleme durumunun kaydedilip yüklenmesinin sorunsuz çalıştığından emin olun. Bu, özellikle birden fazla cihazda ve uygulama güncellemelerinden sonra test etmek için kritik öneme sahiptir.

Taşıma sonrası görevler

games v2'ye geçtikten sonra aşağıdaki adımları tamamlayın.

Oyunu yayınlama

APK'ları derleyin ve oyunu Play Console'da yayınlayın.

  1. Android Studio menüsünde Derle > Paketleri/APK'ları Derle > APK'ları Derle'yi seçin.
  2. Oyununuzu yayınlayın. Daha fazla bilgi için Play Console'dan özel uygulama yayınlama başlıklı makaleyi inceleyin.