আপনার বিদ্যমান ইন-গেম ফ্রেন্ডস সিস্টেম এবং আপনার গেমের অ্যাক্সেস থাকতে পারে এমন অন্যান্য সোশ্যাল সিস্টেমগুলোকে পরিপূরক ও উন্নত করতে ফ্রেন্ডস এপিআই ব্যবহার করুন। এটি আপনাকে খেলোয়াড়দের নিম্নলিখিত কাজগুলো করতে সক্ষম করে:
আপনার গেমে তাদের বন্ধুদের খুঁজে বের করুন।
লিডারবোর্ডে তাদের বন্ধুদের সাথে স্কোর তুলনা করুন।
তাদের প্লে গেমস বন্ধুদের তালিকার সাথে গেমে থাকা বন্ধুদের বিদ্যমান তালিকা একত্রিত করুন।
ইন-গেম প্রোফাইল পপআপের মাধ্যমে অন্য খেলোয়াড়কে শনাক্ত করুন। এই পপআপটি বর্তমান খেলোয়াড়ের দেওয়া ডাকনামটি দেখায়, যাতে বন্ধুটি জানতে পারে যে সে কার সাথে খেলছে।
মৌলিক বিষয়
এই এপিআইগুলো আপনাকে নিম্নলিখিত কাজগুলো সম্পাদন করার সুযোগ দেয়:
- বন্ধুদের লোড করুন : প্লেয়ার গেমটিকে ফ্রেন্ডস লিস্টের তথ্য অ্যাক্সেস করার অনুমতি দিয়েছে কিনা, তা আপনি যাচাই করতে পারেন। যদি অ্যাক্সেস দেওয়া থাকে, তাহলে আপনি প্রমাণীকৃত প্লেয়ারের বন্ধুদের সাথে সম্পর্কিত প্লেয়ার অবজেক্টগুলোর একটি তালিকা পেতে পারেন।
- অন্য খেলোয়াড়ের প্লে গেমস প্রোফাইল দেখুন : প্রমাণীকৃত খেলোয়াড় কর্তৃক অন্য খেলোয়াড়কে দেওয়া নামটি দেখানোর জন্য আপনি এই ভিউটি খুলতে পারেন। এই ভিউটিতে বন্ধুত্ব ব্যবস্থাপনার নিয়ন্ত্রণও রয়েছে এবং এটি খেলোয়াড়কে আপনার গেম থেকে বের করে দেবে না।
- ব্যবহারকারীকে নিয়ন্ত্রণ করার সুযোগ দিন : ব্যবহারকারীর প্লে গেমস প্রোফাইল বন্ধুদের কাছে কীভাবে দেখা যাবে এবং তার বন্ধুদের তালিকা গেমগুলোতে কীভাবে দেখা যাবে, তা নিয়ন্ত্রণ করার ক্ষমতা ব্যবহারকারীর রয়েছে। বন্ধুদের তালিকায় অ্যাক্সেসের জন্য, ব্যবহারকারী সমস্ত গেমের জন্য স্বয়ংক্রিয়ভাবে অ্যাক্সেস মঞ্জুর করতে পারেন অথবা প্রতিটি গেমের জন্য আলাদাভাবে অ্যাক্সেস অনুমোদন করতে পারেন। ফলস্বরূপ, বন্ধুদের তালিকা লোড করার সময়, অ্যাক্সেসের জন্য একটি অনুরোধ দেখানোর জন্য একটি কলব্যাক প্রদর্শিত হতে পারে।
প্লে গেমস বন্ধুদের তালিকা আমদানি করুন
আপনি ফ্রেন্ডস এপিআই (Friends APIs) ব্যবহার করে আপনার খেলোয়াড়দের প্লে গেমস (Play Games) বন্ধুদের তালিকা পেতে পারেন এবং তাদেরকে আপনার ইন-গেম বন্ধুদের তালিকায় যুক্ত করতে পারেন।
নতুন ব্যবহারকারীরা খেলার জন্য বন্ধুদের একটি প্রাথমিক তালিকা পাবে এবং বিদ্যমান ব্যবহারকারীরা তাদের প্লে গেমস-এর বন্ধুদের গেমের যেকোনো বন্ধু তালিকায় যুক্ত করতে পারবে। এর ফলে, আপনার ব্যবহারকারীরা খেলার বা প্রতিদ্বন্দ্বিতা করার জন্য সম্ভাব্য বৃহত্তম খেলোয়াড়গোষ্ঠী পাবে।
আপনার গেমে প্লে গেমস বন্ধুদের যুক্ত করুন
আপনার অভ্যন্তরীণ ডেটাবেসে থাকা সংশ্লিষ্ট প্লেয়ারের তথ্যের সাথে তাদের প্লে গেমস আইডি সংযুক্ত করে, প্লে গেমস বন্ধুদের যেকোনো বিদ্যমান ইন-গেম ফ্রেন্ডস লিস্টে যুক্ত করুন। নিশ্চিত করুন যে এই বন্ধুদের পাশে প্লে গেমস আইকনসহ একটি বাটন আছে, যেটি চাপলে অন্য প্লেয়ারের প্রোফাইল দেখা যায়, যাতে আপনার ব্যবহারকারীরা জানতে পারে বন্ধুরা কারা।
ব্যাকএন্ড সার্ভার থেকে বন্ধুদের তালিকা ব্যবহার করার সময়, অ্যান্ড্রয়েড এপিআই-এর ফলাফল পাস না করে, REST API ব্যবহার করে এটিকে নিরাপদে লোড করুন । বর্তমানে প্রমাণীকৃত প্লেয়ারের জন্য REST API-তে players.get(me) দ্বারা ফেরত আসা প্লেয়ার আইডি ব্যবহার করতে ভুলবেন না, কারণ এটি অন্য প্লেয়ারদের দেখা আইডির সাথে সামঞ্জস্যপূর্ণ হবে।
যদি বর্ধিত বন্ধুদের তালিকাটি সংরক্ষণ না করে শুধু দেখার সময় ব্যবহার করা হয়, তাহলে কোনো অতিরিক্ত কাজের প্রয়োজন নেই।
প্লে গেমস অ্যাক্সেস মঞ্জুর করুন
আপনার গেমে যদি আগে থেকেই প্লে গেমস অ্যাক্সেস না থাকে, তাহলে ব্যবহারকারীদের কাছে তাদের সম্মতি চাওয়ার একটি ভালো সময় হলো যখন তারা আপনার ইন-গেম বন্ধুদের তালিকা দেখবে। উদাহরণস্বরূপ, আপনি ‘ইম্পোর্ট প্লে গেমস ফ্রেন্ডস’ নামে একটি বাটন যোগ করতে পারেন, যেটি ট্যাপ করলে ব্যবহারকারীর কাছে সম্মতি চাইবে। (যে কোনো বাটনে এই পরিষেবাটির উল্লেখ থাকলে, সেখানে প্লে গেমস লোগো ব্যবহার করতে ভুলবেন না।)
অন্য খেলোয়াড়ের প্রোফাইল দেখুন
আপনি আপনার অনুমোদিত প্লেয়ারকে অন্য প্লেয়ারের প্লে গেমস প্রোফাইল দেখার অনুমতি দিতে পারেন। এর ফলে অনুমোদিত প্লেয়ারটি অন্য প্লেয়ারকে দেওয়া তার নিজের নাম এবং তারা আগে থেকেই বন্ধু কিনা তা দেখতে পায়, যা তাদের সম্পর্কটি সম্পর্কে বাড়তি ধারণা দেয়। প্লেয়াররা যদি এখনও বন্ধু না হয়ে থাকে, তবে অনুমোদিত প্লেয়ারটি প্রোফাইল ভিউতে বন্ধুত্ব ব্যবস্থাপনার কন্ট্রোলগুলো দেখতে পাবে। গেমের ভেতর থেকে বন্ধুত্ব তৈরি করা হলে, দুই প্লেয়ারের জন্য ডিফল্ট নাম হিসেবে তাদের ইন-গেম নাম (যদি দেওয়া থাকে) ব্যবহৃত হয়। যে গেমে বন্ধুত্বটি শুরু করা হয়েছিল, সেই গেমের নামও দেখানো হয়।
সামাজিক লিডারবোর্ড
ফ্রেন্ডস এপিআই লিডারবোর্ডের জন্যও ব্যবহার করা যেতে পারে। বর্তমান প্লেয়ারের প্লে গেমস বন্ধুদের মধ্যে তার র্যাঙ্কিং দেখানোর জন্য এই ফিচারটি ব্যবহার করুন। মনে রাখবেন, এটি শুধুমাত্র সেইসব ব্যবহারকারীদের জন্য প্রযোজ্য যারা আপনার অ্যাপ্লিকেশনের সাথে এই তথ্য শেয়ার করতে রাজি হয়েছেন এবং যারা প্লে গেমসে বন্ধু। এই ফিচারটি সমর্থন করার জন্য, গেমটি ব্যবহারকারীর কাছে একটি কন্ট্রোল উন্মুক্ত করে দেয়। এই কন্ট্রোলটি লিডারবোর্ডের সোশ্যাল ভিউ নির্বাচন করার জন্য collection আর্গুমেন্ট ব্যবহার করে। আরও জানতে, পাবলিক এবং সোশ্যাল লিডারবোর্ড সম্পর্কিত বিভাগটি দেখুন।
আপনি যদি সোশ্যাল লিডারবোর্ড কালেকশনটি ইমপ্লিমেন্ট করেন, তাহলে লিডারবোর্ডের স্কোর লোড করার কলটি loadFriends() এর মতো একটি `consent-required resolution exception` রিটার্ন করতে পারে। আপনি যদি প্লে গেমস-প্রদত্ত ডিফল্ট UI (যেমন, getLeaderboardIntent() ) ইমপ্লিমেন্ট করেন, তাহলে এটি আপনার জন্য স্বয়ংক্রিয়ভাবে হ্যান্ডেল করা হয়।
পরবর্তী পদক্ষেপ
ফ্রেন্ডস এপিআই ব্যবহার শুরু করার আগে, নিম্নলিখিত কাজগুলো করুন:
- একটি কোড নমুনা ডাউনলোড করে পর্যালোচনা করুন:
- জাভা
- ইউনিটি প্লাগইন ব্যবহার করে তৈরি ইউনিটি স্যাম্পল অ্যাপ
- গুণমান চেকলিস্টে বর্ণিত সুপারিশগুলো ভালোভাবে জেনে নিন।
- একটি জাভা ক্লায়েন্টে ফ্রেন্ডস এপিআইগুলো বাস্তবায়ন করুন।