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

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

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

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

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

    গেম সার্ভার গুগল সার্ভারের সাথে রিকল টোকেন সঞ্চয় করে।

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

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

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

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

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

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

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

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

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

গেমটি PGS SDK চালু করে এবং PGS দিয়ে ব্যবহারকারীকে প্রমাণীকরণ করার চেষ্টা করে।

PGS এর সাথে ব্যবহারকারীর প্রমাণীকরণ

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

ডেভেলপার একটি সেশন আইডি অনুরোধ করছে

ধাপ ২: যেকোনো উপলব্ধ প্রত্যাহার টোকেন পুনরুদ্ধার করুন

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

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

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

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

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

ধাপ ৩খ: যদি কোনও টোকেন উপস্থিত না থাকে, তাহলে একটি টোকেন সংরক্ষণ করুন।

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

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

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

ডেভেলপার প্রত্যাহার টোকেন সংরক্ষণ করে

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

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

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

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

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

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

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

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

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

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