مهاجرت به Play Games Services v2 (Java یا Kotlin)

این سند نحوه انتقال بازی‌های موجود از games v1 SDK به games v2 SDK را شرح می‌دهد.

قبل از اینکه شروع کنی

شما می‌توانید از هر IDE دلخواهی، مانند اندروید استودیو، برای مهاجرت بازی خود استفاده کنید. قبل از مهاجرت به games v2، مراحل زیر را انجام دهید:

وابستگی‌ها را به‌روزرسانی کنید

  1. در فایل build.gradle ماژول خود، این خط را در وابستگی‌های سطح ماژول پیدا کنید.

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

    آن را با کد زیر جایگزین کنید:

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

    version با آخرین نسخه SDK بازی جایگزین کنید.

  2. پس از به‌روزرسانی وابستگی‌ها، مطمئن شوید که تمام مراحل این سند را تکمیل کرده‌اید.

تعریف شناسه پروژه

برای افزودن شناسه پروژه SDK سرویس‌های Play Games به برنامه خود، مراحل زیر را انجام دهید:

  1. در فایل AndroidManifest.xml ، عنصر <meta-data> و ویژگی‌های زیر را به عنصر <application> اضافه کنید:

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

    مرجع منبع String را با استفاده از شناسه پروژه خدمات بازی بازی‌های خود به عنوان مقدار @string/game_services_project_id تعریف کنید. شناسه پروژه خدمات بازی‌های شما را می‌توانید زیر نام بازی خود در صفحه پیکربندی در کنسول Google Play پیدا کنید.

  2. در فایل res/values/strings.xml ، یک مرجع منبع رشته‌ای اضافه کنید و شناسه پروژه خود را به عنوان مقدار تنظیم کنید. برای مثال:

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

مهاجرت از ورود به سیستم گوگل منسوخ‌شده

کلاس GoogleSignInClient را با کلاس GamesSignInClient جایگزین کنید.

جاوا

فایل‌ها را با کلاس 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);
}

و آن را به این به‌روزرسانی کنید:

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

کاتلین

فایل‌ها را با کلاس 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)
}

و آن را به این به‌روزرسانی کنید:

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 را به‌روزرسانی کنید

API GoogleSignIn API) در کیت توسعه نرم‌افزار (SDK) نسخه ۲ بازی‌ها پشتیبانی نمی‌شود. کد API GoogleSignIn API) را مطابق مثال زیر با API GamesSignInClient API) جایگزین کنید.

برای درخواست توکن دسترسی سمت سرور، از متد GamesSignInClient.requestServerSideAccess() استفاده کنید. برای اطلاعات بیشتر، به Update the server side access classes مراجعه کنید.

جاوا

فایل‌ها را با کلاس 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");
            }
        });
  }

و آن را به این به‌روزرسانی کنید:

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

کاتلین

فایل‌ها را با کلاس 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")
        }
    }
}

و آن را به این به‌روزرسانی کنید:

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 را اضافه کنید

اگر احراز هویت بازیکن با موفقیت انجام شد، دکمه ورود به سیستم Play Games Services را از بازی خود حذف کنید. اگر کاربر هنگام اجرای بازی تصمیم به عدم احراز هویت گرفت، دکمه‌ای با آیکون Play Games Services را نمایش دهید و فرآیند ورود به سیستم را با GamesSignInClient.signIn() آغاز کنید.

جاوا

private void startSignInIntent() {
    gamesSignInClient
        .signIn()
        .addOnCompleteListener( task -> {
            if (task.isSuccessful() && task.getResult().isAuthenticated()) {
                // sign in successful
            } else {
                // sign in failed
            }
        });
  }

کاتلین

private fun startSignInIntent() {
    gamesSignInClient
        .signIn()
        .addOnCompleteListener { task ->
            if (task.isSuccessful && task.result.isAuthenticated) {
                // sign in successful
            } else {
                // sign in failed
            }
        }
  }

حذف کد خروج

کد مربوط به GoogleSignInClient.signOut را حذف کنید.

کد نشان داده شده در مثال زیر را حذف کنید:

جاوا

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

کاتلین

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

بررسی احراز هویت موفق

کد زیر را برای بررسی اینکه آیا به طور خودکار احراز هویت شده‌اید یا خیر، وارد کنید و در صورت وجود منطق سفارشی، آن را اضافه کنید.

جاوا

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

کاتلین

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

به‌روزرسانی نام‌ها و متدهای کلاس کلاینت

وقتی به games v2 مهاجرت می‌کنید، متدهای مورد استفاده برای دریافت نام کلاس‌های کلاینت متفاوت هستند. به جای متدهای Games.getxxxClient PlayGames.getxxxClient() Games.getxxxClient() مربوطه استفاده کنید.

برای مثال، برای LeaderboardsClient به جای متد Games.getLeaderboardsClient PlayGames.getLeaderboardsClient() Games.getLeaderboardsClient() استفاده کنید.

هر کدی که مربوط به کلاس‌های GamesClient و GamesMetadataClient است را حذف کنید، زیرا هیچ کلاس جایگزینی در بازی‌ها نسخه ۲ نداریم.

جاوا

کد مربوط به 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));
}

و آن را به این به‌روزرسانی کنید:

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

کاتلین

کد مربوط به 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))
}

و آن را به این به‌روزرسانی کنید:

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

به طور مشابه، از متدهای مربوطه برای کلاینت‌های زیر استفاده کنید: AchievementsClient ، EventsClient ، GamesSignInClient ، PlayerStatsClient ، RecallClient ، SnapshotsClient یا PlayersClient .

به‌روزرسانی کلاس‌های دسترسی سمت سرور

برای درخواست توکن دسترسی سمت سرور، به جای متد GoogleSignInAccount.getServerAuthCode() ، از متد GamesSignInClient.requestServerSideAccess() استفاده کنید.

برای اطلاعات بیشتر، به ارسال کد احراز هویت به سرور مراجعه کنید.

مثال زیر نحوه درخواست توکن دسترسی سمت سرور را نشان می‌دهد.

جاوا

کد مربوط به کلاس 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();
        }
      }
    }
  

و آن را به این به‌روزرسانی کنید:

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

کاتلین

کد مربوط به کلاس 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()
            }
        }
  }
  

و آن را به این به‌روزرسانی کنید:

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

مهاجرت از GoogleApiClient

برای یکپارچه‌سازی‌های قدیمی‌تر موجود، بازی شما ممکن است به نوع API GoogleApiClient از SDK سرویس‌های Play Games بستگی داشته باشد. این مورد در اواخر سال ۲۰۱۷ منسوخ شد و با کلاینت‌های "بدون اتصال" جایگزین شد. برای مهاجرت می‌توانید کلاس GoogleApiClient را با معادل "بدون اتصال" جایگزین کنید. جدول زیر نگاشت‌های کلاس رایج از بازی‌های نسخه ۱ به بازی‌های نسخه ۲ را فهرست می‌کند:

بازی‌های نسخه ۲ (فعلی) بازی‌های نسخه ۱ (قدیمی)
کلاینت دستاوردها com.google.android.gms.games.Achievements com.google.android.gms.games.achievement.Achievements
com.google.android.gms.games.LeaderboardsClient com.google.android.gms.games.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

ساخت و اجرای بازی

برای ساخت و اجرا در اندروید استودیو، به بخش ساخت و اجرای برنامه مراجعه کنید.

بازی خود را آزمایش کنید

با آزمایش کردن بازی خود، از عملکرد آن مطابق با طراحی اطمینان حاصل کنید. آزمایش‌هایی که انجام می‌دهید به ویژگی‌های بازی شما بستگی دارد.

در ادامه لیستی از آزمایش‌های رایج برای اجرا آمده است.

  1. ورود موفقیت‌آمیز .

    1. ورود خودکار کار می‌کند. کاربر باید هنگام اجرای بازی، وارد سرویس‌های بازی‌های پلی شود.

    2. پنجره خوشامدگویی نمایش داده می‌شود.

      نمونه پنجره خوشامدگویی.
      نمونه پنجره خوشامدگویی (برای بزرگنمایی کلیک کنید).

    3. پیام‌های ثبت موفقیت‌آمیز نمایش داده می‌شوند. دستور زیر را در ترمینال اجرا کنید:

      adb logcat | grep com.google.android.

      یک پیام ثبت موفقیت‌آمیز در مثال زیر نشان داده شده است:

      [$PlaylogGamesSignInAction$SignInPerformerSource@e1cdecc
      number=1 name=GAMES_SERVICE_BROKER>], returning true for shouldShowWelcomePopup.
      [CONTEXT service_id=1 ]
  2. از سازگاری اجزای رابط کاربری اطمینان حاصل کنید .

    1. پنجره‌های بازشو، جدول امتیازات و دستاوردها به درستی و به طور مداوم در اندازه‌ها و جهت‌های مختلف صفحه نمایش در رابط کاربری (UI) سرویس‌های بازی‌های Play نمایش داده می‌شوند.

    2. گزینه خروج از سیستم در رابط کاربری سرویس‌های بازی‌های پلی قابل مشاهده نیست.

    3. مطمئن شوید که می‌توانید با موفقیت شناسه بازیکن را بازیابی کنید، و در صورت لزوم، قابلیت‌های سمت سرور مطابق انتظار کار می‌کنند.

    4. اگر بازی از احراز هویت سمت سرور استفاده می‌کند، جریان requestServerSideAccess را به طور کامل آزمایش کنید. مطمئن شوید که سرور کد احراز هویت را دریافت می‌کند و می‌تواند آن را با یک توکن دسترسی مبادله کند. سناریوهای موفقیت و شکست را برای خطاهای شبکه و سناریوهای client ID نامعتبر آزمایش کنید.

اگر بازی شما از هر یک از ویژگی‌های زیر استفاده می‌کرد، آنها را آزمایش کنید تا مطمئن شوید که مانند قبل از انتقال کار می‌کنند:

  • جدول امتیازات : امتیازات را ارسال کنید و جدول امتیازات را مشاهده کنید. رتبه‌بندی صحیح و نمایش نام و امتیازات بازیکنان را بررسی کنید.
  • دستاوردها : دستاوردها را باز کنید و تأیید کنید که آنها به درستی ثبت شده و در رابط کاربری بازی‌های Play نمایش داده می‌شوند.
  • بازی‌های ذخیره‌شده : اگر بازی از بازی‌های ذخیره‌شده استفاده می‌کند، مطمئن شوید که ذخیره و بارگذاری پیشرفت بازی بی‌نقص انجام می‌شود. این امر به‌ویژه برای آزمایش در چندین دستگاه و پس از به‌روزرسانی‌های برنامه بسیار مهم است.

وظایف پس از مهاجرت

پس از مهاجرت به نسخه ۲ بازی‌ها، مراحل زیر را انجام دهید.

بازی را منتشر کنید

فایل APK(ها) را بسازید و بازی را در کنسول Play منتشر کنید.

  1. در منوی اندروید استودیو، گزینه Build > Build Bundles(s) / APK(s) > Build APK(s) را انتخاب کنید.
  2. بازی خود را منتشر کنید. برای اطلاعات بیشتر، به بخش «انتشار برنامه‌های خصوصی از کنسول Play» مراجعه کنید.