Google সাইন-ইন API বন্ধ করার পর, আমরা ২০২৬ সালে গেমস v1 SDK সরিয়ে ফেলছি। ২০২৫ সালের ফেব্রুয়ারির পর, আপনি Google Play তে গেমস v1 SDK-এর সাথে নতুনভাবে সংহত করা শিরোনাম প্রকাশ করতে পারবেন না। আমরা আপনাকে এর পরিবর্তে গেমস v2 SDK ব্যবহার করার পরামর্শ দিচ্ছি।
পূর্ববর্তী গেম v1 ইন্টিগ্রেশন সহ বিদ্যমান শিরোনামগুলি কয়েক বছর ধরে কাজ করলেও, আপনাকে জুন 2025 থেকে v2 তে স্থানান্তরিত হতে উৎসাহিত করা হচ্ছে।
এই নির্দেশিকাটি Play Games Services v1 SDK ব্যবহারের জন্য। সর্বশেষ SDK সংস্করণ সম্পর্কে তথ্যের জন্য, v2 ডকুমেন্টেশন দেখুন।
প্লে গেমস সার্ভিসেস সাইন-ইন আপনাকে একজন খেলোয়াড়ের গেমিং পরিচয় প্রদান করে, যা অ্যান্ড্রয়েড খেলোয়াড়দের জন্য একটি প্ল্যাটফর্ম-স্তরের, গেমিং-নির্দিষ্ট পরিচয়। এই পরিচয় আপনার গেম এবং খেলোয়াড়ের মধ্যে সম্পর্ক তৈরি করতে সাহায্য করে। খেলোয়াড়রা বিকল্প কেন্দ্রীভূত সিস্টেমের চেয়ে সাইন ইন করার জন্য এই পরিচয় ব্যবহার করতে বেশি আগ্রহী।
এছাড়াও, সাইন-ইন আপনাকে একটি শক্তিশালী, সামঞ্জস্যপূর্ণ শনাক্তকারী দেয় যা আপনি ক্লাউড সেভ সিস্টেমের চাবি হিসেবে ব্যবহার করতে পারেন। ক্লাউড সেভ অত্যন্ত মূল্যবান; এটি খেলোয়াড়দের নিম্নলিখিত কাজগুলি করতে সক্ষম করে:
- যদি তারা তাদের ডিভাইস পরিবর্তন করে বা রিসেট করে, তাহলে তারা যেখানে ছেড়েছিল সেখান থেকে শুরু করবে
- একাধিক ডিভাইসে গেমটি খেলুন (উদাহরণস্বরূপ, অন্য ফোনে বা Chromebook এ)
- গেমটি আনইনস্টল করুন এবং পরে পুনরায় ইনস্টল করুন
আপনার নিজস্ব ক্লাউড সেভ সলিউশনের জন্য আপনি প্লে গেমস সার্ভিসেস আইডেন্টিটি কী হিসেবে ব্যবহার করতে পারেন, অথবা আপনি বিনামূল্যে সেভড গেমস পরিষেবা ব্যবহার করতে পারেন।
প্লে গেমস সার্ভিসেস (PGS) স্বয়ংক্রিয় সাইন-ইন সমর্থন করে, খেলোয়াড়দের সাইন ইন করার একটি শূন্য-ঘর্ষণ পদ্ধতি, পাশাপাশি ম্যানুয়াল সাইন-ইন, যা একটি এক-ক্লিক প্রক্রিয়া। এই নথিতে সাইন-ইনের এই বিভিন্ন পদ্ধতি বর্ণনা করা হয়েছে।
প্রস্তাবিত সাইন-ইন প্রবাহ
আপনার গেমে খেলোয়াড়দের সফলভাবে সাইন ইন করতে, নিম্নলিখিত সাইন-ইন প্রবাহটি ব্যবহার করুন:
- আপনার গেমের স্টার্টআপ সিকোয়েন্সের সময়, প্লেয়ারকে স্বয়ংক্রিয়ভাবে সাইন ইন করতে স্বয়ংক্রিয় সাইন-ইন চেষ্টা করুন।
- যদি স্বয়ংক্রিয় সাইন-ইন কাজ না করে এবং ব্যবহারকারীর ডিভাইস অনলাইনে থাকে, তাহলে ম্যানুয়াল সাইন-ইন চেষ্টা করুন।
- যদি ম্যানুয়াল সাইন-ইন প্রত্যাখ্যান করা হয়, তাহলে ব্যবহারকারীর পছন্দ মনে রাখবেন এবং আবার ম্যানুয়াল সাইন-ইন দেখাবেন না, তবে স্টার্টআপে স্বয়ংক্রিয় সাইন-ইন চেষ্টা চালিয়ে যান।
অতিরিক্তভাবে, আপনার নিশ্চিত করা উচিত যে ব্যবহারকারীরা তাদের Play Games পরিষেবা অ্যাকাউন্টের মাধ্যমে একটি ডেডিকেটেড, সহজেই খুঁজে পাওয়া যায় এমন বোতাম ব্যবহার করে আপনার গেমে সাইন ইন করতে সক্ষম।
স্বয়ংক্রিয় সাইন-ইন
স্বয়ংক্রিয় সাইন-ইন ব্যবহারকারীদের আপনার গেমে কোনও ঘর্ষণ ছাড়াই সাইন ইন করতে দেয় - এটি স্বয়ংক্রিয়! যদি আপনার গেমটি ব্যবহারকারীকে সাইন ইন করতে এবং স্বয়ংক্রিয় সাইন-ইন সেটিং সক্ষম করার অনুরোধ করে (গুগল প্লে গেমস অ্যাপে), তাহলে আপনি ব্যবহারকারীর PGS পরিচয় শংসাপত্র পাবেন এবং ব্যবহারকারী PGS সাইন-ইন অভিজ্ঞতা দেখতে পাবেন।
স্বয়ংক্রিয় সাইন-ইন হল এমন একটি সেটিংস যা ব্যবহারকারীরা নিয়ন্ত্রণ করতে পারেন। ব্যবহারকারীরা সমস্ত গেমে স্বয়ংক্রিয়ভাবে সাইন ইন করতে বা প্রতিবার জিজ্ঞাসা করতে বেছে নিতে পারেন।
ম্যানুয়াল সাইন-ইন
যদি কোনও ব্যবহারকারী স্বয়ংক্রিয়ভাবে গেমটিতে সাইন ইন না করে, তাহলে আপনি তাদের ম্যানুয়ালি সাইন ইন করতে বলতে পারেন। ব্যবহারকারীরা আপনার গেমের উপরে প্রদর্শিত একটি ডায়ালগ বক্স থেকে এক ক্লিকেই সাইন ইন করতে পারেন।
সঠিক সাইন-ইন অভিজ্ঞতার জন্য PGS পপআপগুলিকে অনুমতি দিন
PGS ব্যবহার করার সময়, ব্যবহারকারীদের জানতে হবে যে তারা সাইন ইন করেছেন। এটি PGS সাইন-ইন অভিজ্ঞতা দেখিয়ে করা হয়।
সাইন-ইন অভিজ্ঞতা দেখানোর জন্য, গেম শুরুর সময় GamesClient ক্লাসের setViewForPopups() পদ্ধতিটি কল করুন। সঠিক ব্যবহারকারীর অভিজ্ঞতা সক্ষম করার জন্য এটি অত্যন্ত গুরুত্বপূর্ণ।
OAuth স্কোপ এবং PGS
PGS ব্যবহারকারীদের তাদের অ্যাকাউন্টে আপনার গেম অ্যাক্সেস দেওয়ার অনুমতি দেওয়ার জন্য OAuth সিস্টেমের উপর নির্ভর করে। OAuth Scopes হল এমন অনুমতি যা আপনি একজন ডেভেলপার হিসেবে অনুরোধ করতে পারেন। যদি মঞ্জুর করা হয়, তাহলে এই অনুমতিগুলি আপনার গেমটিকে ব্যবহারকারীর পক্ষ থেকে নির্দিষ্ট API গুলিতে কল করতে দেয় এবং আপনাকে তাদের Google অ্যাকাউন্টের নির্দিষ্ট অংশে অ্যাক্সেসও দেয়।
PGS-এর গেমের জন্য একটি অনন্য সুযোগ রয়েছে ( games-lite ) এবং যদি আপনার গেমটি সংরক্ষিত গেম বৈশিষ্ট্য ব্যবহার করে তবে এটি অন্য একটি সুযোগের ( drive.appdata ) উপর নির্ভর করে। সংরক্ষিত গেম বৈশিষ্ট্যটি ব্যবহারকারীর Google ড্রাইভ অ্যাকাউন্টে অ্যাক্সেস দেয়, যেখানে গেমের ডেটা সংরক্ষণ করা হয়।
আপনার গেমটি আপনার ব্যবহারকারীদের জন্য একটি দুর্দান্ত গেম অভিজ্ঞতা তৈরি করার জন্য প্রয়োজনীয় যেকোনো স্কোপের অনুরোধ করতে পারে। আপনার গেমটি একটি বান্ডেলে প্রয়োজনীয় সমস্ত স্কোপের অনুরোধ করতে পারে, যা Google অ্যাকাউন্ট অ্যাক্সেসের জন্য অনুরোধের সংখ্যা সীমিত করে। তবে, এই পদ্ধতির একটি বড় অসুবিধা রয়েছে। আপনি যদি PGS-নির্দিষ্ট স্কোপের চেয়ে বেশি অনুরোধ করেন, তাহলে স্বয়ংক্রিয় সাইন-ইন সফল হতে পারে না। স্বয়ংক্রিয় সাইন-ইন হল খেলোয়াড়দের আপনার গেমে সাইন ইন করার সেরা উপায়।
সবচেয়ে ভালো পদ্ধতি হল ইনক্রিমেন্টাল স্কোপ রিকোয়েস্ট ব্যবহার করা। আপনার গেমটি প্রাথমিক অনুরোধে প্রথমে PGS-only স্কোপ চাইবে এবং আরও প্রাসঙ্গিক মুহূর্তে আলাদাভাবে অন্যান্য স্কোপের অনুরোধ করবে।
প্রতিটি স্কোপের জন্য আলাদা স্ক্রিন ব্যবহার করে OAuth অ্যাক্সেস দেওয়া হয়। এর ফলে ব্যবহারকারীরা কোন স্কোপে অ্যাক্সেস দেবেন তা সুনির্দিষ্টভাবে সিদ্ধান্ত নিতে পারবেন। শুধুমাত্র PGS স্কোপের মাধ্যমে স্বয়ংক্রিয় সাইন-ইন ব্যবহার করে, ব্যবহারকারীদের কোনও OAuth প্রম্পটের সাথে ইন্টারঅ্যাক্ট করতে হবে না, যার ফলে সাইন-ইনের ঝামেলা কমবে।
একাধিক সাইন-ইন পদ্ধতির জন্য সমর্থন
PGS অ্যান্ড্রয়েড প্লেয়ারদের জন্য একটি গেমিং আইডেন্টিটি প্রদান করে, তবে এটি আপনার ব্যবহারকারীদের সাথে সংযুক্ত একমাত্র পরিচয় হতে হবে না। আপনি একই সাথে PGS, একটি সোশ্যাল নেটওয়ার্ক আইডি এবং আপনার নিজস্ব ইন-গেম আইডি সিস্টেম ব্যবহার করে খেলোয়াড়দের সাইন ইন করতে পারেন। প্রতিটি সিস্টেম আপনার এবং আপনার খেলোয়াড় উভয়ের জন্যই অনন্য মূল্য প্রদান করে এবং অ্যান্ড্রয়েড প্লেয়ারদের জন্য একটি দুর্দান্ত অভিজ্ঞতা তৈরি করতে সকলেই একসাথে কাজ করতে পারে।
ব্যাকএন্ড ইন্টিগ্রেশনের জন্য প্লেয়ারের পরিচয় নিরাপদে পুনরুদ্ধার এবং যাচাই করুন
সাইন-ইন করা প্লেয়ারের কর্তৃত্বের মাধ্যমে REST API এর মাধ্যমে আপনার সার্ভারকে Play Games Services সার্ভারের সাথে সরাসরি কথা বলতে সক্ষম করার জন্য আপনি একটি সার্ভার প্রমাণীকরণ কোডের অনুরোধ করতে পারেন। এটি প্লেয়ারের আইডি, প্রোফাইল এবং অন্যান্য তথ্যে (যেমন বন্ধুদের তালিকা, যদি অনুমোদিত হয়) সরাসরি অ্যাক্সেস সক্ষম করে। আপনি যদি আপনার ব্যাকএন্ডে কোনও প্লেয়ার আইডি, বন্ধু আইডি, বা অন্যান্য সম্পর্কিত ডেটা সংরক্ষণ করেন, তাহলে এই ক্ষেত্রগুলির ডিভাইস-সাইড ম্যানিপুলেশনের সম্ভাবনা দূর করতে এই পদ্ধতিটি ব্যবহার করতে হবে।
এছাড়াও, কিছু পুরোনো গেম এবং খেলোয়াড়ের ক্ষেত্রে, Android SDK দ্বারা প্রদত্ত প্লেয়ার আইডি একই আইডি নাও হতে পারে যা অন্যান্য খেলোয়াড়রা একই গেমে সেই খেলোয়াড়কে দেখার সময় দেখে - বন্ধু তালিকা ব্যবহার করার সময় এটি বিশেষভাবে প্রাসঙ্গিক। তবে, REST API-এর মধ্যে প্রদত্ত player_id সর্বদা সামঞ্জস্যপূর্ণ এবং সর্বদা সেই আইডি যা অন্যান্য খেলোয়াড়রা দেখে।
আরও তথ্যের জন্য, অফলাইন অ্যাক্সেস এবং REST API ডকুমেন্টেশন দেখুন।
ক্লায়েন্ট বাস্তবায়ন
অ্যান্ড্রয়েডে সাইন-ইন সাপোর্ট কীভাবে বাস্তবায়ন করবেন তা জানতে, অ্যান্ড্রয়েড গেমসে সাইন-ইন দেখুন।