প্লে গেম পরিষেবা v2 (ইউনিটি) এ মাইগ্রেট করুন

এই দস্তাবেজটি বর্ণনা করে কিভাবে বিদ্যমান গেমগুলিকে গেমস v1 SDK থেকে গেমস v2 SDK তে স্থানান্তর করা যায়৷ ইউনিটির জন্য প্লে গেম প্লাগইন, সংস্করণ 10 এবং তার আগের, গেমস v1 SDK ব্যবহার করে।

আপনি শুরু করার আগে

  • নিশ্চিত করুন যে আপনি ইতিমধ্যেই প্লে কনসোল সেট আপ করেছেন এবং ইউনিটি হাব ইনস্টল করেছেন।

একতার জন্য গুগল প্লে গেম প্লাগইন ডাউনলোড করুন

প্লে গেম পরিষেবাগুলির সর্বশেষ বৈশিষ্ট্যগুলি থেকে উপকৃত হতে, সর্বশেষ প্লাগইন সংস্করণটি ডাউনলোড এবং ইনস্টল করুন৷ গিটহাব রিপোজিটরি থেকে এটি ডাউনলোড করুন।

পুরানো প্লাগইন সরান

ইউনিটি হাবে, নিম্নলিখিত ফোল্ডার বা ফাইলগুলি সরান৷

Assets/GooglePlayGames

Assets/GeneratedLocalRepo/GooglePlayGames

Assets/Plugins/Android/GooglePlayGamesManifest.androidlib

Assets/Plugins/Android
আপনার ইউনিটি প্রকল্পে হাইলাইট করা ফোল্ডারগুলি সরান।
আপনার ইউনিটি প্রকল্পে হাইলাইট করা ফোল্ডারগুলি সরান (বড় করতে ক্লিক করুন)।

আপনার ইউনিটি প্রকল্পে নতুন প্লাগইন আমদানি করুন

আপনার ইউনিটি প্রকল্পে প্লাগইন আমদানি করতে, এই পদক্ষেপগুলি অনুসরণ করুন:

  1. আপনার গেম প্রকল্প খুলুন.
  2. ইউনিটি হাবে, আপনার প্রকল্পের সম্পদে ডাউনলোড করা unitypackage ফাইল আমদানি করতে সম্পদ > আমদানি প্যাকেজ > কাস্টম প্যাকেজ-এ ক্লিক করুন।
  3. নিশ্চিত করুন যে আপনার বর্তমান বিল্ড প্ল্যাটফর্ম Android- এ সেট করা আছে।

    1. প্রধান মেনুতে, ফাইল > বিল্ড সেটিংস-এ ক্লিক করুন।

    2. অ্যান্ড্রয়েড নির্বাচন করুন এবং স্যুইচ প্ল্যাটফর্মে ক্লিক করুন।

    3. উইন্ডো > গুগল প্লে গেমসের অধীনে একটি নতুন মেনু আইটেম থাকা উচিত। যদি না থাকে, সম্পদগুলি রিফ্রেশ করুন সম্পদ > রিফ্রেশ ক্লিক করে এবং তারপর আবার বিল্ড প্ল্যাটফর্ম সেট করার চেষ্টা করুন।

  4. ইউনিটি হাবে, ফাইল > বিল্ড সেটিংস > প্লেয়ার সেটিংস > অন্যান্য সেটিংসে ক্লিক করুন।

  5. লক্ষ্য API স্তর বাক্সে, একটি সংস্করণ নির্বাচন করুন।

  6. স্ক্রিপ্টিং ব্যাকএন্ড বক্সে, IL2CPP লিখুন।

  7. টার্গেট আর্কিটেকচার বাক্সে, একটি মান নির্বাচন করুন।

  8. প্যাকেজ নামটি নোট করুন package_name .আপনি এই তথ্যটি পরে ব্যবহার করতে পারেন।

    আপনার ইউনিটি প্রকল্পে প্লেয়ার সেটিংস
    আপনার ইউনিটি প্রকল্পে প্লেয়ার সেটিংস।
  9. Play Console থেকে Android রিসোর্স কপি করুন

  10. আপনার ইউনিটি প্রোজেক্টে অ্যান্ড্রয়েড রিসোর্স যোগ করুন

স্বয়ংক্রিয় সাইন-ইন কোড আপডেট করুন

PlayGamesClientConfiguration প্রারম্ভিক ক্লাসটি PlayGamesPlatform.Instance.Authenticate() ক্লাস দিয়ে প্রতিস্থাপন করুন। PlayGamesPlatform এর আরম্ভ এবং সক্রিয়করণের প্রয়োজন নেই। PlayGamesPlatform.Instance.Authenticate() কল করা স্বয়ংক্রিয় সাইন-ইন এর ফলাফল নিয়ে আসে।

সি#

ইউনিটি হাবে, PlayGamesClientConfiguration ক্লাস সহ ফাইলগুলি সনাক্ত করুন।

using GooglePlayGames;
using GooglePlayGames.BasicApi;
using UnityEngine.SocialPlatforms;

public void Start() {
    PlayGamesClientConfiguration config =
        new PlayGamesClientConfiguration.Builder()
    // Enables saving game progress
    .EnableSavedGames()
    // Requests the email address of the player be available
    // will bring up a prompt for consent
    .RequestEmail()
    // Requests a server auth code be generated so it can be passed to an
    // associated backend server application and exchanged for an OAuth token
    .RequestServerAuthCode(false)
    // Requests an ID token be generated. This OAuth token can be used to
    // identify the player to other services such as Firebase.
    .RequestIdToken()
    .Build();

    PlayGamesPlatform.InitializeInstance(config);
    // recommended for debugging:
    PlayGamesPlatform.DebugLogEnabled = true;
    // Activate the Google Play Games platform
    PlayGamesPlatform.Activate();
}

এবং এটিতে এটি আপডেট করুন:

using GooglePlayGames;

public void Start() {
    PlayGamesPlatform.Instance.Authenticate(ProcessAuthentication);
}

internal void ProcessAuthentication(SignInStatus status) {
    if (status == SignInStatus.Success) {
        // Continue with Play Games Services
    } else {
        // Disable your integration with Play Games Services or show a login
        // button to ask users to sign-in. Clicking it should call
        // PlayGamesPlatform.Instance.ManuallyAuthenticate(ProcessAuthentication).
    }
}

একটি সামাজিক প্ল্যাটফর্ম চয়ন করুন

একটি সামাজিক প্ল্যাটফর্ম চয়ন করতে, একটি সামাজিক প্ল্যাটফর্ম নির্বাচন করুন দেখুন।

সার্ভার প্রমাণীকরণ কোড পুনরুদ্ধার করুন

সার্ভার সাইড অ্যাক্সেস কোড পেতে, সার্ভার প্রমাণীকরণ কোড পুনরুদ্ধার দেখুন।

সাইন-আউট কোড সরান

সাইন-আউট করার জন্য কোডটি সরান। প্লে গেম পরিষেবাগুলির আর একটি ইন-গেম সাইন-আউট বোতামের প্রয়োজন নেই৷

নিম্নলিখিত উদাহরণে দেখানো কোড সরান:

সি#

// sign out
PlayGamesPlatform.Instance.SignOut();

আপনার খেলা পরীক্ষা

এটি পরীক্ষা করে ডিজাইন করা আপনার গেম ফাংশন নিশ্চিত করুন। আপনি যে পরীক্ষাগুলি করেন তা আপনার গেমের বৈশিষ্ট্যগুলির উপর নির্ভর করে৷

নীচে চালানোর জন্য সাধারণ পরীক্ষার একটি তালিকা রয়েছে।

  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. UI কম্পোনেন্টের ধারাবাহিকতা নিশ্চিত করুন

    1. পপ আপ, লিডারবোর্ড এবং কৃতিত্বগুলি প্লে গেম সার্ভিস ইউজার ইন্টারফেসে (UI) বিভিন্ন স্ক্রীনের আকার এবং অভিযোজনে সঠিকভাবে এবং ধারাবাহিকভাবে প্রদর্শন করে।

    2. সাইন-আউট বিকল্পটি প্লে গেমস পরিষেবা UI-তে দৃশ্যমান নয়৷

    3. নিশ্চিত করুন যে আপনি সফলভাবে প্লেয়ার আইডি পুনরুদ্ধার করতে পারেন, এবং যদি প্রযোজ্য হয়, সার্ভার-সাইড ক্ষমতাগুলি প্রত্যাশিত হিসাবে কাজ করে৷

    4. গেমটি সার্ভার-সাইড প্রমাণীকরণ ব্যবহার করলে, পুঙ্খানুপুঙ্খভাবে রিকোয়েস্ট requestServerSideAccess প্রবাহ পরীক্ষা করুন। নিশ্চিত করুন যে সার্ভার প্রমাণীকরণ কোড পেয়েছে এবং এটি একটি অ্যাক্সেস টোকেনের জন্য বিনিময় করতে পারে। নেটওয়ার্ক ত্রুটি, অবৈধ client ID পরিস্থিতির জন্য সাফল্য এবং ব্যর্থতার উভয় পরিস্থিতি পরীক্ষা করুন।

যদি আপনার গেমটি নিম্নলিখিত বৈশিষ্ট্যগুলির মধ্যে একটি ব্যবহার করে থাকে, তবে সেগুলি স্থানান্তর করার আগের মতোই কাজ করে কিনা তা নিশ্চিত করতে তাদের পরীক্ষা করুন:

  • লিডারবোর্ড : স্কোর জমা দিন এবং লিডারবোর্ড দেখুন। সঠিক র‌্যাঙ্কিং এবং প্লেয়ারের নাম এবং স্কোর প্রদর্শনের জন্য পরীক্ষা করুন।
  • কৃতিত্বগুলি : কৃতিত্বগুলি আনলক করুন এবং যাচাই করুন যে সেগুলি সঠিকভাবে রেকর্ড করা হয়েছে এবং প্লে গেমস UI এ প্রদর্শিত হয়েছে৷
  • সংরক্ষিত গেমস : গেমটি যদি সংরক্ষিত গেমগুলি ব্যবহার করে তবে নিশ্চিত করুন যে গেমের অগ্রগতি সংরক্ষণ এবং লোড করা নির্দোষভাবে কাজ করে। এটি একাধিক ডিভাইস জুড়ে এবং অ্যাপ আপডেটের পরে পরীক্ষা করার জন্য বিশেষভাবে গুরুত্বপূর্ণ।

পোস্ট মাইগ্রেশন কাজ

আপনি গেমস v2 SDK-এ স্থানান্তরিত হওয়ার পরে নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন৷

  1. প্লে অ্যাপ সাইনিং ব্যবহার করুন

  2. একটি AAB ফাইল তৈরি করুন

  3. একটি অভ্যন্তরীণ পরীক্ষার রিলিজ তৈরি করুন

  4. আপনার অ্যাপ সাইনিং শংসাপত্র যাচাই করুন