API প্রত্যাহার করুন

Recall API গেমগুলিকে Google সার্ভারের সাথে রিকল টোকেন সংরক্ষণ করে Google Play Games Services (PGS) ব্যবহারকারী এবং তাদের ইন-গেম অ্যাকাউন্টগুলির মধ্যে লিঙ্কগুলি পরিচালনা করতে দেয়৷ Recall API কীভাবে ব্যবহার করা যেতে পারে তার একটি নমুনা দৃশ্য এখানে।

  1. একজন ব্যবহারকারী এমন একটি গেম খেলছেন যেখানে ব্যবহারকারীর অগ্রগতি ট্র্যাক করার জন্য বিকাশকারীর একটি আইডেন্টিটি সিস্টেম রয়েছে এবং ব্যবহারকারীদের তাদের গেমে লগ করার জন্য অন্যান্য প্রমাণীকরণ পদ্ধতির সাথে সমান্তরালভাবে PGS ব্যবহার করে৷ এই উদাহরণে, একজন ব্যবহারকারী তাদের PGS অ্যাকাউন্ট Laura- এ লগ ইন করেন এবং Racer94 নামে ডেভেলপারের আইডেন্টিটি সিস্টেমের সাথে একটি ইন-গেম অ্যাকাউন্ট তৈরি করেন। ব্যবহারকারী গেমটি খেলে, বিকাশকারীর গেম সার্ভার তাদের অগ্রগতি সিঙ্ক করে।

    ব্যবহারকারী PGS এবং একটি ইন-গেম অ্যাকাউন্ট দিয়ে লগ ইন করা হয়েছে

  2. আলাদাভাবে, বিকাশকারী Google-এর সাথে একটি রিকল টোকেন সংরক্ষণ করে, যা ব্যবহারকারীর ইন-গেম অ্যাকাউন্টের সাথে মিলে যায়। Google স্বয়ংক্রিয়ভাবে ব্যবহারকারীর PGS প্রোফাইলের বিপরীতে সেই রিকল টোকেন সংরক্ষণ করে।

    গেম সার্ভার স্টোর Google সার্ভারের সাথে টোকেন প্রত্যাহার করে

  3. ব্যবহারকারী এখন প্রথমবারের মতো পিসিতে জিপিজি- তে গেমটি খেলার সিদ্ধান্ত নেয়। ব্যবহারকারী স্বয়ংক্রিয়ভাবে তাদের PGS অ্যাকাউন্ট দিয়ে সাইন ইন করে, এবং গেম ক্লায়েন্ট এই PGS ব্যবহারকারীর জন্য উপলব্ধ কোনো অগ্রগতি আছে কিনা তা পরীক্ষা করে। গেম সার্ভার তারপর এই PGS অ্যাকাউন্টের জন্য কোন টোকেন আছে কিনা তা দেখার জন্য Google কে জিজ্ঞাসা করে। যেহেতু আছে, গুগল রিকল টোকেন ফেরত পাঠায়, এবং গেম সার্ভার ব্যবহারকারীর সংশ্লিষ্ট অ্যাকাউন্ট Racer94 খুঁজে পেতে এবং তাদের অগ্রগতি পুনরুদ্ধার করতে সেই টোকেনটি ব্যবহার করে। যেহেতু PGS এর সাথে সাইন ইন করা একটি ঘর্ষণহীন অভিজ্ঞতা, তাই ব্যবহারকারীর একটি ব্যবহারকারীর নাম বা পাসওয়ার্ড প্রবেশ করার প্রয়োজন ছাড়াই অ্যাপ দ্বারা ব্যবহারকারীর অগ্রগতি পুনরুদ্ধার করা হয়। তদুপরি, বিকাশকারী তাদের বিদ্যমান পরিচয় সিস্টেমের সাথে PGS সাইন-ইন ব্যবহার করতে পারে এবং প্লেয়ারের অগ্রগতি এবং তাদের PGS অ্যাকাউন্টের মধ্যে লিঙ্ক সংরক্ষণ করতে Google-এর উপর নির্ভর করতে পারে।

    গেম সার্ভার রিকল টোকেন দিয়ে অগ্রগতি পুনরুদ্ধার করে

যেমন আগে উদাহরণে দেখা গেছে, দুটি প্রধান ক্রিয়া রয়েছে যা Recall API দ্বারা সঞ্চালিত হয়:

  • যখন একজন ব্যবহারকারী ইন-গেম অ্যাকাউন্টগুলির সাথে লগ ইন করে তখন Google-এর সাথে টোকেন সংরক্ষণ করা

  • একটি ব্যবহারকারীর জন্য তাদের ইন-গেম অ্যাকাউন্ট পুনরুদ্ধার করার জন্য টোকেন পুনরুদ্ধার করা

রিকল টোকেনগুলি ছাড়াও, কার্ডিনালিটি সীমাবদ্ধতাগুলি প্রয়োগ করার জন্য Recall API-এর জন্য ইন-গেম অ্যাকাউন্টের সাথে সম্পর্কিত একটি স্থিতিশীল শনাক্তকারীরও প্রয়োজন, যা ব্যক্তি নামে পরিচিত। আপনি একটি ব্যক্তিত্বকে লেবেল হিসাবে ভাবতে পারেন যা বিকাশকারীর পরিচয় ব্যবস্থার মধ্যে ব্যবহারকারীর ইন-গেম অ্যাকাউন্টকে প্রতিনিধিত্ব করে এবং একটি কী হিসাবে রিকল টোকেন যা ব্যবহারকারীর ইন-গেম অ্যাকাউন্টটিকে গেমে পুনরুদ্ধার করতে ব্যবহৃত হয়। ব্যক্তিত্ব এবং টোকেন মান অবশ্যই বিভিন্ন PGS প্রকল্পে পুনরায় ব্যবহার করা যাবে না। এছাড়াও, সময়ের সাথে সাথে রিকল টোকেন পরিবর্তন হতে পারে, ব্যবহারকারীর ইন-গেম অ্যাকাউন্ট অনুযায়ী ব্যক্তিত্ব স্থিতিশীল হওয়া উচিত।

কার্ডিনালিটি নিয়ম

Recall API PGS প্রোফাইল এবং ইন-গেম অ্যাকাউন্টগুলির মধ্যে একটি 1:1 সম্পর্ক প্রয়োগ করে ( কার্ডিনালিটি নিয়ম হিসাবে উল্লেখ করা হয়), যেখানে একটি ব্যক্তিত্ব শুধুমাত্র একটি PGS প্রোফাইলের সাথে লিঙ্ক করা যেতে পারে, এবং একটি PGS প্রোফাইল শুধুমাত্র একটি ব্যক্তিত্বের সাথে লিঙ্ক করা যেতে পারে। ব্যক্তিত্ব একটি ইন-গেম অ্যাকাউন্টের জন্য একটি স্থিতিশীল শনাক্তকারী হিসাবে ব্যবহৃত হয়, কারণ রিকল টোকেন সময়ের সাথে পরিবর্তিত হতে পারে।

একটি PGS প্রোফাইলের সাথে লিঙ্ক করা ব্যক্তিত্ব সময়ের সাথে সাথে পরিবর্তিত হতে পারে (যেহেতু বিভিন্ন ইন-গেম অ্যাকাউন্ট PGS প্রোফাইলের সাথে লিঙ্ক করা হয়)।

প্রত্যাহার টোকেন সংরক্ষণ এবং পুনরুদ্ধারের জন্য প্রযুক্তিগত প্রবাহ

রিকল টোকেন সংরক্ষণ এবং পুনরুদ্ধার করার সময় এই বিভাগটি Google সার্ভারের সাথে গেম ক্লায়েন্ট এবং সার্ভারের মধ্যে প্রযুক্তিগত প্রবাহকে কভার করে।

ধাপ 1: PGS ব্যবহারকারী সাইন ইন করুন এবং সেশন আইডি পুনরুদ্ধার করুন

গেমটি PGS SDK সূচনা করে এবং ব্যবহারকারীকে PGS দিয়ে সাইন ইন করার চেষ্টা করে।

ব্যবহারকারী PGS দিয়ে সাইন ইন করে

ধরে নিলাম যে ব্যবহারকারী সাইন ইন করেছেন, গেম ক্লায়েন্টে গেম SDK থেকে একটি সেশন আইডি অনুরোধ করুন এবং Google-এর OAuth ব্যাকএন্ড থেকে একটি OAuth 2.0 টোকেনের অনুরোধ করুন৷ সেশন আইডি এবং OAuth 2.0 টোকেনগুলি Google গেম ব্যাকএন্ডের সাথে যোগাযোগ করতে ব্যবহৃত হয়।

বিকাশকারী একটি সেশন আইডি অনুরোধ করে৷

ধাপ 2: যেকোনো উপলব্ধ রিকল টোকেন পুনরুদ্ধার করুন

পিজিএস ব্যবহারকারীর অ্যাকাউন্টের সাথে সম্পর্কিত যেকোন প্রত্যাহার টোকেনের জন্য অনুরোধ। একটি টোকেন উপস্থিত থাকলে, ধাপ 3a এ যান এবং অগ্রগতি পুনরুদ্ধার করুন । অন্যথায়, যদি এটি একজন নতুন ব্যবহারকারী হয় এবং তাদের কাছে কোনো টোকেন না থাকে, তাহলে ধাপ 3b-এ যান এবং একটি নতুন টোকেন সংরক্ষণ করুন

ডেভেলপার রিকল টোকেন পুনরুদ্ধার করে

ধাপ 3a: টোকেন উপস্থিত থাকলে, অগ্রগতি পুনরুদ্ধার করুন

যদি একটি টোকেন উপস্থিত থাকে, টোকেনটি পুনরুদ্ধার এবং ডিক্রিপ্ট করুন এবং ব্যবহারকারীর ডেটা পুনরুদ্ধার করুন।

ডেভেলপার রিকল টোকেন থেকে ডেটা পুনরুদ্ধার করে

ধাপ 3 বি: যদি কোন টোকেন উপস্থিত না থাকে তবে একটি টোকেন সংরক্ষণ করুন

যেহেতু কোনো টোকেন উপস্থিত নেই, কোনো অগ্রগতি পুনরুদ্ধার করা হয়নি। ব্যবহারকারী বিকাশকারীর পরিচয় সিস্টেমের সাথে সাইন ইন করতে এগিয়ে যান, বা একটি বিদ্যমান না থাকলে একটি নতুন অ্যাকাউন্ট তৈরি করেন। দ্রষ্টব্য - এটি PGS এর সাথে সাইন ইন নয় (যা ইতিমধ্যেই করা হয়েছে), তবে PGS এর বাইরে একটি বিকাশকারীর পরিচয় সিস্টেমের সাথে।

ব্যবহারকারী তাদের ইন-গেম অ্যাকাউন্ট দিয়ে সাইন ইন করে

একটি এনক্রিপ্টেড রিকল টোকেন তৈরি করুন যা ব্যবহারকারীর ইন-গেম অ্যাকাউন্ট এনকোড করে এবং সেশন আইডি এবং OAuth 2.0 টোকেন সহ Google-এ পাঠান। এই মুহুর্তে, Google পাঠানো রিকল টোকেন এবং প্লেয়ারের PGS অ্যাকাউন্টের মধ্যে একটি সম্পর্ক তৈরি করে।

ডেভেলপার স্টোর রিকল টোকেন

PGS প্রোফাইল ছাড়া ব্যবহারকারীদের জন্য প্রবাহ

আপনি প্রোফাইললেস মোড ব্যবহার করে এমন একজন ব্যবহারকারীর জন্য রিকল টোকেন সংরক্ষণ করতে পারেন যিনি এখনও একটি PGS প্রোফাইল তৈরি করেননি। যাইহোক, দুটি গুরুত্বপূর্ণ সতর্কতা আছে:

  • PGS প্রোফাইল নেই এমন ব্যবহারকারীর জন্য আপনি টোকেন পুনরুদ্ধার করতে পারবেন না। ব্যবহারকারী যখন দ্বিতীয় ডিভাইসে প্লে গেম পরিষেবা দিয়ে আপনার গেমে লগ ইন করার চেষ্টা করে তখন প্রোফাইল তৈরির জন্য স্বয়ংক্রিয়ভাবে অনুরোধ করা হয়।
  • নিম্নলিখিত আইটেমগুলির বর্ণনা এবং উপযুক্ত শেষ-ব্যবহারকারীর সম্মতি পাওয়ার জন্য আপনার কাছে একটি উপযুক্ত বিজ্ঞপ্তি রয়েছে তা নিশ্চিত করতে আপনাকে অবশ্যই অতিরিক্ত নির্দেশিকা অনুসরণ করতে হবে:
    • Play Games অ্যাকাউন্ট লিঙ্কিং বৈশিষ্ট্য সক্ষম করতে Google-এর সাথে আপনার ডেটা শেয়ার করা।
    • এই শেয়ারিং পরিচালনা করার জন্য সেটিংসের উপলভ্যতা, যেমন Play Games সেটিংস।
    • Google গোপনীয়তা নীতির অধীনে এই ধরনের ডেটা প্রক্রিয়াকরণ।

একটি টোকেন এবং ব্যক্তিত্ব জোড়া সংরক্ষণ করুন

PGS প্রোফাইল ছাড়া ব্যবহারকারী একটি গেম খোলে

  1. PGS প্রোফাইল ছাড়া একজন ব্যবহারকারী এমন একটি গেম খোলেন যাতে প্রোফাইললেস রিকল সক্ষম করা থাকে।
  2. গেম SDK একটি স্বয়ংক্রিয় সাইন-ইন ট্রিগার করে, যা ব্যর্থ হয় কারণ ব্যবহারকারীর কোনো PGS প্রোফাইল নেই৷
  3. গেমস SDK একটি স্ন্যাকবার দেখায় যা ব্যবহারকারীকে জানায় যে গেমটি Google-এর সাথে একীভূত হয়েছে৷ এই স্ন্যাকবারটি অ্যাকশনযোগ্য—ব্যবহারকারী একটি প্রোফাইল তৈরি না হওয়া পর্যন্ত প্রত্যাহার অক্ষম করতে পারেন।
  4. গেমটি রিকল অ্যাক্সেসের অনুরোধ করে। মনে রাখবেন যে ডিভাইসে PGS প্রোফাইল থাকলে বা ডিভাইসে কোনো Google অ্যাকাউন্ট না থাকলে PGS রিকল অ্যাক্সেসের অনুরোধ প্রত্যাখ্যান করে। সেক্ষেত্রে, গেমটি পিজিএস ব্যবহার না করেই এগিয়ে যাওয়া উচিত।
  5. ব্যবহারকারী একটি ইন-গেম অ্যাকাউন্ট দিয়ে লগ ইন করার পরে, গেমটি ব্যবহারকারীর জন্য একটি টোকেন এবং ব্যক্তিত্বের জুড়ি তৈরি করে যা তাদের ইন-গেম অ্যাকাউন্টের সাথে মিলে যায়। গেমটি এই জুটিকে Google-এর সাথে সঞ্চয় করে। ব্যবহারকারী অন্যান্য ইন-গেম অ্যাকাউন্টে লগ ইন করলে গেমটি পরে আরও টোকেন সঞ্চয় করতে পারে।

একটি নতুন ডিভাইসে একটি গেম চালু করুন

  1. PGS প্রোফাইল ছাড়া একজন ব্যবহারকারী এমন একটি গেম খোলেন যেটিতে একটি ডিভাইসে প্রোফাইললেস রিকল সক্ষম করা আছে।
  2. স্টোর এ টোকেন এবং পার্সোনা পেয়ারে বর্ণিত গেমটি প্রোফাইললেস রিকল টোকেন রেকর্ড করে।
  3. ব্যবহারকারী একই গেমটি একটি ভিন্ন ডিভাইসে খোলে যার একই অ্যাকাউন্ট সেটআপ রয়েছে।
  4. গেম SDK প্রোফাইল তৈরিকে ট্রিগার করে। ব্যবহারকারী পূর্বে সংরক্ষিত রিকল টোকেন পর্যালোচনা এবং প্রত্যাখ্যান করতে পারে। ব্যবহারকারী এই সময়ে একটি PGS প্রোফাইল তৈরি করে।
  5. PGS-এ স্বয়ংক্রিয় সাইন-ইন সম্পূর্ণ হয় এবং গেমটি প্রমাণীকৃত স্ট্যাটাস পায়।
  6. গেমটি যথারীতি ব্যবহারকারীর জন্য রিকল টোকেন পুনরুদ্ধার করে।

পরবর্তী পদক্ষেপ

আপনার ক্লায়েন্ট এবং গেম সার্ভারের সাথে Recall API একত্রিত করতে, এই নির্দেশিকা অনুসরণ করুন