เอกสารนี้อธิบายวิธีผสานรวมสถิติเกมเข้ากับเกมโดยใช้ Google Play Console โดยจะครอบคลุมรูปแบบไฟล์ CSV และไฟล์ ZIP ที่จำเป็น รวมถึงอธิบายวิธีสร้าง นำเข้า และจัดการไฟล์เหล่านั้น
สร้างหรือนำเข้าเหตุการณ์
คุณเพิ่มกิจกรรมเป็นครั้งแรกโดยใช้ Google Play Console ได้ 2 วิธีดังนี้
- สร้างกิจกรรม: เพิ่มกิจกรรมทีละรายการ
- นำเข้ากิจกรรม: นำเข้าหลายกิจกรรม
สร้างกิจกรรม
หากต้องการสร้างกิจกรรมสำหรับเกม ให้ทำตามขั้นตอนต่อไปนี้
- เลือกเกมใน Google Play Console
- ในหน้าบริการเกมของ Play - สถิติเกม (เพิ่มผู้ใช้ > บริการเกมของ Play > การตั้งค่าและการจัดการ > สถิติเกม) ให้เลือกเพิ่มเหตุการณ์ > สร้างเหตุการณ์
- กรอกแบบฟอร์มในหน้าสร้างกิจกรรม
- คลิกบันทึกการเปลี่ยนแปลง
นำเข้ากิจกรรม
หากต้องการเพิ่มกิจกรรมหลายรายการในเกมพร้อมกัน ให้ทำตามขั้นตอนต่อไปนี้
- สร้างไฟล์ CSV ของกิจกรรม PlayerGameEvent.csv
- เลือกเกมใน Google Play Console
- ในหน้าบริการเกมของ Play - สถิติเกม (เพิ่มผู้ใช้ > บริการเกมของ Play > การตั้งค่าและการจัดการ > สถิติเกม) ให้เลือกเพิ่มกิจกรรม > นำเข้าผ่าน CSV
- ในหน้าการกำหนดค่าเหตุการณ์ ให้วางไฟล์ CSV เพื่ออัปโหลด
- หลังจากสร้างกิจกรรมแล้ว ให้ตั้งค่าสถิติ
สร้างหรือนำเข้าสถิติ
คุณเพิ่มสถิติเป็นครั้งแรกโดยใช้ Google Play Console ได้ 2 วิธีดังนี้
- สร้างสถิติ: เพิ่มสถิติทละรายการ
- สถิติการนำเข้า: นำเข้าสถิติหลายรายการ
สร้างสถิติ
หากต้องการสร้างสถิติสำหรับเกม ให้ทำตามขั้นตอนต่อไปนี้
- เลือกเกมใน Google Play Console
- ในหน้าบริการเกมของ Play - สถิติเกม (เพิ่มผู้ใช้ > บริการเกมของ Play > การตั้งค่าและการจัดการ > สถิติเกม) ให้เลือกเพิ่มสถิติ > สร้างสถิติ
- กรอกแบบฟอร์มในหน้าสร้างสถิติ
- คลิกบันทึกการเปลี่ยนแปลง
- หลังจากสร้างสถิติแล้ว ให้เผยแพร่เกม
สถิติการนำเข้า
หากต้องการนำเข้าสถิติ ให้ทำตามขั้นตอนต่อไปนี้
- สร้างไฟล์ ZIP ที่มีไฟล์สถิติ การแปล และไอคอนตามหลักเกณฑ์เกี่ยวกับไฟล์ ZIP สำหรับสถิติ
- เลือกเกมใน Google Play Console
- ในหน้าบริการเกมของ Play - สถิติเกม (เพิ่มผู้ใช้ > บริการเกมของ Play > การตั้งค่าและการจัดการ > สถิติเกม) ให้เลือกเพิ่มสถิติ > นำเข้าผ่าน ZIP
- ในหน้าการกำหนดค่าสถิติเกม ให้วางไฟล์ ZIP เพื่ออัปโหลด
- หลังจากอัปโหลดสถิติทั้งหมดแล้ว ให้เผยแพร่เกม
ทดสอบสถิติเกม
หากต้องการยืนยันว่าสถิติเกมทำงานตามที่ต้องการ ให้ทำตามขั้นตอนต่อไปนี้เพื่อทดสอบ
- เปิดแอป Google Play Store
- ลงชื่อเข้าใช้โปรไฟล์ Play Games ในแอป Google Play Store
- ดูสถิติเกมในโปรไฟล์เกมเมอร์
ดูบันทึกในอุปกรณ์
หากต้องการยืนยันว่าสถิติเกมทำงานตามที่ออกแบบไว้ ให้เปิดบันทึกในอุปกรณ์โดยทำดังนี้
เปิดใช้การแก้ไขข้อบกพร่อง 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 - สถิติเกม (เพิ่มผู้ใช้ > บริการเกมของ Play > การตั้งค่าและการจัดการ > สถิติเกม) ให้คลิกตรวจสอบและเผยแพร่
- ในหน้าบริการเกมของ Play - การเผยแพร่ (เพิ่มผู้ใช้ > บริการเกมของ Play > การตั้งค่าและการจัดการ > การเผยแพร่) ให้ตรวจสอบการดำเนินการและแก้ไขปัญหา
- คลิกเผยแพร่ ระบบจะเผยแพร่สถิติเกมทั้งหมดของคุณ
แก้ไขสถิติเกม
หากคุณมีสถิติเกมอยู่แล้วและต้องการแก้ไข ให้ทำดังนี้
- เลือกเกมใน Google Play Console
- ไปที่หน้าบริการเกมของ Play - สถิติเกม (เพิ่มผู้ใช้ > บริการเกมของ Play > การตั้งค่าและการจัดการ > สถิติเกม)
- วิธีแก้ไขกิจกรรม
- เลือกเหตุการณ์ในส่วนการกําหนดค่าเหตุการณ์
- คุณเพิ่มหรือลบพร็อพเพอร์ตี้เหตุการณ์ได้
- คุณแก้ไขชื่อเหตุการณ์ไม่ได้
- คลิกบันทึกการเปลี่ยนแปลง
- วิธีแก้ไขสถิติ
- ในส่วนการกำหนดค่าสถิติเกม ให้เลือกสถิติ
- คุณแก้ไขช่องชื่อสถิติ คำอธิบายสถิติ และชื่อไฟล์ไอคอนได้
- คุณไม่สามารถแก้ไขรหัสสถิติและทิศทางความคืบหน้าได้ หน่วยสถิติ และรายละเอียดเหตุการณ์ที่เกี่ยวข้อง
- คลิกบันทึกการเปลี่ยนแปลง
- ในหน้าบริการเกมของ Play - สถิติเกม สถิติที่แก้ไขจะอยู่ในสถานะพร้อมใช้งานสำหรับผู้ทดสอบ
- หลังจากทดสอบสถิติแล้ว ให้คลิกตรวจสอบและเผยแพร่ ซึ่งจะเป็นการเผยแพร่เกมของคุณอีกครั้งพร้อมกับสถิติทั้งหมดที่อัปเดตแล้ว
ลบสถิติเกม
หลังจากเผยแพร่สถิติเกมแล้ว คุณจะลบสถิติเกมไม่ได้
คุณสามารถลบกิจกรรมหรือสถิติในสถานะพร้อมใช้งานสำหรับผู้ทดสอบได้
- เลือกเกมใน Google Play Console
- ไปที่หน้าบริการเกมของ Play - สถิติเกม (เพิ่มผู้ใช้ > บริการเกมของ Play > การตั้งค่าและการจัดการ > สถิติเกม)
- วิธีลบกิจกรรม
- เลือกเหตุการณ์ในส่วนการกําหนดค่าเหตุการณ์
- คลิกลบกิจกรรม
- วิธีลบสถิติ
- ในการกำหนดค่าสถิติเกม ให้เลือกสถิติที่ต้องการลบ
- คลิกลบสถิติเกม
หลักเกณฑ์เกี่ยวกับไฟล์ CSV สําหรับเหตุการณ์
แถวแรกของไฟล์ CSV คือแถวส่วนหัว คุณต้องนำเข้ากิจกรรมโดยใช้ไฟล์ CSV ของกิจกรรม เช่น PlayerGameEvent.csv
รูปแบบของไฟล์ PlayerGameEvent.csv
CSV มีเหตุการณ์ที่ประกาศและพร็อพเพอร์ตี้เป็นค่าที่คั่นด้วยคอมมาตามลำดับต่อไปนี้
Event Name,Property Name,Property Type
หากคุณส่งเหตุการณ์ progressUpdate สำหรับ progressionStat ให้เพิ่มแถวสำหรับเหตุการณ์นี้ เหตุการณ์นี้ต้องมีพร็อพเพอร์ตี้ currentProgress อย่างน้อย 1 รายการซึ่งเป็นประเภท INT หรือ STRING รวมถึงพร็อพเพอร์ตี้อื่นๆ ที่คุณต้องการส่ง
ช่องเหล่านี้มีคำอธิบายในตารางต่อไปนี้
| ส่วนหัวคอลัมน์ CSV | จำเป็นหรือไม่บังคับ | ค่าที่ยอมรับ |
|---|---|---|
| ชื่อเหตุการณ์ | ต้องระบุ | สูงสุด 50 อักขระ ต้องประกอบด้วยตัวอักษร ตัวเลข และขีดล่างเท่านั้น หากใช้ชื่อกิจกรรมพิเศษ |
| ชื่อพร็อพเพอร์ตี้ | ต้องระบุ | สูงสุด 50 อักขระ ต้องประกอบด้วยตัวอักษร ตัวเลข และขีดล่างเท่านั้น ไม่ซ้ำกันต่อเหตุการณ์: ชื่อพร็อพเพอร์ตี้ต้องไม่ซ้ำกันภายในเหตุการณ์เดียวกัน อย่าใช้คีย์เวิร์ดที่สงวนไว้ต่อไปนี้ |
| ประเภทของอสังหาริมทรัพย์ | ต้องระบุ | สตริง enum ที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ซึ่งตรงกับประเภทข้อมูลที่รองรับประเภทใดประเภทหนึ่งต่อไปนี้
INT64, DOUBLE, STRING, BOOL
|
ข้อกำหนดของไฟล์ PlayerGameEvent.csv มีดังนี้
- ไฟล์รองรับชื่อเหตุการณ์ที่ไม่ซ้ำกันได้สูงสุด 20 ชื่อ โดยมีพร็อพเพอร์ตี้สูงสุด 20 รายการต่อเหตุการณ์
- เนื้อหาไฟล์ต้องไม่ว่างเปล่าและต้องมีอย่างน้อย 1 แถว
ตารางตัวอย่าง
| ชื่อเหตุการณ์ | ชื่อพร็อพเพอร์ตี้ | ประเภทของอสังหาริมทรัพย์ |
|---|---|---|
| matchCompleted | ระยะเวลา | DOUBLE |
| matchCompleted | ฆ่า | INT64 |
| matchCompleted | isWinner | BOOL |
| matchCompleted | matchType | STRING |
| itemCollected | coinsAmount | INT64 |
| itemCollected | weaponType | สตริง |
| progressUpdate | currentProgress | INT64 |
หลักเกณฑ์เกี่ยวกับไฟล์ ZIP สำหรับสถิติ
คุณสามารถนำเข้าสถิติหลายรายการพร้อมกันได้โดยใช้ไฟล์ ZIP ดูชื่อไฟล์ที่แน่นอนที่จะใช้ในไฟล์ ZIP ได้จากตารางต่อไปนี้
| ชื่อไฟล์ | จำเป็นหรือไม่บังคับ | ค่าที่ยอมรับ |
|---|---|---|
RepetitiveStatsConfig.csv
|
ต้องระบุ | สถิติที่เกิดซ้ำแสดงถึงการกระทำในเกมที่เกิดขึ้นเป็นประจำซึ่งผู้เล่นทำ |
ProgressionStatConfig.csv
|
ต้องระบุ | สถิติความคืบหน้าแสดงถึงความคืบหน้าของผู้เล่นในเกม |
StatLocalizations.csv
|
ไม่บังคับ | ระบุคำแปลสำหรับชื่อและคำอธิบายของสถิติเกม |
| ไฟล์ไอคอน | ต้องระบุ | ไอคอนในรูปแบบ PNG, JPEG หรือ JPG ขนาด 512 x 512 |
ไฟล์ ZIP ต้องเป็นไปตามข้อกำหนดต่อไปนี้
- ขีดจำกัดขนาดไฟล์ ZIP: ขนาดรวมสูงสุดที่ไม่มีการบีบอัดคือ 10 MB
- จำนวนไฟล์สูงสุด: ไฟล์ทั้งหมดในไฟล์เก็บถาวรแบบ ZIP ต้องมีไม่เกิน 53 ไฟล์ (CSV 3 ไฟล์และไอคอน 50 รายการ)
- ขีดจำกัดสถิติรวมสูงสุด: สถิติทั้งหมดสูงสุด 50 รายการใน
ProgressionStatConfig.csvและRepetitiveStatsConfig.csv - ไฟล์ CSV ที่รองรับ:
ProgressionStatConfig.csv,RepetitiveStatsConfig.csvและStatLocalizations.csv(ไม่บังคับ) หากต้องการอัปโหลดเฉพาะสถิติความคืบหน้า อย่าใส่ไฟล์ CSV ของสถิติแบบซ้ำๆ ไว้ในไฟล์ ZIP ไม่เช่นนั้นคอนโซลจะแสดงข้อผิดพลาด เช่นเดียวกัน หากคุณต้องการอัปโหลดเฉพาะสถิติที่ซ้ำกัน - ไฟล์รูปภาพไอคอน: PNG (.png) หรือ JPEG (.jpg, .jpeg)
- ไอคอนทั้งหมดที่อ้างอิงใน CSV ต้องอยู่ในรูทของไฟล์ ZIP
- ไฟล์ภาพทั้งหมดที่อยู่ใน ZIP ต้องมีการอ้างอิงโดยสถิติอย่างน้อย 1 รายการ
- โครงสร้างไดเรกทอรี: ไฟล์ทั้งหมดต้องอยู่ที่รูทของไฟล์ 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
|
| มีการแข่งขัน | ต้องระบุ | true, false
|
| ขีดจำกัดต่ำสุด | ต้องระบุเมื่อ "มีการแข่งขัน" เป็น "จริง" | คะแนนต่ำสุดที่อนุญาตสำหรับสถิติการแข่งขัน |
| ขีดจำกัดสูงสุด | ต้องระบุเมื่อ "มีการแข่งขัน" เป็น "จริง" | คะแนนสูงสุดที่อนุญาตสำหรับสถิติการแข่งขัน |
| ชื่อไฟล์ไอคอน | ต้องระบุ | ชื่อไฟล์ของรูปภาพไอคอนที่รวมอยู่ในรูทของไฟล์ ZIP ต้องไม่ขัดแย้งกับชื่อไฟล์ไอคอนที่ใช้ในสถิติซ้ำๆ |
| ทิศทางของมูลค่าที่ดี | ต้องระบุ | ระบุว่าค่าที่สูงกว่า INCREASING หรือค่าที่ต่ำกว่า DECREASING ดีกว่า
|
| หน่วย | ไม่บังคับ | หน่วยวัดสำหรับค่าตัวเลขหรือระยะเวลาดิบ เช่น KILOMETER, SECOND, PERCENTAGE, UNITLESS |
หากไม่ต้องการใช้เงื่อนไขตัวกรอง ให้ปล่อยเซลล์ว่างไว้
ตารางตัวอย่าง
| รหัสสถิติ | ชื่อเหตุการณ์ | ชื่อพร็อพเพอร์ตี้ | การรวม | ชื่อที่แสดงของสถิติ | คำอธิบายสถิติ | กรองพร็อพเพอร์ตี้ (ไม่บังคับ) | โอเปอเรเตอร์ตัวกรอง (ไม่บังคับ) | ค่าตัวกรอง (ไม่บังคับ) | มีการแข่งขัน | minLimit | maxLimit | ชื่อไฟล์ไอคอน | ทิศทางของมูลค่าที่ดี | หน่วย |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | matchCompleted | ระยะเวลา | MAX | การจับคู่ที่ตรงกันที่ยาวที่สุด | ซึ่งหมายถึงเวลาเอาชีวิตรอดของผู้เล่นในการแข่งขันใดๆ | isWinner | = | จริง | จริง | 0 | 50 | stat1.png | ลด | วินาที |
| 2 | matchCompleted | isWinner | COUNT | การแข่งขันที่ชนะ | ค่านี้แสดงจำนวนการแข่งขันที่ผู้เล่นชนะ | isWinner | = | จริง | จริง | 0 | 50 | stat3.png | เพิ่ม | |
| 3 | matchCompleted | ฆ่า | SUM | การสังหารในการแข่งขันแบบ 1 ต่อ 1 | จำนวนการสังหารในการแข่งขันแบบ 1 ต่อ 1 | matchType | = | "1-on-1" | เท็จ | stat4.png | เพิ่ม | |||
| 4 | itemCollected | coinsAmount | SUM | ทองคำที่เก็บได้ทั้งหมด | ผู้เล่นเก็บเหรียญขณะเล่นในการแข่งขัน | weaponType | = | "sword" | เท็จ | 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 ดีกว่า
|
| หน่วย | ไม่บังคับ | หน่วยวัดสำหรับค่าตัวเลขหรือระยะเวลาดิบ เช่น KILOMETER, SECOND, PERCENTAGE, UNITLESS |
ตารางตัวอย่าง
| รหัสสถิติ | Event Property Name | ชื่อที่แสดงของสถิติ | คำอธิบายสถิติ | Icon File Name | ทิศทางค่าที่ดี |
|---|---|---|---|---|---|
| 5 | currentProgress | ระดับ | ผู้เล่นจะสะสม XP โดยการเล่นแมตช์ต่างๆ และเลื่อนระดับ | 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) | คำอธิบายสถิติที่แปลแล้ว (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 | 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 MB (1,048,576 ไบต์) |
| ขนาด | 512 × 512 พิกเซลพอดี (ความกว้าง = 512, ความสูง = 512) |
| สัดส่วนภาพ | 1:1 เท่านั้น (สัดส่วนภาพสี่เหลี่ยมจัตุรัส) |
| รูปแบบที่อนุญาต | PNG (.png) และ JPEG (.jpg, .jpeg) |
| ตำแหน่งในไฟล์ ZIP | ต้องอยู่ในไดเรกทอรีรากในไฟล์ ZIP |
| การตรวจสอบที่อ้างอิง | ชื่อไฟล์ไอคอนทั้งหมดที่ระบุในคอลัมน์ชื่อไฟล์ไอคอนต้องมีอยู่ในไฟล์ ZIP |
| การตรวจสอบไฟล์ที่ไม่มีโฟลเดอร์หลัก | ไฟล์ภาพทั้งหมดใน ZIP ต้องมีการอ้างอิงโดยสถิติอย่างน้อย 1 รายการ |
| การตรวจสอบความขัดแย้ง | ชื่อไฟล์ไอคอนใน ProgressionStatConfig.csv ต้องไม่ขัดแย้งกับ RepetitiveStatsConfig.csv
|
| ภาพที่ซ้ำกัน | ระบบจะแจ้งว่าไอคอนที่ซ้ำกันเป็นปัญหา |
หลักเกณฑ์เกี่ยวกับไอคอน
ไอคอนควรสร้างเป็นไฟล์ PNG, JPEG หรือ JPG ขนาด 512 x 512 ที่มีพื้นหลังโปร่งใส
ระบบจะใช้ไอคอนเดียวกันในทุกภาษา เราจึงขอแนะนำให้คุณไม่ใส่ข้อความหรือเนื้อหาที่แปลแล้วไว้ในไอคอน
ข้อมูลจำเพาะของหน่วย
คอลัมน์หน่วยจะควบคุมวิธีจัดรูปแบบค่าสถิติดิบและแปลเป็นภาษาท้องถิ่นสำหรับผู้เล่น
พร็อพเพอร์ตี้สถิติที่เป็นตัวเลข (INT64, DOUBLE)
| ค่าหน่วยที่อนุญาต | ค่าดิบตัวอย่าง |
| (ว่างเปล่า) / ไม่มีหน่วย / ไม่มี | 1234567 |
| % / PERCENTAGE / PERCENT | 0.857 |
| ระยะทาง/ความยาว: CENTIMETER, METER, KILOMETER, FOOT, INCH, MILE, YARD, MILLIMETER, NANOMETER | 15 (กิโลเมตร) |
| ความเร็ว: KILOMETER_PER_HOUR, METER_PER_SECOND, MILE_PER_HOUR | 60 (MILE_PER_HOUR) |
พร็อพเพอร์ตี้สถิติระยะเวลา (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 | 90,000 วินาที | 1 วัน 1 ชม. |
พร็อพเพอร์ตี้สถิติที่ไม่ใช่ตัวเลข (STRING, BOOL)
ต้องเว้นคอลัมน์หน่วยให้ว่างไว้