इस दस्तावेज़ में, Google Play Console का इस्तेमाल करके, गेम में गेम के आंकड़ों की सुविधा को इंटिग्रेट करने का तरीका बताया गया है. इसमें CSV और ZIP फ़ाइल के ज़रूरी फ़ॉर्मैट के बारे में बताया गया है. साथ ही, उन्हें बनाने, इंपोर्ट करने, और मैनेज करने का तरीका बताया गया है.
इवेंट बनाना या इंपोर्ट करना
Google Play Console पर पहली बार इवेंट जोड़ने के लिए, दो मुख्य तरीके हैं:
- इवेंट बनाएं: एक बार में एक इवेंट जोड़ें.
- इवेंट इंपोर्ट करना: एक से ज़्यादा इवेंट इंपोर्ट करें.
कोई इवेंट बनाना
किसी गेम के लिए इवेंट बनाने के लिए, यह तरीका अपनाएं:
- Google Play Console में जाकर कोई गेम चुनें.
- Google Play की गेम सेवाएं - गेम के आंकड़े पेज (उपयोगकर्ताओं की संख्या बढ़ाएं > Google Play की गेम सेवाएं > सेटअप और मैनेजमेंट > गेम के आंकड़े) पर जाकर, कोई इवेंट जोड़ें > कोई इवेंट बनाएं को चुनें.
- इवेंट बनाएं पेज पर फ़ॉर्म भरें.
- बदलाव सेव करें पर क्लिक करें.
इवेंट इंपोर्ट करना
अपने गेम में एक ही बार में कई इवेंट जोड़ने के लिए, यह तरीका अपनाएं:
- इवेंट की CSV फ़ाइल PlayerGameEvent.csv बनाएं.
- Google Play Console में जाकर कोई गेम चुनें.
- Google Play की गेम सेवाएं - गेम के आंकड़े पेज (उपयोगकर्ताओं की संख्या बढ़ाएं > Google Play की गेम सेवाएं > सेटअप और मैनेजमेंट > गेम के आंकड़े) पर जाकर, कोई इवेंट जोड़ें > CSV फ़ाइल के ज़रिए इंपोर्ट करें को चुनें.
- इवेंट कॉन्फ़िगरेशन पेज पर, CSV फ़ाइल को खींचकर छोड़ें.
- इवेंट बनाने के बाद, आंकड़े सेट अप करें.
आंकड़े बनाना या इंपोर्ट करना
Google Play Console पर पहली बार आंकड़े जोड़ने के लिए, दो मुख्य तरीके हैं:
- कोई आंकड़ा बनाएं: एक बार में एक आंकड़ा जोड़ें.
- आंकड़े इंपोर्ट करना: कई आंकड़े इंपोर्ट करें.
कोई आंकड़ा बनाएं
किसी गेम के लिए आंकड़े बनाने के लिए, यह तरीका अपनाएं:
- Google Play Console में जाकर कोई गेम चुनें.
- Play की गेम सेवाएं - गेम के आंकड़े पेज (उपयोगकर्ताओं की संख्या बढ़ाएं > Play की गेम सेवाएं > सेटअप और मैनेजमेंट > गेम के आंकड़े) पर जाकर, कोई आंकड़ा जोड़ें > कोई आंकड़ा बनाएं को चुनें.
- कोई आंकड़ा बनाएं पेज पर फ़ॉर्म भरें.
- बदलाव सेव करें पर क्लिक करें.
- आंकड़ा बनाने के बाद, अपना गेम पब्लिश करें.
इंपोर्ट के आंकड़े
आंकड़े इंपोर्ट करने के लिए, यह तरीका अपनाएं:
- आंकड़ों के लिए ZIP फ़ाइल से जुड़े दिशा-निर्देशों के मुताबिक, आंकड़े, स्थानीय भाषाओं में अनुवाद, और आइकॉन की फ़ाइलें शामिल करके ZIP फ़ाइल बनाएं.
- Google Play Console में जाकर कोई गेम चुनें.
- Google Play की गेम सेवाएं - गेम के आंकड़े पेज (उपयोगकर्ताओं की संख्या बढ़ाएं > Google Play की गेम सेवाएं > सेटअप और मैनेजमेंट > गेम के आंकड़े) पर जाकर, कोई आंकड़ा जोड़ें > ZIP फ़ाइल के ज़रिए इंपोर्ट करें को चुनें.
- गेम के आंकड़ों का कॉन्फ़िगरेशन पेज पर, 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.
ध्यान दें: एपीआई में, कुछ डेटा अपलोड करने की सुविधा होती है. इसलिए, इस जानकारी वाले लॉग से पता चलता है कि बैच को प्रोसेस किया गया था. अगर बैच में मौजूद किसी इवेंट के लिए स्कीमा की पुष्टि नहीं हो पाती है, तो इस मैसेज से पहले गड़बड़ी का लॉग दिखेगा.
अगर सबमिट किए गए किसी इवेंट की पुष्टि नहीं हो पाती है, तो आपको गड़बड़ी का एक मैसेज दिखेगा. इसमें गड़बड़ी की जानकारी दी जाएगी:
BatchRecordEvents validation failed for X event(s): ...
गेम के आंकड़े पब्लिश करना
टेस्टिंग पूरी होने के बाद, आपको अपना गेम पब्लिश करना होगा. गेम के सभी इवेंट और आंकड़े, गेम के साथ पब्लिश हो जाते हैं.
पब्लिश करने के लिए, यह तरीका अपनाएं:
- Google Play Console में जाकर कोई गेम चुनें.
- Google Play की गेम सेवाएं - गेम के आंकड़े पेज (उपयोगकर्ताओं की संख्या बढ़ाएं > Google Play की गेम सेवाएं > सेटअप और मैनेजमेंट > गेम के आंकड़े) पर जाकर, समीक्षा करें और पब्लिश करें पर क्लिक करें.
- Play की गेम सेवाएं - पब्लिश करना पेज (उपयोगकर्ता बढ़ाएं > Play की गेम सेवाएं > सेटअप और मैनेजमेंट > पब्लिश करना) पर जाकर, कार्रवाइयों की समीक्षा करें और समस्याओं को ठीक करें.
- पब्लिश करें पर क्लिक करें. गेम के सभी आंकड़े पब्लिश हो गए हैं.
गेम के आंकड़ों में बदलाव करना
अगर आपने पहले से गेम के आंकड़े जोड़े हैं और आपको उनमें बदलाव करना है, तो:
- Google Play Console में जाकर कोई गेम चुनें.
- Google Play की गेम सेवाएं - गेम के आंकड़े पेज (उपयोगकर्ताओं की संख्या बढ़ाएं > Google Play की गेम सेवाएं > सेटअप और मैनेजमेंट > गेम के आंकड़े) पर जाएं.
- किसी इवेंट में बदलाव करने के लिए:
- इवेंट कॉन्फ़िगरेशन सेक्शन में, कोई इवेंट चुनें.
- इवेंट प्रॉपर्टी को जोड़ा या मिटाया जा सकता है.
- इवेंट के नाम में बदलाव नहीं किया जा सकता.
- बदलाव सेव करें पर क्लिक करें.
- किसी आंकड़े में बदलाव करने के लिए:
- गेम के आंकड़ों का कॉन्फ़िगरेशन सेक्शन में जाकर, कोई आंकड़ा चुनें.
- आंकड़े का नाम, आंकड़े की जानकारी, और आइकॉन फ़ाइल का नाम फ़ील्ड में बदलाव किया जा सकता है.
- आंकड़े का आईडी और प्रोग्रेस की दिशा में बदलाव नहीं किया जा सकता. आंकड़ों की इकाई और इससे जुड़े इवेंट की जानकारी.
- बदलाव सेव करें पर क्लिक करें.
- Google Play की गेम सेवाएं - गेम के आंकड़े पेज पर, बदलाव किए गए आंकड़े का स्टेटस टेस्टर के लिए उपलब्ध है के तौर पर दिखता है.
- आंकड़े की जांच करने के बाद, समीक्षा करें और पब्लिश करें पर क्लिक करें. इससे आपका गेम, अपडेट किए गए सभी आंकड़ों के साथ फिर से पब्लिश हो जाता है.
गेम के आंकड़े मिटाना
गेम के आंकड़ों को पब्लिश करने के बाद, उन्हें मिटाया नहीं जा सकता.
टेस्टर के लिए उपलब्ध स्टेटस वाले किसी इवेंट या आंकड़े को मिटाया जा सकता है.
- Google Play Console में जाकर कोई गेम चुनें.
- Google Play की गेम सेवाएं - गेम के आंकड़े पेज (उपयोगकर्ताओं की संख्या बढ़ाएं > Google Play की गेम सेवाएं > सेटअप और मैनेजमेंट > गेम के आंकड़े) पर जाएं.
- किसी इवेंट को मिटाने के लिए:
- इवेंट कॉन्फ़िगरेशन सेक्शन में, कोई इवेंट चुनें.
- इवेंट मिटाएं पर क्लिक करें.
- किसी आंकड़े को मिटाने के लिए:
- गेम के आंकड़ों का कॉन्फ़िगरेशन में जाकर, वह आंकड़ा चुनें जिसे आपको मिटाना है.
- गेम का आंकड़ा मिटाएं पर क्लिक करें.
इवेंट के लिए CSV फ़ाइल से जुड़े दिशा-निर्देश
CSV फ़ाइल की पहली लाइन, हेडर वाली लाइन होती है. आपको इवेंट की CSV फ़ाइल का इस्तेमाल करके इवेंट इंपोर्ट करने होंगे. उदाहरण के लिए, PlayerGameEvent.csv.
PlayerGameEvent.csv फ़ॉर्मैट
CSV फ़ाइल में, एलान किए गए इवेंट और उसकी प्रॉपर्टी, कॉमा लगाकर अलग की गई वैल्यू के तौर पर इस क्रम में शामिल होती हैं:
Event Name,Property Name,Property Type
अगर progressionStat के लिए progressUpdate इवेंट भेजा जाता है, तो इस इवेंट के लिए एक लाइन जोड़ें. इस इवेंट में, INT या STRING टाइप की कम से कम एक currentProgress प्रॉपर्टी होनी चाहिए. साथ ही, इसमें वे अन्य प्रॉपर्टी भी शामिल होनी चाहिए जिन्हें आपको भेजना है.
यहां दी गई टेबल में, इन फ़ील्ड के बारे में बताया गया है:
| CSV कॉलम के हेडर | ज़रूरी या वैकल्पिक | स्वीकार की जाने वाली वैल्यू |
|---|---|---|
| इवेंट का नाम | ज़रूरी है | ज़्यादा से ज़्यादा 50 वर्ण इसमें सिर्फ़ अक्षर, संख्याएं, और अंडरस्कोर होने चाहिए. अगर खास इवेंट के नाम |
| प्रॉपर्टी का नाम | ज़रूरी है | ज़्यादा से ज़्यादा 50 वर्ण इसमें सिर्फ़ अक्षर, संख्याएं, और अंडरस्कोर होने चाहिए. हर इवेंट के लिए यूनीक: एक ही इवेंट में प्रॉपर्टी के नाम यूनीक होने चाहिए. इन रिज़र्व कीवर्ड का इस्तेमाल न करें: |
| प्रॉपर्टी किस तरह की है | ज़रूरी है | केस-सेंसिटिव enum स्ट्रिंग, जो इस्तेमाल किए जा सकने वाले इनमें से किसी एक डेटा टाइप से मेल खाती हो:
INT64, DOUBLE, STRING, BOOL
|
PlayerGameEvent.csv फ़ाइल से जुड़ी ज़रूरी शर्तें:
- फ़ाइल में ज़्यादा से ज़्यादा 20 यूनीक इवेंट के नाम हो सकते हैं. साथ ही, हर इवेंट के लिए ज़्यादा से ज़्यादा 20 प्रॉपर्टी हो सकती हैं.
- फ़ाइल का कॉन्टेंट खाली नहीं होना चाहिए. साथ ही, इसमें कम से कम एक लाइन होनी चाहिए.
टेबल का उदाहरण
| इवेंट का नाम | प्रॉपर्टी का नाम | प्रॉपर्टी किस तरह की है |
|---|---|---|
| matchCompleted | कुल समय | DOUBLE |
| matchCompleted | किल | INT64 |
| matchCompleted | isWinner | BOOL |
| matchCompleted | matchType | STRING |
| itemCollected | coinsAmount | INT64 |
| itemCollected | weaponType | STRING |
| progressUpdate | currentProgress | INT64 |
आंकड़ों के लिए ZIP फ़ाइल से जुड़े दिशा-निर्देश
ZIP फ़ाइल का इस्तेमाल करके, एक बार में कई आंकड़े इंपोर्ट किए जा सकते हैं. अपनी ZIP फ़ाइल में इस्तेमाल करने के लिए, फ़ाइल के सटीक नामों की टेबल देखें:
| फ़ाइलनाम | ज़रूरी या वैकल्पिक | स्वीकार की जाने वाली वैल्यू |
|---|---|---|
RepetitiveStatsConfig.csv
|
ज़रूरी है | बार-बार दिखने वाले आंकड़े, गेम में खिलाड़ियों की ओर से नियमित तौर पर की जाने वाली कार्रवाइयों को दिखाते हैं. |
ProgressionStatConfig.csv
|
ज़रूरी है | प्रोग्रेशन स्टैट, किसी गेम में खिलाड़ी की प्रोग्रेस को दिखाता है. |
StatLocalizations.csv
|
वैकल्पिक | गेम के आंकड़ों के नाम और ब्यौरे के अनुवाद उपलब्ध कराता है. |
| आइकॉन वाली फ़ाइलें | ज़रूरी है | 512 x 512 PNG, JPEG या JPG फ़ॉर्मैट में आइकॉन. |
ZIP फ़ाइल को ये ज़रूरी शर्तें पूरी करनी होंगी:
- ZIP फ़ाइल के साइज़ की सीमा: कंप्रेस किए बिना, फ़ाइल का कुल साइज़ ज़्यादा से ज़्यादा 10 एमबी होना चाहिए.
- ज़्यादा से ज़्यादा फ़ाइलें: ZIP फ़ॉर्मैट वाले आर्काइव में ज़्यादा से ज़्यादा 53 फ़ाइलें (3 CSV और 50 आइकॉन) होनी चाहिए.
- कुल आंकड़ों की तय सीमा:
ProgressionStatConfig.csvऔरRepetitiveStatsConfig.csvमें कुल मिलाकर ज़्यादा से ज़्यादा 50 आंकड़े हो सकते हैं. - इस्तेमाल की जा सकने वाली CSV फ़ाइलें:
ProgressionStatConfig.csv,RepetitiveStatsConfig.csv, औरStatLocalizations.csv(ज़रूरी नहीं). अगर आपको सिर्फ़ प्रोग्रेशन स्टैट अपलोड करना है, तो ZIP फ़ाइल में बार-बार होने वाले स्टैट की CSV फ़ाइल शामिल न करें. ऐसा न करने पर, कंसोल में गड़बड़ी का मैसेज दिखता है. अगर आपको सिर्फ़ बार-बार दोहराए जाने वाले आंकड़े अपलोड करने हैं, तो भी यही बात लागू होती है. - आइकॉन की इमेज फ़ाइलें: PNG (.png) या JPEG (.jpg, .jpeg).
- CSV फ़ाइलों में रेफ़र किए गए सभी आइकॉन, ZIP फ़ाइल के रूट में मौजूद होने चाहिए.
- 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 कॉलम के हेडर | ज़रूरी या वैकल्पिक | स्वीकार की जाने वाली वैल्यू |
|---|---|---|
| आंकड़े का आईडी | ज़रूरी है | ज़्यादा से ज़्यादा 100 वर्ण इसमें सिर्फ़ अक्षर, संख्याएं, और अंडरस्कोर होने चाहिए. यह गेम के सभी आंकड़ों के लिए यूनीक होना चाहिए. |
| इवेंट का नाम | ज़रूरी है | ज़्यादा से ज़्यादा 50 वर्ण इसमें PlayerGameEvent.csv फ़ॉर्मैट में तय किए गए इवेंट के नाम का रेफ़रंस होना चाहिए. |
| इवेंट प्रॉपर्टी का नाम | ज़रूरी है | ज़्यादा से ज़्यादा 50 वर्ण |
| आंकड़े का डिसप्ले नेम | ज़रूरी है | ज़्यादा से ज़्यादा 50 वर्ण आंकड़े के लिए डिफ़ॉल्ट डिसप्ले नेम (डिफ़ॉल्ट स्थान-भाषा). यह सभी आंकड़ों के लिए यूनीक होना चाहिए. |
| आंकड़े की जानकारी | ज़रूरी है | ज़्यादा से ज़्यादा 500 वर्ण आंकड़े के लिए डिफ़ॉल्ट ब्यौरा. |
| एग्रीगेशन का टाइप | ज़रूरी है | ज़्यादा से ज़्यादा 50 वर्ण SUM, MAX, MIN, COUNT. |
| प्रॉपर्टी फ़िल्टर करें | वैकल्पिक | ज़्यादा से ज़्यादा 50 वर्ण यह PlayerGameEvent.csv में तय किया गया प्रॉपर्टी का नाम होना चाहिए. |
| फ़िल्टर ऑपरेटर | वैकल्पिक | =, !=, >, <, >=, <=फ़िल्टर की तुलना करने वाले ऑपरेटर. |
| फ़िल्टर की वैल्यू | वैकल्पिक | फ़िल्टर प्रॉपर्टी की तुलना में.
फ़िल्टर की वैल्यू INT64, DOUBLE, BOOL, STRING होनी चाहिए.
|
| Is Competitive | ज़रूरी है | true, false
|
| कम से कम सीमा | अगर 'क्या इसका इस्तेमाल प्रतिस्पर्धी के लिए होगा' की वैल्यू 'सही' है, तो यह वैल्यू देना ज़रूरी है | प्रतिस्पर्धा के आंकड़ों के लिए, कम से कम स्कोर. |
| ज़्यादा से ज़्यादा सीमा | अगर 'क्या इसका इस्तेमाल प्रतिस्पर्धी के लिए होगा' की वैल्यू 'सही' है, तो यह वैल्यू देना ज़रूरी है | प्रतिस्पर्धा के आंकड़ों के लिए, ज़्यादा से ज़्यादा स्कोर. |
| आइकॉन फ़ाइल का नाम | ज़रूरी है | ZIP फ़ाइल के रूट में शामिल आइकॉन इमेज का फ़ाइल नाम. यह नाम, बार-बार इस्तेमाल होने वाले आंकड़ों में इस्तेमाल किए गए आइकॉन फ़ाइल के नामों से मेल नहीं खाना चाहिए. |
| अच्छी वैल्यू का रुझान | ज़रूरी है | इससे पता चलता है कि ज़्यादा वैल्यू INCREASING बेहतर हैं या कम वैल्यू DECREASING.
|
| इकाई | वैकल्पिक | रॉ न्यूमेरिक या अवधि की वैल्यू के लिए, मेज़रमेंट की यूनिट. उदाहरण के लिए, किलोमीटर, सेकंड, प्रतिशत, यूनिटलेस. |
अगर आपको फ़िल्टर करने की शर्त का इस्तेमाल नहीं करना है, तो सेल को खाली छोड़ दें.
टेबल का उदाहरण
| आंकड़े का आईडी | इवेंट का नाम | प्रॉपर्टी का नाम | एक साथ दिखाना | आंकड़े का डिसप्ले नेम | आंकड़े की जानकारी | फ़िल्टर प्रॉपर्टी (ज़रूरी नहीं) | फ़िल्टर ऑपरेटर (ज़रूरी नहीं) | फ़िल्टर वैल्यू (ज़रूरी नहीं) | Is Competitive | minLimit | maxLimit | आइकॉन फ़ाइल नाम | अच्छी वैल्यू का रुझान | इकाई |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | matchCompleted | कुल समय | ज़्यादा से ज़्यादा | Longest Match Survival | इससे पता चलता है कि किसी मैच में कोई खिलाड़ी कितनी देर तक टिका रहा | isWinner | = | सही | सही | 0 | 50 | stat1.png | घट रहे हैं | सेकंड |
| 2 | matchCompleted | isWinner | COUNT | जीते गए मैच | इससे पता चलता है कि किसी खिलाड़ी ने कितने मैच जीते हैं | isWinner | = | सही | सही | 0 | 50 | stat3.png | बढ़ रहे हैं | |
| 3 | matchCompleted | किल | SUM | 1-on-1 मैच में किल | 1-on-1 मैचों में मारे गए दुश्मनों की संख्या | matchType | = | "1-on-1" | FALSE | stat4.png | बढ़ रहे हैं | |||
| 4 | itemCollected | coinsAmount | SUM | इकट्ठा किया गया कुल सोना | मैच के दौरान सिक्के इकट्ठा करता खिलाड़ी | weaponType | = | "तलवार" | FALSE | stat2.png | बढ़ रहे हैं |
ProgressionStatConfig.csv फ़ॉर्मैट
इस CSV फ़ाइल में, एलान किए गए इवेंट और उसकी प्रॉपर्टी की जानकारी, कॉमा लगाकर अलग की गई वैल्यू के तौर पर इस क्रम में शामिल होती है:
Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit
प्रोग्रेशन स्टैट, खिलाड़ी को उसकी गेमर प्रोफ़ाइल में पहले स्टैट के तौर पर दिखेगा.
यहां दी गई टेबल में, इन फ़ील्ड के बारे में बताया गया है:
| CSV कॉलम के हेडर | ज़रूरी या वैकल्पिक | स्वीकार की जाने वाली वैल्यू |
|---|---|---|
| आंकड़े का आईडी | ज़रूरी है | ज़्यादा से ज़्यादा 100 वर्ण इसमें सिर्फ़ अक्षर, संख्याएं, और अंडरस्कोर होने चाहिए. यह गेम के सभी आंकड़ों के लिए यूनीक होना चाहिए. |
| इवेंट प्रॉपर्टी का नाम | ज़रूरी है | ज़्यादा से ज़्यादा 50 वर्ण यह PlayerGameEvent.csv में तय किया गया प्रॉपर्टी का नाम होना चाहिए. |
| आंकड़े का डिसप्ले नेम | ज़रूरी है | नाम यूनीक होना चाहिए. |
| आंकड़े की जानकारी | ज़रूरी है | ज़्यादा से ज़्यादा 50 वर्ण आंकड़े के लिए डिफ़ॉल्ट ब्यौरा. |
| आइकॉन फ़ाइल का नाम | ज़रूरी है | ZIP फ़ाइल के रूट में शामिल आइकॉन इमेज का फ़ाइल नाम. यह नाम, बार-बार इस्तेमाल होने वाले आंकड़ों में इस्तेमाल किए गए आइकॉन फ़ाइल के नामों से मेल नहीं खाना चाहिए. |
| अच्छी वैल्यू का रुझान | ज़रूरी है | इससे पता चलता है कि ज़्यादा वैल्यू INCREASING बेहतर हैं या कम वैल्यू DECREASING.
|
| इकाई | वैकल्पिक | रॉ न्यूमेरिक या अवधि की वैल्यू के लिए, मेज़रमेंट की यूनिट. उदाहरण के लिए, किलोमीटर, सेकंड, प्रतिशत, यूनिटलेस. |
टेबल का उदाहरण
| आंकड़े का आईडी | इवेंट प्रॉपर्टी का नाम | आंकड़े का डिसप्ले नेम | आंकड़े की जानकारी | आइकॉन फ़ाइल का नाम | अच्छी वैल्यू के लिए निर्देश |
|---|---|---|---|---|---|
| 5 | currentProgress | लेवल | खिलाड़ी, मैच खेलकर एक्सपी इकट्ठा करते हैं और लेवल अप करते हैं. | Level.png | बढ़ती हुई |
StatLocalizations.csv फ़ॉर्मैट
इस CSV फ़ाइल में, एलान किए गए इवेंट और उसकी प्रॉपर्टी की जानकारी, कॉमा लगाकर अलग की गई वैल्यू के तौर पर इस क्रम में शामिल होती है:
Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description
यहां दी गई टेबल में, इन फ़ील्ड के बारे में बताया गया है:
| CSV कॉलम के हेडर | ज़रूरी या वैकल्पिक | स्वीकार की जाने वाली वैल्यू |
|---|---|---|
| आंकड़े का आईडी | ज़रूरी है | ज़्यादा से ज़्यादा 100 वर्ण इसमें सिर्फ़ अक्षर, संख्याएं, और अंडरस्कोर होने चाहिए. यह गेम के सभी आंकड़ों के लिए यूनीक होना चाहिए. |
| आंकड़े का डिसप्ले नेम | ज़रूरी है | नाम यूनीक होना चाहिए. |
| स्थान-भाषा | ज़रूरी है | स्थानीय भाषा का कोड, जैसे कि en-US. स्थानीय भाषा तय करने से पहले, अपने गेम के लिए अनुवाद जोड़ें. ध्यान दें कि डिफ़ॉल्ट रूप से दी गई भाषा की जानकारी सबमिट नहीं की जा सकती. चुनी जा सकने वाली स्थानीय भाषाओं के कोड, चुनी जा सकने वाली भाषाओं की सूची में देखे जा सकते हैं. |
| स्थानीय भाषा में आंकड़े का डिसप्ले नेम | वैकल्पिक | ज़्यादा से ज़्यादा 50 वर्ण. दी गई स्थानीय भाषा के लिए, आंकड़े के डिसप्ले नेम का अनुवाद. |
| स्थानीय भाषा में आंकड़े की जानकारी | वैकल्पिक | ज़्यादा से ज़्यादा 500 वर्ण. दी गई स्थान-भाषा के लिए, आंकड़े का अनुवाद किया गया ब्यौरा. |
टेबल का उदाहरण
| आंकड़े का आईडी | आंकड़े का डिसप्ले नेम | भाषा का कोड | स्थानीय भाषा में आंकड़े का नाम (UTF-8) | Localized Stat Description (UTF-8) |
|---|---|---|---|---|
| 1 | Longest Match Survival | es | Supervivencia más larga en partidos | इससे पता चलता है कि किसी मैच में कोई खिलाड़ी कितनी देर तक सर्वाइव कर सकता है. |
| 1 | Longest Match Survival | fr | Survie du match le plus long | Cela indique la durée de survie d'un joueur dans n'importe quel match. |
| 4 | इकट्ठा किया गया कुल सोना | es | Oro total recolectado | La jugadora recoge monedas mientras juega en un partido |
| 4 | इकट्ठा किया गया कुल सोना | fr | Or total collecté | Le joueur collecte des pièces en jouant un match |
आइकॉन फ़ाइलें
CSV फ़ाइल में बताए गए आइकॉन, इंपोर्ट किए गए मौजूदा ZIP फ़ॉर्मैट वाले आर्काइव में मौजूद होने चाहिए.
आइकॉन की पुष्टि करने के नियम ये हैं:
| पुष्टि करने वाली प्रॉपर्टी | लागू की गई पाबंदी / नियम |
|---|---|
| फ़ाइल का ज़्यादा से ज़्यादा साइज़ | हर आइकॉन फ़ाइल का साइज़ ज़्यादा से ज़्यादा 1 एमबी (10,48,576 बाइट) होना चाहिए. |
| डाइमेंशन | ठीक 512 × 512 पिक्सल (चौड़ाई = 512, ऊंचाई = 512) |
| आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) | सिर्फ़ 1:1 (स्क्वेयर आसपेक्ट रेशियो) |
| इस्तेमाल किए जा सकने वाले फ़ॉर्मैट | PNG (.png) और JPEG (.jpg, .jpeg) |
| ZIP फ़ॉर्मैट में प्लेसमेंट | यह ZIP फ़ाइल की रूट डायरेक्ट्री में होनी चाहिए. |
| रेफ़रंस की जांच | आइकॉन फ़ाइल नाम कॉलम में बताई गई सभी आइकॉन फ़ाइल के नाम, ZIP में मौजूद होने चाहिए. |
| अनाथ की जांच | ZIP फ़ाइल में मौजूद सभी इमेज फ़ाइलों का रेफ़रंस, कम से कम एक आंकड़े में दिया जाना चाहिए. |
| कॉन्फ़्लिक्ट चेक | ProgressionStatConfig.csv में मौजूद आइकॉन के फ़ाइल नाम, RepetitiveStatsConfig.csv से मेल नहीं खाने चाहिए.
|
| डुप्लीकेट विज़ुअल | डुप्लीकेट आइकॉन को फ़्लैग किया जाता है. |
आइकॉन से जुड़े दिशा-निर्देश
आइकॉन 512 x 512 PNG, JPEG या JPG फ़ाइलों के तौर पर बनाए जाने चाहिए. साथ ही, इनका बैकग्राउंड पारदर्शी होना चाहिए.
सभी भाषाओं में एक ही आइकॉन का इस्तेमाल किया जाता है. इसलिए, हमारा सुझाव है कि आप आइकॉन में कोई टेक्स्ट या स्थानीय भाषा में लिखा गया कॉन्टेंट शामिल न करें.
यूनिट की जानकारी
यूनिट कॉलम से यह कंट्रोल किया जाता है कि रॉ स्टैट वैल्यू को खिलाड़ियों के लिए कैसे फ़ॉर्मैट और स्थानीय भाषा में उपलब्ध कराया जाए.
संख्या वाले आंकड़ों की प्रॉपर्टी (INT64, DOUBLE)
| इस्तेमाल की जा सकने वाली यूनिट वैल्यू | रॉ वैल्यू का उदाहरण |
| (Empty) / UNITLESS / NONE | 1234567 |
| % / PERCENTAGE / PERCENT | 0.857 |
| दूरी/लंबाई: सेंटीमीटर, मीटर, किलोमीटर, फ़ुट, इंच, मील, यार्ड, मिलीमीटर, नैनोमीटर | 15 (किलोमीटर) |
| स्पीड: KILOMETER_PER_HOUR, METER_PER_SECOND, MILE_PER_HOUR | 60 (MILE_PER_HOUR) |
अवधि के आंकड़ों की प्रॉपर्टी (DURATION)
| फ़ॉर्मैट कैटगरी की वैल्यू | इकाई की इस्तेमाल की जा सकने वाली वैल्यू | रॉ वैल्यू का उदाहरण | फ़ॉर्मैट किए गए आउटपुट का उदाहरण |
| UNIT_BASED / DURATION | ज़रूरी है: SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, YEAR | 5400 सेकंड (घंटा) | 1.5 घंटे |
| COMPONENT_NUMERIC / HH:MM:SS / CLOCK | ग्रैन्युलैरिटी (ज़रूरी नहीं, डिफ़ॉल्ट रूप से WHOLE_SECONDS): WHOLE_MINUTES, WHOLE_SECONDS, MILLISECONDS_ONE_DIGIT, MILLISECONDS_TWO_DIGITS, MILLISECONDS_THREE_DIGITS | 3661 सेकंड | 01:01:01 |
| COMPONENT_TEXT / TEXT | सबसे छोटी यूनिट (ज़रूरी नहीं, डिफ़ॉल्ट रूप से SECONDS): SECONDS, MINUTES, HOURS, DAYS, MONTHS, YEARS | 90000 सेकंड | 1 दिन 1 घंटा |
बिना संख्या वाले आंकड़ों की प्रॉपर्टी (STRING, BOOL)
यूनिट वाले कॉलम खाली छोड़ें.