আপনার গেম ইভেন্ট যোগ করুন

Google সাইন-ইন API বন্ধ করার পর, আমরা ২০২৬ সালে গেমস v1 SDK সরিয়ে ফেলছি। ২০২৫ সালের ফেব্রুয়ারির পর, আপনি Google Play তে গেমস v1 SDK-এর সাথে নতুনভাবে সংহত করা শিরোনাম প্রকাশ করতে পারবেন না। আমরা আপনাকে এর পরিবর্তে গেমস v2 SDK ব্যবহার করার পরামর্শ দিচ্ছি।
পূর্ববর্তী গেম v1 ইন্টিগ্রেশন সহ বিদ্যমান শিরোনামগুলি কয়েক বছর ধরে কাজ করলেও, আপনাকে জুন 2025 থেকে v2 তে স্থানান্তরিত হতে উৎসাহিত করা হচ্ছে।
এই নির্দেশিকাটি Play Games Services v1 SDK ব্যবহারের জন্য। Play Games Services v2 এর জন্য C++ SDK এখনও উপলব্ধ নয়।

এই নির্দেশিকাটি আপনাকে দেখায় কিভাবে C++ অ্যাপ্লিকেশনে ইভেন্ট পরিষেবা ব্যবহার করতে হয়।

শুরু করার আগে

যদি আপনি ইতিমধ্যেই এটি না করে থাকেন, তাহলে ইভেন্ট গেমের ধারণাগুলি পর্যালোচনা করা আপনার জন্য সহায়ক হতে পারে।

ইভেন্ট পরিষেবা ব্যবহার করার জন্য আপনার C++ ডেভেলপমেন্ট পরিবেশ সেট আপ করতে, C++ এর জন্য শুরু করার নির্দেশিকাতে দেওয়া নির্দেশাবলী অনুসরণ করুন। আপনি SDK ডাউনলোড পৃষ্ঠা থেকে Play Games পরিষেবা C++ SDK ডাউনলোড করতে পারেন।

আপনার গেম ইভেন্টগুলি অ্যাক্সেস করার আগে, আপনাকে প্রথমে Google Play Console- এ সেগুলি সংজ্ঞায়িত করতে হবে।

একটি ইভেন্ট জমা দিন

আপনার গেমের আগ্রহের কোনও ঘটনা ঘটলে ইভেন্ট পরিষেবাকে অবহিত করার জন্য আপনি আপনার গেমে কোড যোগ করতে পারেন। আপনার গেমে আপনি যে ইভেন্টগুলি ধারণ করতে পারেন তার উদাহরণ হল: শত্রুদের হত্যা করা, বিভিন্ন গেম অঞ্চল অন্বেষণ করা বা ফিরে আসা, অথবা গেমের মধ্যে থাকা আইটেমগুলি অর্জন করা। সাধারণত, খেলোয়াড় যখনই ইভেন্টের সাথে সম্পর্কিত কোনও ক্রিয়া সম্পাদন করে (উদাহরণস্বরূপ, "একটি দানবকে হত্যা করা হয়েছে") তখন ইভেন্ট ম্যানেজারে আপনি Increment পদ্ধতিটি কল করে ইভেন্টের সংখ্যা 1 দ্বারা বৃদ্ধি করবেন।

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে আপনি ইভেন্ট পরিষেবাতে আপডেট করা ইভেন্ট গণনা জমা দিতে পারেন।

  // Increment the event count when player performs the 'Attack blue
  // monster' action.
  game_services_->Events().Increment(BLUE_MONSTER_EVENT_ID);

ইভেন্টগুলি পুনরুদ্ধার করুন

কোনও নির্দিষ্ট ইভেন্টের জন্য Google এর সার্ভারে সংরক্ষিত বর্তমান গণনার মান পুনরুদ্ধার করতে, Fetch* পদ্ধতিগুলির একটিতে কল করুন। উদাহরণস্বরূপ, আপনি যদি কোনও খেলোয়াড়ের ইন-গেম পরিসংখ্যান বা আপনার গেমের একটি কাস্টম UI থেকে অগ্রগতি দেখাতে চান তবে আপনি এটি করতে পারেন।

নিচের উদাহরণটি দেখায় কিভাবে আপনি আপনার গেমের ইভেন্ট ডেটা পুনরুদ্ধার এবং লগ করতে পারেন।

  // Log Events details.
  LogI("---- Showing Event Counts -----");
  gpg::EventManager::FetchAllCallback callback =
      [](gpg::EventManager::FetchAllResponse const &response) {
    for (auto i : response.data) {
      gpg::Event const &event = i.second;
      LogI("Event name: %s  count: %d", event.Name().c_str(),
           event.Count());
    }
  };
  game_services_->Events().FetchAll(callback);