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

এই নির্দেশিকাটি আপনাকে দেখাবে কিভাবে একটি অ্যান্ড্রয়েড অ্যাপ্লিকেশনে গেম স্ট্যাটস এপিআই (Game Stats APIs) ব্যবহার করে আপনার গেমের স্ট্যাটস আনলক ও প্রদর্শন করতে হয়। এই এপিআইগুলো com.google.android.gms.games এবং com.google.android.gms.games.playergameevent প্যাকেজগুলোতে পাওয়া যাবে।

শুরু করার আগে

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

গেম স্ট্যাটস এপিআই ব্যবহার করে কোডিং শুরু করার আগে:

• Google Play Games Services ব্যবহার করার জন্য আপনার অ্যাপ ইনস্টল ও সেট আপ করতে 'Set Up Google Play services SDK' গাইডে দেওয়া নির্দেশাবলী অনুসরণ করুন।

• Google Play Console গাইডের নির্দেশনা অনুসরণ করে, আপনার গেমের জন্য যে পরিসংখ্যানগুলো আনলক বা প্রদর্শন করতে চান, তা নির্ধারণ করুন।

একটি গেম স্ট্যাটস ক্লায়েন্ট নিন

গেম স্ট্যাটস এপিআই ব্যবহার শুরু করতে, আপনার গেমকে প্রথমে একটি GameStatsClient অবজেক্ট পেতে হবে। আপনি Games.getGameStatsClient() মেথডটি কল করে এবং অ্যাক্টিভিটিটি পাস করে এটি করতে পারেন।

ক্লায়েন্ট সাইড ইন্টিগ্রেশন

PlayerGameEvent এর ক্লায়েন্ট সাইড ইন্টিগ্রেশনের জন্য আপনাকে জাভা SDK-তে ট্রিগার পয়েন্টগুলোতে ইভেন্ট অবজেক্ট তৈরি করতে হবে এবং SDK-প্রদত্ত আপলোড ফাংশন ব্যবহার করে সেগুলো পাঠাতে হবে।

একইভাবে, progressUpdate ইভেন্টের জন্য, currentProgress প্রপার্টি ও অতিরিক্ত নির্ধারিত প্রপার্টি ব্যবহার করে আপডেট হওয়া অগ্রগতি রেকর্ড করুন এবং SDK দ্বারা প্রদত্ত আপলোড ফাংশন ব্যবহার করে সেগুলো পাঠান।

ইভেন্টগুলি

PlayerGameEvent এর জন্য ক্লায়েন্ট সাইড ইন্টিগ্রেশনগুলো হলো:

প্লেয়ার গেম ইভেন্ট তৈরি করুন

জাভা

// Build the PlayerGameEvent
PlayerGameEvent event = new PlayerGameEvent.Builder("matchCompleted")
  .addProperty("matchId", "Match_A")
  .addProperty("gameMode", "Battle_B")
  .addProperty("mapId", "Location_XYZ")
  .addProperty("isWinner", true)
  .addProperty("playerElimination", 2)
  .build();

List events = new ArrayList<>();
// ... populate list ...

নির্মাণের progressUpdate প্লেয়ার গেম ইভেন্ট

জাভা

// Build the PlayerGameEvent
PlayerGameEvent event = new PlayerGameEvent.Builder("progressUpdate")
  .addProperty("currentProgress", 52)
  // Add other properties if needed
  .build();

List events = new ArrayList<>();
// ... populate list ...

ঘটনা রেকর্ড করুন এবং আপলোড করুন

জাভা

// Buffers the event locally.
client.recordEvent(event);

// Buffers the events locally, (List version)
client.recordEvents(events);

// This submits the events to PGS
client.requestEventsUpload();

দ্রষ্টব্য: আপলোড করা প্রতিটি ইভেন্ট কনসোলে ঘোষিত স্কিমার সাথে মিলিয়ে যাচাই করা হবে। যদি আপলোড করা ইভেন্টে কনসোলে ঘোষিত প্রোপার্টি বা সংশ্লিষ্ট ডেটাটাইপ থেকে ভিন্ন কিছু থাকে, তবে ইভেন্টটি সাবমিট করা হবে না এবং এপিআই কল রেসপন্সে একটি প্রাসঙ্গিক প্রতিক্রিয়া পাঠানো হবে। ব্যাচ আপলোডের ক্ষেত্রে, আপলোড করা প্রতিটি ইভেন্ট ঘোষিত স্কিমার সাথে মিলিয়ে যাচাই করা হবে এবং যে ইভেন্টগুলো স্কিমা পূরণে ব্যর্থ হবে, সেগুলো সাবমিট করা হবে না এবং ব্যর্থতার কারণসহ রেসপন্সে দেখানো হবে।