Google Play Console ব্যবহার করে কীভাবে আপনার গেমে গেমের পরিসংখ্যান ইন্টিগ্রেট করবেন তা এই ডকুমেন্টে ব্যাখ্যা করা হয়েছে। এটি CSV এবং ZIP ফাইলের প্রয়োজনীয় ফরম্যাট কভার করে এবং কীভাবে সেগুলি তৈরি, ইমপোর্ট এবং ম্যানেজ করতে হয় তা বর্ণনা করে।
ইভেন্ট তৈরি বা ইমপোর্ট করা
Google Play Console ব্যবহার করে প্রথমবার ইভেন্ট যোগ করার দুটি উপায় আছে:
- ইভেন্ট তৈরি করা: একবারে একটি ইভেন্ট যোগ করুন।
- ইভেন্ট ইমপোর্ট করুন: একাধিক ইভেন্ট ইমপোর্ট করুন।
একটি ইভেন্ট তৈরি করুন
কোনও গেমের জন্য ইভেন্ট তৈরি করতে, এইসব ধাপ সম্পূর্ণ করুন:
- Google Play Console থেকে কোনও গেম বেছে নিন।
- Play Games Services - গেমের পরিসংখ্যান পৃষ্ঠায় (ব্যবহারকারী বাড়ান > Play Games Services > সেট-আপ ও ম্যানেজমেন্ট > গেমের পরিসংখ্যান), ইভেন্ট যোগ করুন > ইভেন্ট তৈরি করুন বিকল্প বেছে নিন।
- ইভেন্ট তৈরি করুন পৃষ্ঠায় ফর্মটি পূরণ করুন।
- পরিবর্তন সেভ করুন বিকল্পে ক্লিক করুন।
ইভেন্ট ইমপোর্ট করুন
আপনার গেমে একসাথে একাধিক ইভেন্ট যোগ করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:
- ইভেন্টের CSV ফাইল PlayerGameEvent.csv তৈরি করুন।
- Google Play Console-এ কোনও গেম বেছে নিন।
- Play Games Services - গেমের পরিসংখ্যান পৃষ্ঠায় (ব্যবহারকারী বাড়ান > Play Games Services > সেট-আপ ও ম্যানেজমেন্ট > গেমের পরিসংখ্যান), ইভেন্ট যোগ করুন > CSV-এর মাধ্যমে ইমপোর্ট করুন বিকল্প বেছে নিন।
- ইভেন্ট কনফিগারেশন পৃষ্ঠায়, আপলোড করার জন্য CSV ফাইল ড্রপ করুন।
- ইভেন্ট তৈরি করার পরে, পরিসংখ্যান সেট-আপ করুন।
পরিসংখ্যান তৈরি বা ইমপোর্ট করুন
Google Play Console ব্যবহার করে প্রথমবার পরিসংখ্যান যোগ করার দুটি উপায় আছে:
- পরিসংখ্যান তৈরি করুন: একবারে একটি পরিসংখ্যান যোগ করুন।
- পরিসংখ্যান ইমপোর্ট করুন: একাধিক পরিসংখ্যান ইমপোর্ট করুন।
পরিসংখ্যান তৈরি করুন
কোনও গেমের জন্য স্ট্যাট তৈরি করতে, এইসব ধাপ সম্পূর্ণ করুন:
- Google Play Console-এ কোনও গেম বেছে নিন।
- Play Games Services - গেমের পরিসংখ্যান পৃষ্ঠায় (ব্যবহারকারী বাড়ান > Play Games Services > সেট-আপ ও ম্যানেজমেন্ট > গেমের পরিসংখ্যান), পরিসংখ্যান যোগ করুন > পরিসংখ্যান তৈরি করুন বিকল্প বেছে নিন।
- পরিসংখ্যান তৈরি করুন পৃষ্ঠায় ফর্মটি পূরণ করুন।
- পরিবর্তন সেভ করুন বিকল্পে ক্লিক করুন।
- স্ট্যাট তৈরি করার পরে, আপনার গেম প্রকাশ করুন।
পরিসংখ্যান ইমপোর্ট করুন
পরিসংখ্যান ইমপোর্ট করতে, এই ধাপগুলি অনুসরণ করুন:
- পরিসংখ্যানের জন্য জিপ ফাইল সংক্রান্ত নির্দেশিকা অনুযায়ী পরিসংখ্যান, লোকালাইজেশন ও আইকন ফাইল সহ জিপ ফাইল তৈরি করুন।
- Google Play Console-এ কোনও গেম বেছে নিন।
- Play Games Services - গেমের পরিসংখ্যান পৃষ্ঠায় (ব্যবহারকারী বাড়ান > Play Games Services > সেট-আপ ও ম্যানেজমেন্ট > গেমের পরিসংখ্যান), পরিসংখ্যান যোগ করুন > ZIP-এর মাধ্যমে ইমপোর্ট করুন বিকল্প বেছে নিন।
- গেমের পরিসংখ্যান কনফিগারেশন পৃষ্ঠায়, আপলোড করার জন্য জিপ ফাইলটি ড্রপ করুন।
- সব পরিসংখ্যান আপলোড করার পরে, আপনার গেম প্রকাশ করুন।
গেমের পরিসংখ্যান টেস্ট করুন
গেমের পরিসংখ্যান প্রত্যাশা অনুযায়ী কাজ করছে কিনা তা যাচাই করতে, সেগুলি পরীক্ষা করার জন্য এই ধাপগুলি অনুসরণ করুন:
- Google Play Store অ্যাপ খুলুন।
- Google Play Store অ্যাপে আপনার Play Games প্রোফাইলে সাইন-ইন করুন।
- আপনার গেমার প্রোফাইলে গেমের পরিসংখ্যান দেখুন।
আপনার ডিভাইসে লগ দেখুন
গেমের পরিসংখ্যান ডিজাইন অনুযায়ী কাজ করছে কিনা তা যাচাই করতে, আপনার ডিভাইসে লগ চালু করুন:
আপনার ডিভাইসে adb ডিবাগিং চালু করুন এবং টার্মিনালে নিম্নলিখিত কমান্ডগুলি রান করুন:
adb shell setprop log.tag.Games INFO adb logcat -s "PlayGamesServices[GameStatsAgent]:I"
নিচের উদাহরণে যেমন দেখানো হয়েছে, সেই অনুযায়ী একটি সফল লগ মেসেজ দেখা যাচ্ছে কিনা তা যাচাই করুন:
Successfully uploaded batch of X events.
মনে রাখবেন: API আংশিক আপলোড সমর্থন করে বলে, এই তথ্য লগ থেকে বোঝা যায় যে ব্যাচ প্রসেস করা হয়েছে। ব্যাচের মধ্যে কোনও স্বতন্ত্র ইভেন্ট স্কিমা যাচাইকরণে ব্যর্থ হলে, এই মেসেজের আগে একটি ত্রুটি লগ থাকবে।
জমা দেওয়া কোনও ইভেন্ট যাচাইকরণে ব্যর্থ হলে, আপনি ব্যর্থতার বিবরণ সহ একটি ত্রুটি মেসেজ দেখতে পাবেন:
BatchRecordEvents validation failed for X event(s): ...
গেমের পরিসংখ্যান প্রকাশ করা
পরীক্ষা করা হয়ে গেলে, আপনাকে গেম প্রকাশ করতে হবে। আপনার গেমের সব ইভেন্ট ও পরিসংখ্যান এর সাথে প্রকাশ করা হয়।
প্রকাশ করতে, এই ধাপগুলি অনুসরণ করুন:
- Google Play Console-এ, একটি গেম বেছে নিন।
- Play Games Services - গেমের পরিসংখ্যান পৃষ্ঠায় (ব্যবহারকারী বাড়ান > Play Games Services > সেট-আপ ও ম্যানেজমেন্ট > গেমের পরিসংখ্যান), পর্যালোচনা করে প্রকাশ করুন বিকল্পে ক্লিক করুন।
- Play Games Services - প্রকাশনা পৃষ্ঠায় (ব্যবহারকারী বাড়ান > Play Games Services > সেট-আপ ও ম্যানেজমেন্ট > প্রকাশনা), অ্যাকশন পর্যালোচনা করে সমস্যা সমাধান করুন।
- প্রকাশ করুন বিকল্পে ক্লিক করুন। আপনার সব গেমের পরিসংখ্যান প্রকাশ করা হয়েছে।
গেমের পরিসংখ্যান এডিট করুন
আপনার কাছে আগে থেকেই গেমের পরিসংখ্যান থাকলে এবং আপনি তা এডিট করতে চাইলে:
- Google Play Console থেকে কোনও গেম বেছে নিন।
- Play Games পরিষেবা - গেমের পরিসংখ্যান পৃষ্ঠায় যান (ব্যবহারকারী বাড়ান > Play Games পরিষেবা > সেট-আপ ও ম্যানেজমেন্ট > গেমের পরিসংখ্যান)।
- ইভেন্ট এডিট করতে:
- ইভেন্ট কনফিগারেশন বিভাগে, একটি ইভেন্ট বেছে নিন।
- আপনি ইভেন্ট প্রপার্টি যোগ করতে বা মুছে ফেলতে পারবেন।
- আপনি ইভেন্টের নাম এডিট করতে পারবেন না।
- পরিবর্তন সেভ করুন বিকল্পে ক্লিক করুন।
- স্ট্যাট এডিট করতে:
- গেমের পরিসংখ্যান কনফিগারেশন বিভাগে, একটি পরিসংখ্যান বেছে নিন।
- আপনি পরিসংখ্যানের নাম, পরিসংখ্যানের বিবরণ এবং আইকন ফাইলের
নাম ফিল্ড এডিট করতে পারবেন।
- আপনি স্ট্যাট আইডি, প্রোগ্রেস করার দিক এডিট করতে পারবেন না। পরিসংখ্যান ইউনিট এবং সংশ্লিষ্ট ইভেন্টের বিবরণ।
- পরিবর্তন সেভ করুন বিকল্পে ক্লিক করুন।
- Play Games পরিষেবা - গেমের পরিসংখ্যান পৃষ্ঠায়, এডিট করা পরিসংখ্যান টেস্টারদের জন্য উপলভ্য স্ট্যাটাসে থাকে।
- স্ট্যাট পরীক্ষা করার পরে, পর্যালোচনা করে প্রকাশ করুন বিকল্পে ক্লিক করুন। এটি আপনার গেম, আপনার সব আপডেট করা পরিসংখ্যান সহ আবার প্রকাশ করে।
গেমের পরিসংখ্যান মুছে দিন
গেমের পরিসংখ্যান প্রকাশ করার পরে, এটি মুছে ফেলা যাবে না।
আপনি টেস্টারদের জন্য উপলভ্য স্ট্যাটাসে থাকা কোনও ইভেন্ট বা স্ট্যাট মুছে দিতে পারবেন।
- Google Play Console-এ কোনও গেম বেছে নিন।
- Play Games পরিষেবা - গেমের পরিসংখ্যান পৃষ্ঠায় যান (ব্যবহারকারী বাড়ান > Play Games পরিষেবা > সেট-আপ ও ম্যানেজমেন্ট > গেমের পরিসংখ্যান)।
- ইভেন্ট মুছে দিতে:
- ইভেন্ট কনফিগারেশন বিভাগে, একটি ইভেন্ট বেছে নিন।
- ইভেন্ট মুছুন বিকল্পে ক্লিক করুন।
- Stat মুছে দিতে:
- গেমের পরিসংখ্যান কনফিগারেশন থেকে, আপনি যে পরিসংখ্যান মুছতে চান সেটি বেছে নিন।
- গেমের পরিসংখ্যান মুছুন বিকল্পে ক্লিক করুন।
ইভেন্টের জন্য CSV ফাইল সংক্রান্ত নির্দেশিকা
CSV ফাইলের প্রথম সারিটি হল হেডারের সারি। আপনাকে অবশ্যই ইভেন্ট CSV ফাইল ব্যবহার করে ইভেন্ট ইমপোর্ট করতে হবে, যেমন, PlayerGameEvent.csv।
PlayerGameEvent.csv ফর্ম্যাট
CSV-তে ঘোষিত ইভেন্ট এবং এর প্রপার্টি কমা দ্বারা আলাদা করা মান হিসেবে নিম্নলিখিত ক্রমে থাকে:
Event Name,Property Name,Property Type
আপনি progressionStat-এর জন্য progressUpdate ইভেন্ট পাঠালে, এই ইভেন্টের জন্য একটি সারি যোগ করুন। এই ইভেন্টে INT বা STRING ধরনের অন্তত একটি currentProgress প্রপার্টি থাকতে হবে, এছাড়াও আপনি অন্য যেকোনও প্রপার্টি পাঠাতে পারেন।
এইসব ফিল্ডের বিবরণ নিচের টেবিলে দেওয়া হয়েছে:
| CSV কলাম হেডার | প্রয়োজনীয় বা ঐচ্ছিক | গ্রহণযোগ্য মান |
|---|---|---|
| ইভেন্টের নাম | প্রয়োজনীয় | সর্বাধিক ৫০টি অক্ষর এতে শুধু অক্ষর, সংখ্যা ও আন্ডারস্কোর থাকতে হবে। বিশেষ ইভেন্টের নাম |
| প্রপার্টির নাম | প্রয়োজনীয় | সর্বাধিক ৫০টি অক্ষর এতে শুধু অক্ষর, সংখ্যা ও আন্ডারস্কোর থাকতে হবে। প্রতি ইভেন্টে অনন্য: একই ইভেন্টের মধ্যে প্রপার্টির নাম অনন্য হতে হবে। নিম্নলিখিত রিজার্ভ করা কীওয়ার্ড ব্যবহার করবেন না: |
| প্রপার্টির ধরন | প্রয়োজনীয় | ছোট ও বড় হাতের অক্ষরের মধ্যে পার্থক্য করা হয় এমন enum স্ট্রিং যা কাজ করে এমন ডেটার ধরনের সাথে মেলে:
INT64, DOUBLE, STRING, BOOL
|
PlayerGameEvent.csv ফাইলের প্রয়োজনীয়তা:
- ফাইলটিতে সর্বাধিক ২০টি অনন্য ইভেন্টের নাম এবং প্রতিটি ইভেন্টে সর্বাধিক ২০টি প্রপার্টি থাকতে পারে।
- ফাইলের কন্টেন্ট খালি থাকলে চলবে না এবং কমপক্ষে ১টি সারি থাকতে হবে।
উদাহরণ টেবিল
| ইভেন্টের নাম | প্রপার্টির নাম | প্রপার্টির ধরন |
|---|---|---|
| matchCompleted | সময়কাল | ডবল সাইজ |
| matchCompleted | কিল | INT64 |
| matchCompleted | isWinner | BOOL |
| matchCompleted | matchType | STRING |
| itemCollected | coinsAmount | INT64 |
| itemCollected | weaponType | STRING |
| progressUpdate | currentProgress | INT64 |
পরিসংখ্যানের জন্য জিপ ফাইল সংক্রান্ত নির্দেশিকা
আপনি জিপ ফাইল ব্যবহার করে একবারে পরিসংখ্যান ইমপোর্ট করতে পারবেন। আপনার ZIP ফাইলে ব্যবহার করার জন্য সঠিক ফাইলের নাম জানতে টেবিলটি দেখুন:
| ফাইলের নাম | প্রয়োজনীয় বা ঐচ্ছিক | গ্রহণযোগ্য মান |
|---|---|---|
RepetitiveStatsConfig.csv
|
প্রয়োজনীয় | পুনরাবৃত্তিমূলক পরিসংখ্যান বলতে নিয়মিত ঘটা ইন-গেম অ্যাকশনকে বোঝায় যা প্লেয়াররা পারফর্ম করেন। |
ProgressionStatConfig.csv
|
প্রয়োজনীয় | প্রোগ্রেস স্ট্যাটাস কোনও গেমে প্লেয়ারের প্রোগ্রেস দেখায়। |
StatLocalizations.csv
|
ঐচ্ছিক | গেমের পরিসংখ্যানের নাম ও বিবরণের অনুবাদ প্রদান করে। |
| Icon files | প্রয়োজনীয় | ৫১২ x ৫১২ PNG, JPEG বা JPG ফর্ম্যাটে আইকন। |
জিপ ফাইলকে নিম্নলিখিত প্রয়োজনীয়তা পূরণ করতে হবে:
- ZIP ফাইলের সাইজের সীমা: আনকমপ্রেসড ফাইলের মোট সাইজ সর্বাধিক ১০ এমবি হতে পারে।
- সর্বাধিক ফাইল: ZIP আর্কাইভে মোট সর্বাধিক ৫৩টি (৩টি CSV এবং ৫০টি আইকন) ফাইল।
- সর্বাধিক সম্মিলিত পরিসংখ্যানের সীমা:
ProgressionStatConfig.csvএবংRepetitiveStatsConfig.csvজুড়ে সর্বাধিক ৫০টি মোট পরিসংখ্যান। - যেসব CSV ফাইল কাজ করে:
ProgressionStatConfig.csv,RepetitiveStatsConfig.csvএবংStatLocalizations.csv(ঐচ্ছিক)। আপনি যদি শুধুমাত্র প্রগ্রেস স্ট্যাট আপলোড করতে চান, তাহলে ZIP ফাইলে পুনরাবৃত্তিমূলক স্ট্যাট CSV ফাইল অন্তর্ভুক্ত করবেন না; অন্যথায়, কনসোল একটি ত্রুটি দেখাবে। আপনি যদি শুধুমাত্র পুনরাবৃত্তিমূলক পরিসংখ্যান আপলোড করতে চান, তাহলে একই নিয়ম প্রযোজ্য হবে। - আইকন ছবির ফাইল: PNG (.png) বা JPEG (.jpg, .jpeg)।
- CSV-তে উল্লেখ করা সব আইকন ZIP ফাইলের রুটে থাকতে হবে।
- ZIP-এ থাকা সব ছবির ফাইল অন্তত একটি স্ট্যাট দ্বারা রেফারেন্স করা হতে হবে।
- ডিরেক্টরি স্ট্রাকচার: সব ফাইল জিপ ফাইলের রুটে থাকতে হবে। সাবডিরেক্টরির অনুমতি নেই।
RepetitiveStatsConfig.csv ফর্ম্যাট
CSV-তে ঘোষিত ইভেন্ট এবং এর প্রপার্টি কমা দ্বারা আলাদা করা মান হিসেবে নিম্নলিখিত ক্রমে থাকে:
Stat Id,Event Name,Event Property Name,Aggregation Type,Stat Display Name,Stat Description,Filter Property,Filter Operator,Filter Value,Is Competitive,Min limit,Max limit,Icon File Name,Good value direction,Unit
এইসব ফিল্ডের বিবরণ নিচের টেবিলে দেওয়া হয়েছে:
| CSV কলাম হেডার | প্রয়োজনীয় বা ঐচ্ছিক | গ্রহণযোগ্য মান |
|---|---|---|
| পরিসংখ্যান আইডি | প্রয়োজনীয় | সর্বাধিক ১০০টি অক্ষর এতে শুধু অক্ষর, সংখ্যা ও আন্ডারস্কোর থাকতে হবে। গেমের সব স্ট্যাট জুড়ে অনন্য হতে হবে। |
| ইভেন্টের নাম | প্রয়োজনীয় | সর্বাধিক ৫০টি অক্ষর PlayerGameEvent.csv ফর্ম্যাটে সংজ্ঞায়িত ইভেন্টের নাম উল্লেখ করতে হবে। |
| ইভেন্ট প্রপার্টির নাম | প্রয়োজনীয় | সর্বাধিক ৫০ অক্ষরের মধ্যে লিখতে হবে |
| পরিসংখ্যানের যে নাম দেখানো হবে | প্রয়োজনীয় | সর্বাধিক ৫০টি অক্ষর পরিসংখ্যানের জন্য ডিফল্ট ডিসপ্লে নাম (ডিফল্ট লোকেল)। পরিসংখ্যান জুড়ে অনন্য হতে হবে। |
| পরিসংখ্যানের বিবরণ | প্রয়োজনীয় | সর্বাধিক ৫০০টি অক্ষর পরিসংখ্যানের জন্য ডিফল্ট বিবরণ। |
| এগ্রিগেশনের ধরন | প্রয়োজনীয় | সর্বাধিক ৫০টি অক্ষর SUM, MAX, MIN, COUNT. |
| ফিল্টার প্রপার্টি | ঐচ্ছিক | সর্বাধিক ৫০টি অক্ষর PlayerGameEvent.csv-তে সংজ্ঞায়িত প্রপার্টির নাম হতে হবে। |
| ফিল্টার অপারেটর | ঐচ্ছিক | =, !=, >, <, >=, <=ফিল্টার তুলনা করার অপারেটর। |
| ফিল্টার ভ্যালু | ঐচ্ছিক | ফিল্টার প্রপার্টির সাথে তুলনা করা হয়েছে।
ফিল্টারের মান INT64, DOUBLE, BOOL, STRING হতে হবে।
|
| প্রতিযোগিতামূলক কিনা | প্রয়োজনীয় | true, false
|
| সর্বনিম্ন সীমা | Is Competitive ট্রু হলে প্রয়োজন | প্রতিযোগিতামূলক পরিসংখ্যানের জন্য ন্যূনতম অনুমোদিত স্কোর। |
| সর্বোচ্চ সীমা | Is Competitive ট্রু হলে প্রয়োজন | প্রতিযোগিতামূলক পরিসংখ্যানের জন্য সর্বাধিক অনুমোদিত স্কোর। |
| আইকন ফাইলের নাম | প্রয়োজনীয় | ZIP ফাইলের রুটে অন্তর্ভুক্ত আইকন ছবির ফাইলের নাম। পুনরাবৃত্তিমূলক পরিসংখ্যানে ব্যবহৃত আইকন ফাইলের নামের সাথে বিরোধ করা যাবে না। |
| ভালো দামের দিকনির্দেশ | প্রয়োজনীয় | বেশি ভ্যালু INCREASING নাকি কম ভ্যালু DECREASING ভালো তা নির্দিষ্ট করে।
|
| ইউনিট | ঐচ্ছিক | র-সংখ্যা বা সময়সীমার ভ্যালুর জন্য পরিমাপের একক। যেমন, কিলোমিটার, সেকেন্ড, শতাংশ, ইউনিটলেস। |
আপনি ফিল্টার কন্ডিশন ব্যবহার করতে না চাইলে, সেলটি ফাঁকা রাখুন।
উদাহরণ টেবিল
| পরিসংখ্যান আইডি | ইভেন্টের নাম | প্রপার্টির নাম | একসাথে | পরিসংখ্যানের যে নাম দেখানো হবে | পরিসংখ্যানের বিবরণ | ফিল্টার প্রপার্টি (ঐচ্ছিক) | ফিল্টার অপারেটর (ঐচ্ছিক) | ফিল্টার ভ্যালু (ঐচ্ছিক) | প্রতিযোগিতামূলক কিনা | minLimit | maxLimit | আইকন ফাইলের নাম | ভালো দামের দিকনির্দেশ | ইউনিট |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | matchCompleted | সময়কাল | ফুল স্পিড | সবচেয়ে দীর্ঘ মিল সারভাইভাল | এটি কোনও ম্যাচে একজন খেলোয়াড়ের টিকে থাকার সময়কে বোঝায় | isWinner | = | TRUE | TRUE | 0 | 50 | stat1.png | কমছে | সেকেন্ড |
| 2 | matchCompleted | isWinner | সংখ্যা | ম্যাচ জিতেছে | এটি থেকে বোঝা যায় যে একজন প্লেয়ার কতগুলি ম্যাচ জিতেছেন | isWinner | = | TRUE | TRUE | 0 | 50 | stat3.png | বাড়ছে | |
| 3 | matchCompleted | কিল | SUM | ১-বনাম-১ ম্যাচে কিল | ১-বনাম-১ ম্যাচে যতগুলি কিল করা হয়েছে | matchType | = | "১-অন-১" | মিথ্যা | stat4.png | বাড়ছে | |||
| 4 | itemCollected | coinsAmount | SUM | মোট যত সোনা সংগ্রহ করা হয়েছে | ম্যাচ খেলার সময় প্লেয়ার কয়েন সংগ্রহ করে | weaponType | = | "তলোয়ার" | মিথ্যা | stat2.png | বাড়ছে |
ProgressionStatConfig.csv ফর্ম্যাট
CSV-তে ঘোষিত ইভেন্ট এবং তার প্রপার্টি কমা দিয়ে আলাদা করা ভ্যালু হিসেবে নিম্নলিখিত ক্রমে থাকে:
Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit
অগ্রগতির পরিসংখ্যান একজন প্লেয়ারকে তার গেমার প্রোফাইলে প্রথম পরিসংখ্যান হিসেবে দেখানো হবে।
এইসব ফিল্ডের বিবরণ নিচের টেবিলে দেওয়া হয়েছে:
| CSV কলাম হেডার | প্রয়োজনীয় বা ঐচ্ছিক | গ্রহণযোগ্য মান |
|---|---|---|
| পরিসংখ্যান আইডি | প্রয়োজনীয় | সর্বাধিক ১০০টি অক্ষর এতে শুধু অক্ষর, সংখ্যা ও আন্ডারস্কোর থাকতে হবে। গেমের সব স্ট্যাট জুড়ে অনন্য হতে হবে। |
| ইভেন্ট প্রপার্টির নাম | প্রয়োজনীয় | সর্বাধিক ৫০টি অক্ষর PlayerGameEvent.csv-তে সংজ্ঞায়িত প্রপার্টির নাম হতে হবে। |
| পরিসংখ্যানের যে নাম দেখানো হবে | প্রয়োজনীয় | অবশ্যই একটি অনন্য নাম হতে হবে। |
| পরিসংখ্যানের বিবরণ | প্রয়োজনীয় | সর্বাধিক ৫০টি অক্ষর পরিসংখ্যানের জন্য ডিফল্ট বিবরণ। |
| আইকন ফাইলের নাম | প্রয়োজনীয় | ZIP ফাইলের রুটে অন্তর্ভুক্ত আইকন ছবির ফাইলের নাম। পুনরাবৃত্তিমূলক পরিসংখ্যানে ব্যবহৃত আইকন ফাইলের নামের সাথে বিরোধ করা যাবে না। |
| ভালো দামের দিকনির্দেশ | প্রয়োজনীয় | বেশি ভ্যালু INCREASING নাকি কম ভ্যালু DECREASING ভালো তা নির্দিষ্ট করে।
|
| ইউনিট | ঐচ্ছিক | র-সংখ্যা বা সময়সীমার ভ্যালুর জন্য পরিমাপের একক। যেমন, কিলোমিটার, সেকেন্ড, শতাংশ, ইউনিটলেস। |
উদাহরণ টেবিল
| Stat ID | ইভেন্ট প্রপার্টির নাম | পরিসংখ্যানের ডিসপ্লে নাম | পরিসংখ্যানের বিবরণ | আইকন ফাইলের নাম | ভালো ভ্যালু সংক্রান্ত দিকনির্দেশ |
|---|---|---|---|---|---|
| 5 | currentProgress | লেভেল | প্লেয়াররা ম্যাচ খেলে এবং লেভেল আপ করে XP সংগ্রহ করে। | Level.png | বাড়ছে |
StatLocalizations.csv ফর্ম্যাট
CSV-তে ঘোষিত ইভেন্ট এবং তার প্রপার্টি কমা দিয়ে আলাদা করা ভ্যালু হিসেবে নিম্নলিখিত ক্রমে থাকে:
Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description
এইসব ফিল্ডের বিবরণ নিচের টেবিলে দেওয়া হয়েছে:
| CSV কলাম হেডার | প্রয়োজনীয় বা ঐচ্ছিক | গ্রহণযোগ্য মান |
|---|---|---|
| পরিসংখ্যান আইডি | প্রয়োজনীয় | সর্বাধিক ১০০টি অক্ষর এতে শুধু অক্ষর, সংখ্যা ও আন্ডারস্কোর থাকতে হবে। গেমের সব স্ট্যাট জুড়ে অনন্য হতে হবে। |
| পরিসংখ্যানের যে নাম দেখানো হবে | প্রয়োজনীয় | অবশ্যই একটি অনন্য নাম হতে হবে। |
| লোকেল | প্রয়োজনীয় | লোকেল কোড, যেমন en-US. লোকেল নির্দিষ্ট করার আগে আপনার গেমের জন্য অনুবাদ যোগ করুন। মনে রাখবেন যে আপনি ডিফল্ট লোকেল নির্দিষ্ট করতে পারবেন না। কাজ করে এমন লোকেল কোড কাজ করে এমন ভাষার তালিকায় পাওয়া যাবে। |
| স্থানীয় করা স্ট্যাট ডিসপ্লে নাম | ঐচ্ছিক | সর্বাধিক ৫০টি অক্ষর লেখা যাবে। প্রদত্ত লোকেলের জন্য অনুবাদ করা স্ট্যাট ডিসপ্লে নাম। |
| লোকালাইজড স্ট্যাটাসের বিবরণ | ঐচ্ছিক | সর্বাধিক ৫০০টি অক্ষর। প্রদত্ত লোকেলের জন্য অনুবাদ করা স্ট্যাটাসের বিবরণ। |
উদাহরণ টেবিল
| পরিসংখ্যান আইডি | পরিসংখ্যানের যে নাম দেখানো হবে | ভাষার কোড | লোকালাইজ করা স্ট্যাট নাম (UTF-8) | স্থানীয়কৃত স্ট্যাটাসের বিবরণ (UTF-8) |
|---|---|---|---|---|
| 1 | সবচেয়ে দীর্ঘ মিল সারভাইভাল | es | Supervivencia más larga en partidos | Esto denota el tiempo de supervivencia de una jugadora en cualquier partido. |
| 1 | সবচেয়ে দীর্ঘ মিল সারভাইভাল | fr | Survie du match le plus long | Cela indique la durée de survie d'un joueur dans n'importe quel match. |
| 4 | মোট যত সোনা সংগ্রহ করা হয়েছে | es | মোট সংগৃহীত সোনা | La jugadora recoge monedas mientras juega en un partido |
| 4 | মোট যত সোনা সংগ্রহ করা হয়েছে | fr | অথবা মোট সংগ্রহ | Le joueur collecte des pièces en jouant un match |
আইকন ফাইল
CSV ফাইলে আপনি যে আইকন রেফারেন্স করেন তা আপনার ইমপোর্ট করা বর্তমান ZIP আর্কাইভে অবশ্যই থাকতে হবে।
আইকন যাচাইকরণের নিয়মগুলি হল:
| যাচাইকরণ প্রপার্টি | প্রয়োগ করা সীমাবদ্ধতা / নিয়ম |
|---|---|
| ফাইলের সর্বাধিক সাইজ | প্রতিটি আইকন ফাইলের জন্য সর্বাধিক ১ এমবি (১,০৪৮,৫৭৬ বাইট)। |
| ডাইমেনশন | ঠিক ৫১২ × ৫১২ পিক্সেল (প্রস্থ = ৫১২, উচ্চতা = ৫১২) |
| অ্যাসপেক্ট রেশিও | ১:১ (বর্গাকার অ্যাস্পেক্ট রেশিও) হতে হবে |
| অনুমোদিত ফর্ম্যাট | PNG (.png) এবং JPEG (.jpg, .jpeg) |
| ZIP-এ প্লেসমেন্ট | এটি অবশ্যই ZIP ফাইলের রুট ডিরেক্টরিতে থাকতে হবে। |
| রেফারেন্স চেক | আইকন ফাইলের নাম কলামে উল্লেখ করা সব আইকন ফাইলের নাম ZIP-এ থাকতে হবে। |
| অনাথ চেক | ZIP-এর মধ্যে থাকা সব ছবির ফাইলের অন্তত একটি স্ট্যাট রেফারেন্স থাকতে হবে। |
| দ্বন্দ্ব চেক করা | ProgressionStatConfig.csv-এ আইকন ফাইলের নাম
RepetitiveStatsConfig.csv-এর সাথে কনফ্লিক্ট করতে পারবে না।
|
| ভিজ্যুয়াল ডুপ্লিকেট | ডুপ্লিকেট আইকন ফ্ল্যাগ করা হয়েছে। |
আইকন সংক্রান্ত নির্দেশিকা
আইকনটি ৫১২ x ৫১২ PNG, JPEG বা JPG ফাইল হিসেবে তৈরি করতে হবে এবং এর ব্যাকগ্রাউন্ড স্বচ্ছ হতে হবে।
সব লোকেলে একই আইকন ব্যবহার করা হয়, তাই আমরা আইকনে কোনও টেক্সট বা লোকালাইজ করা কন্টেন্ট অন্তর্ভুক্ত না করার সাজেশন দিই।
ইউনিট স্পেসিফিকেশন
ইউনিট কলাম, কীভাবে কাঁচা পরিসংখ্যানের ভ্যালু ফর্ম্যাট করা হয় এবং প্লেয়ারদের জন্য লোকালাইজ করা হয় তা নিয়ন্ত্রণ করে।
সংখ্যাগত স্ট্যাট প্রপার্টি (INT64, DOUBLE)
| অনুমোদিত ইউনিট ভ্যালু | প্রকৃত ভ্যালুর উদাহরণ |
| (Empty) / UNITLESS / NONE | 1234567 |
| % / PERCENTAGE / PERCENT / শতাংশ | 0.857 |
| দূরত্ব/দৈর্ঘ্য: সেন্টিমিটার, মিটার, কিলোমিটার, ফুট, ইঞ্চি, মাইল, গজ, মিলিমিটার, ন্যানোমিটার | 15 (KILOMETER) |
| গতি: KILOMETER_PER_HOUR, METER_PER_SECOND, MILE_PER_HOUR | ৬০ (MILE_PER_HOUR) |
সময়সীমা সংক্রান্ত পরিসংখ্যানের প্রপার্টি (DURATION)
| ফর্ম্যাট ক্যাটাগরি ভ্যালু | অনুমোদিত ইউনিট ভ্যালু | প্রকৃত ভ্যালুর উদাহরণ | ফর্ম্যাট করা আউটপুটের উদাহরণ |
| ইউনিট-ভিত্তিক / সময়সীমা | প্রয়োজন: সেকেন্ড, মিনিট, ঘণ্টা, দিন, সপ্তাহ, মাস, বছর | ৫৪০০ সেকেন্ড (HOUR) | ১.৫ ঘণ্টা |
| COMPONENT_NUMERIC / HH:MM:SS / CLOCK | গ্র্যানুলারিটি (ঐচ্ছিক, ডিফল্ট WHOLE_SECONDS): WHOLE_MINUTES, WHOLE_SECONDS, MILLISECONDS_ONE_DIGIT, MILLISECONDS_TWO_DIGITS, MILLISECONDS_THREE_DIGITS | ৩৬৬১ সেকেন্ড | 01:01:01 |
| COMPONENT_TEXT / TEXT | সবচেয়ে ছোট ইউনিট (ঐচ্ছিক, ডিফল্ট সেকেন্ড): সেকেন্ড, মিনিট, ঘণ্টা, দিন, মাস, বছর | ৯০০০০ সেকেন্ড | ১ দিন ১ ঘণ্টা |
নন-নিউমেরিক স্ট্যাট প্রপার্টি (STRING, BOOL)
ইউনিট কলাম খালি রাখতে হবে।