অ্যান্ড্রয়েড গেমের জন্য প্লেয়ার পরিসংখ্যান

এই নির্দেশিকা আপনাকে দেখায় কিভাবে Google Play Games পরিষেবার জন্য প্লেয়ার স্ট্যাটস API ব্যবহার করতে হয়। আপনি একজন খেলোয়াড়ের ইন-গেম কার্যকলাপ সম্পর্কে ডেটা পুনরুদ্ধার করতে প্লেয়ার পরিসংখ্যান API ব্যবহার করতে পারেন।

প্লেয়ারের পরিসংখ্যান API আপনাকে খেলোয়াড়দের নির্দিষ্ট অংশ এবং খেলোয়াড়ের জীবনচক্রের বিভিন্ন পর্যায়ের জন্য গেমের অভিজ্ঞতা তৈরি করতে দেয়। খেলোয়াড়রা কীভাবে অগ্রগতি করছে, ব্যয় করছে এবং আকর্ষক হচ্ছে তার উপর ভিত্তি করে আপনি প্রতিটি খেলোয়াড় বিভাগের জন্য উপযোগী অভিজ্ঞতা তৈরি করতে পারেন। উদাহরণস্বরূপ, একজন কম সক্রিয় খেলোয়াড়কে আপনার গেমের সাথে পুনরায় যুক্ত হতে উত্সাহিত করতে সক্রিয় পদক্ষেপ নিতে আপনি এই API ব্যবহার করতে পারেন, যেমন খেলোয়াড় সাইন ইন করলে নতুন ইন-গেম আইটেমগুলি প্রদর্শন এবং প্রচার করে৷

APIগুলি com.google.android.gms.games.stats এবং com.google.android.gms.games প্যাকেজে পাওয়া যাবে৷

আপনি যে ধরনের প্লেয়ার ডেটা পুনরুদ্ধার করতে পারেন তার মধ্যে রয়েছে:

• গড় সেশনের দৈর্ঘ্য : মিনিটে খেলোয়াড়ের গড় সেশনের দৈর্ঘ্য। সেশনের দৈর্ঘ্য নির্ধারিত হয় যখন একজন খেলোয়াড় Google Play Games পরিষেবায় সাইন ইন করেন।

• শেষবার খেলার দিন : প্লেয়ার শেষবার খেলার পর থেকে আনুমানিক দিনগুলি৷

• কেনাকাটার সংখ্যা : প্লেয়ারের জন্য অ্যাপ-মধ্যস্থ কেনাকাটার আনুমানিক সংখ্যা।

• সেশনের সংখ্যা : প্লেয়ারের সেশনের আনুমানিক সংখ্যা। একজন খেলোয়াড় কতবার Google Play গেম পরিষেবাগুলিতে সাইন ইন করে তার সংখ্যার দ্বারা সেশনগুলি নির্ধারিত হয়৷

• সেশন পার্সেন্টাইল : প্লেয়ারের জন্য সেশন পার্সেন্টাইলের আনুমানিকতা, 0 থেকে 1 এর মধ্যে একটি দশমিক মান হিসাবে প্রদত্ত। এই মানটি এই গেমের প্লেয়ার বেসের বাকি অংশের তুলনায় বর্তমান খেলোয়াড় কতটি সেশন খেলেছে তা নির্দেশ করে। উচ্চ সংখ্যা নির্দেশ করে যে এই খেলোয়াড় আরও বেশি সেশন খেলেছে।

• পার্সেন্টাইল খরচ : প্লেয়ারের আনুমানিক খরচ পার্সেন্টাইল, 0 থেকে 1 এর মধ্যে একটি দশমিক মান হিসাবে দেওয়া হয়। এই মানটি নির্দেশ করে যে এই গেমের প্লেয়ার বেসের বাকি অংশের তুলনায় বর্তমান খেলোয়াড় কতটা ব্যয় করেছে। উচ্চ সংখ্যা নির্দেশ করে যে এই খেলোয়াড় আরও বেশি খরচ করেছেন।

নিম্নলিখিত ধরনের প্লেয়ার ডেটা অবচয়িত হয় এবং সর্বদা একটি আনসেট মান ধ্রুবক ফেরত দেয়:

আপনি শুরু করার আগে

আপনি প্লেয়ার পরিসংখ্যান API ব্যবহার শুরু করার আগে:

• কোড নমুনা ডাউনলোড এবং পর্যালোচনা করুন.
• কোয়ালিটি চেকলিস্টে বর্ণিত সুপারিশগুলির সাথে নিজেকে পরিচিত করুন৷

ক্লায়েন্ট পান

প্লেয়ার স্ট্যাটস API ব্যবহার শুরু করতে, আপনার গেমটিকে প্রথমে একটি PlayerStatsClient অবজেক্ট পেতে হবে। আপনি Games.getPlayerStatsClient() পদ্ধতিতে কল করে এবং কার্যকলাপে পাস করে এটি করতে পারেন।

PlayerStatsClient ক্লাস অ্যাসিঙ্ক্রোনাসভাবে ফলাফল ফেরাতে Google Play পরিষেবার Task ক্লাস ব্যবহার করে। থ্রেডেড কাজ পরিচালনা করার জন্য টাস্ক ব্যবহার সম্পর্কে আরও জানতে, টাস্ক API ডেভেলপার গাইড দেখুন।

ডেটা পুনরুদ্ধার করুন

বর্তমানে সাইন ইন করা প্লেয়ারের জন্য প্লেয়ার পরিসংখ্যান ডেটা পুনরুদ্ধার করতে, এই পদক্ষেপগুলি অনুসরণ করুন:

1. PlayerStatsClient.loadPlayerStats() পদ্ধতিতে কল করুন।

2. কলটি সফল হলে, Google Play গেম পরিষেবাগুলি একটি Task অবজেক্ট ফেরত দেয় যা অ্যাসিঙ্ক্রোনাসভাবে একটি PlayerStats অবজেক্ট লোড করে। আপনার অ্যাপে সাইন-ইন করা প্লেয়ারের কার্যকলাপ সম্পর্কে ডেটা পুনরুদ্ধার করতে এই বস্তুর পদ্ধতিগুলি ব্যবহার করুন৷

এখানে একটি উদাহরণ:

public void checkPlayerStats() {
  PlayGames.getPlayerStatsClient(this)
      .loadPlayerStats(true)
      .addOnCompleteListener(new OnCompleteListener<AnnotatedData<PlayerStats>>() {
        @Override
        public void onComplete(@NonNull Task<AnnotatedData<PlayerStats>> task) {
          if (task.isSuccessful()) {
            // Check for cached data.
            if (task.getResult().isStale()) {
              Log.d(TAG, "using cached data");
            }
            PlayerStats stats = task.getResult().get();
            if (stats != null) {
              Log.d(TAG, "Player stats loaded");
              if (stats.getDaysSinceLastPlayed() > 7) {
                Log.d(TAG, "It's been longer than a week");
              }
              if (stats.getNumberOfSessions() > 1000) {
                Log.d(TAG, "Veteran player");
              }
              if (stats.getChurnProbability() == 1) {
                Log.d(TAG, "Player is at high risk of churn");
              }
            }
          } else {
            int status = CommonStatusCodes.DEVELOPER_ERROR;
            if (task.getException() instanceof ApiException) {
              status = ((ApiException) task.getException()).getStatusCode();
            }
            Log.d(TAG, "Failed to fetch Stats Data status: "
                + status + ": " + task.getException());
          }
        }
      });
}

টিপস

প্লে স্ট্যাটস API আপনাকে তাদের ব্যস্ততা এবং ব্যয় আচরণের উপর ভিত্তি করে বিভিন্ন ধরণের খেলোয়াড়কে সহজেই সনাক্ত করতে এবং তাদের খেলার অভিজ্ঞতা উন্নত করতে উপযুক্ত কৌশল প্রয়োগ করতে দেয়।

নিম্নলিখিত সারণীতে কিছু উদাহরণ প্লেয়ার বিভাগ এবং প্রস্তাবিত বাগদান কৌশলের তালিকা রয়েছে: