এই ডকুমেন্টে বর্ণনা করা হয়েছে কিভাবে বিদ্যমান গেমগুলিকে গেমস v1 SDK থেকে গেমস v2 SDK- তে স্থানান্তর করা যায়। Play Games প্লাগইন ফর ইউনিটি, ভার্সন 10 এবং তার আগের, গেমস v1 SDK ব্যবহার করে।
শুরু করার আগে
- নিশ্চিত করুন যে আপনি ইতিমধ্যেই Play Console সেট আপ করেছেন এবং Unity Hub ইনস্টল করেছেন।
ইউনিটির জন্য গুগল প্লে গেমস প্লাগইন ডাউনলোড করুন।
প্লে গেমস সার্ভিসেসের সর্বশেষ বৈশিষ্ট্যগুলি উপভোগ করতে, সর্বশেষ প্লাগইন সংস্করণটি ডাউনলোড এবং ইনস্টল করুন। এটি gitHub সংগ্রহস্থল থেকে ডাউনলোড করুন।
পুরাতন প্লাগইনটি সরান
ইউনিটি হাবে, নিম্নলিখিত ফোল্ডার বা ফাইলগুলি সরিয়ে ফেলুন।
Assets/GooglePlayGames Assets/GeneratedLocalRepo/GooglePlayGames Assets/Plugins/Android/GooglePlayGamesManifest.androidlib Assets/Plugins/Android
আপনার ইউনিটি প্রজেক্টে নতুন প্লাগইনটি আমদানি করুন।
আপনার ইউনিটি প্রজেক্টে প্লাগইনটি আমদানি করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- আপনার গেম প্রজেক্টটি খুলুন।
- ইউনিটি হাবে, ডাউনলোড করা
unitypackageফাইলটি আপনার প্রকল্পের সম্পদে আমদানি করতে সম্পদ > প্যাকেজ আমদানি > কাস্টম প্যাকেজ ক্লিক করুন। নিশ্চিত করুন যে আপনার বর্তমান বিল্ড প্ল্যাটফর্মটি Android এ সেট করা আছে।
প্রধান মেনুতে, ফাইল > বিল্ড সেটিংস এ ক্লিক করুন।
অ্যান্ড্রয়েড নির্বাচন করুন এবং প্ল্যাটফর্ম পরিবর্তন করুন এ ক্লিক করুন।
উইন্ডো > গুগল প্লে গেমস এর অধীনে একটি নতুন মেনু আইটেম থাকা উচিত। যদি না থাকে, তাহলে সম্পদ > রিফ্রেশ এ ক্লিক করে সম্পদগুলি রিফ্রেশ করুন এবং তারপর আবার বিল্ড প্ল্যাটফর্ম সেট করার চেষ্টা করুন।
ইউনিটি হাবে, ফাইল > বিল্ড সেটিংস > প্লেয়ার সেটিংস > অন্যান্য সেটিংস এ ক্লিক করুন।
টার্গেট API লেভেল বক্সে, একটি সংস্করণ নির্বাচন করুন।
স্ক্রিপ্টিং ব্যাকএন্ড বক্সে,
IL2CPPলিখুন।টার্গেট আর্কিটেকচার বাক্সে, একটি মান নির্বাচন করুন।
প্যাকেজের নাম package_name লিখুন। আপনি এই তথ্যটি পরে ব্যবহার করতে পারেন।
আপনার ইউনিটি প্রজেক্টের প্লেয়ার সেটিংস।
স্বয়ংক্রিয় সাইন-ইন কোড আপডেট করুন
PlayGamesClientConfiguration initialization ক্লাসটি PlayGamesPlatform.Instance.Authenticate() ক্লাস দিয়ে প্রতিস্থাপন করুন। PlayGamesPlatform এর initialization এবং সক্রিয়করণ প্রয়োজন হয় না। 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();
তোমার খেলা পরীক্ষা করো
আপনার গেমটি পরীক্ষা করে নিশ্চিত করুন যে এটি ডিজাইন অনুযায়ী কাজ করছে। আপনি যে পরীক্ষাগুলি করবেন তা আপনার গেমের বৈশিষ্ট্যের উপর নির্ভর করে।
নিচে চালানোর জন্য সাধারণ পরীক্ষাগুলির একটি তালিকা দেওয়া হল।
সফলভাবে সাইন-ইন হয়েছে ।
স্বয়ংক্রিয় সাইন-ইন কাজ করে। গেমটি চালু করার পরে ব্যবহারকারীকে প্লে গেমস পরিষেবাগুলিতে সাইন ইন করতে হবে।
স্বাগত পপআপ প্রদর্শিত হবে।
নমুনা স্বাগত পপআপ (বড় করতে ক্লিক করুন)। সফল লগ বার্তা প্রদর্শিত হবে। টার্মিনালে নিম্নলিখিত কমান্ডটি চালান:
adb logcat | grep com.google.android.
নিম্নলিখিত উদাহরণে একটি সফল লগ বার্তা দেখানো হয়েছে:
[
UI উপাদানের ধারাবাহিকতা নিশ্চিত করুন ।
প্লে গেমস সার্ভিসেস ইউজার ইন্টারফেস (UI) তে বিভিন্ন স্ক্রিন সাইজ এবং ওরিয়েন্টেশনে পপ-আপ, লিডারবোর্ড এবং কৃতিত্ব সঠিকভাবে এবং ধারাবাহিকভাবে প্রদর্শিত হয়।
প্লে গেমস সার্ভিসেস UI-তে সাইন-আউট বিকল্পটি দৃশ্যমান নয়।
নিশ্চিত করুন যে আপনি সফলভাবে প্লেয়ার আইডি পুনরুদ্ধার করতে পারছেন, এবং প্রযোজ্য হলে, সার্ভার-সাইড ক্ষমতাগুলি প্রত্যাশা অনুযায়ী কাজ করবে।
যদি গেমটি সার্ভার-সাইড প্রমাণীকরণ ব্যবহার করে, তাহলে
requestServerSideAccessপ্রবাহটি পুঙ্খানুপুঙ্খভাবে পরীক্ষা করুন। নিশ্চিত করুন যে সার্ভারটি প্রমাণীকরণ কোডটি গ্রহণ করেছে এবং এটি একটি অ্যাক্সেস টোকেনের জন্য বিনিময় করতে পারে। নেটওয়ার্ক ত্রুটি, অবৈধclient IDপরিস্থিতির জন্য সাফল্য এবং ব্যর্থতা উভয় পরিস্থিতি পরীক্ষা করুন।
যদি আপনার গেমটি নিম্নলিখিত বৈশিষ্ট্যগুলির মধ্যে কোনটি ব্যবহার করে থাকে, তাহলে সেগুলি পরীক্ষা করে দেখুন যে সেগুলি মাইগ্রেশনের আগের মতোই কাজ করে:
- লিডারবোর্ড : স্কোর জমা দিন এবং লিডারবোর্ড দেখুন। খেলোয়াড়ের নাম এবং স্কোর সঠিক র্যাঙ্কিং এবং প্রদর্শনের জন্য পরীক্ষা করুন।
- অর্জন : অর্জনগুলি আনলক করুন এবং যাচাই করুন যে সেগুলি সঠিকভাবে রেকর্ড করা হয়েছে এবং Play Games UI-তে প্রদর্শিত হয়েছে।
- সংরক্ষিত গেম : যদি গেমটি সংরক্ষিত গেম ব্যবহার করে, তাহলে নিশ্চিত করুন যে গেমের অগ্রগতি সংরক্ষণ এবং লোড করা ত্রুটিহীনভাবে কাজ করে। একাধিক ডিভাইসে এবং অ্যাপ আপডেটের পরে এটি পরীক্ষা করার জন্য বিশেষভাবে গুরুত্বপূর্ণ।
মাইগ্রেশন পরবর্তী কাজগুলি
গেমস v2 SDK-তে মাইগ্রেট করার পর নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন।