ความสำเร็จและกระดานผู้นำ

กระดานผู้นำ

สร้างกระดานผู้นำ

ส่วนนี้จะอธิบายวิธีสร้างกระดานผู้นำสำหรับเกมใหม่หรือเกมที่มีอยู่แล้ว สามารถสร้างได้สูงสุด 20 กระดาน โดยแต่ละรายการต้องมี ID ไม่ซ้ำกันในเกมเดียวกัน

หากต้องการสร้างกระดานผู้นำสำหรับเกม ให้เข้าไปที่หน้าจัดการ GameRank ของเกมที่ตรงกัน เลือก ขยาย > Add แล้วคลิกปุ่ม สร้างกระดานผู้นำ

จากนั้นกรอกข้อมูลที่ต้องการของกระดานผู้นำ

รูปแบบคะแนน

• กระดานผู้นำตัวเลข แสดงคะแนนในรูปแบบตัวเลข สามารถเป็นจำนวนเต็มหรือทศนิยม เช่น 3.14159, 3141.59 หรือ 314159 โปรดระวังว่าค่าไม่ควรมากเกินไป ขณะนี้รองรับเพียง single-precision

• กระดานผู้นำเวลา แสดงคะแนนในรูปแบบ ชั่วโมง / นาที / วินาที / ร้อยละวินาที หรือรูปแบบนาฬิกาดั้งเดิม (HH:MM:SS) เช่น 66032, 1:06:3

• คะแนนรูปแบบพิเศษ แสดงคะแนนตามรูปแบบที่กำหนดเอง ส่งคะแนนในรูปแบบสกุลเงิน เช่น $19.95

คำแนะนำภาพพื้นหลัง

ภาพพื้นหลังของกระดานผู้นำควรเป็นไฟล์ JPEG ขนาด 1024 × 1024 เป็นทางเลือก หากไม่ได้อัปโหลดจะใช้ภาพเริ่มต้นของแพลตฟอร์ม
ภาพพื้นหลังเดียวกันจะใช้กับทุกภูมิภาคภาษา ขอแนะนำให้หลีกเลี่ยงการใส่ข้อความหรือเนื้อหาที่ปรับให้เข้ากับแต่ละท้องถิ่น

ปรับแต่งกระดานผู้นำ

สำหรับรายการกระดาน นักพัฒนาสามารถจัดการผู้เล่นที่ผิดปกติได้:

• ลบ: ลบข้อมูลของผู้เล่นที่แสดงในกระดาน
• เพิ่มในบัญชีดำ: ยกเลิกสิทธิ์ผู้เล่นในการเข้าร่วมกระดานผู้นำทั้งหมดของเกมนี้ในอนาคต
  หลังจากเพิ่มในบัญชีดำแล้ว สามารถดูและลบผู้เล่นออกจากบัญชีดำได้ภายใต้กระดานทั้งหมด
• แก้ไขข้อมูล: คลิกเพื่อเปิดหน้าแก้ไขกระดานผู้นำ
• ลบกระดาน: คลิกเพื่อลบกระดานผู้นำที่ระบุ

ฟิลด์ส่งข้อมูลกระดานผู้นำ

หากข้อมูลในเกมของผู้เล่นเข้าข่ายตามกระดานที่กำหนด สามารถเรียก API เพื่อส่งข้อมูลไปยังบริการ backend Jogos ผู้เล่นจะสามารถเปิดหน้าต่างกระดานผู้นำบนแพลตฟอร์ม Jogos เพื่อดูกระดานและอันดับของตน

หมายเหตุ: ชื่อกระดานและประเภทข้อมูลในพารามิเตอร์ API ต้องตรงกับที่กำหนดไว้ใน Developer Center

Developer Center สามารถสร้างประเภทข้อมูลที่จะส่งได้ 3 ประเภท:

• คะแนนตัวเลข: number
• คะแนนเวลา: time
• คะแนนรูปแบบ: กำหนดเอง

ข้อมูลที่ส่งเป็นรูปแบบ key-value โดยค่าสามารถเป็นตัวเลข สตริง หรือวันที่เท่านั้น และต้องตรงกับรูปแบบที่กำหนดใน Developer Center

API ส่งข้อมูลกระดานผู้นำ

API ส่งข้อมูลกระดานผู้นำ: JOGOS_SDK.game.commitRankingData

/**
 * ส่งข้อมูลกระดานผู้นำ
 *
 * @param rankingName รหัสกระดานผู้นำ
 * @param data ข้อมูลกระดานผู้นำ
 */
await window.JOGOS_SDK.game.commitRankingData(rankingName: string, data: { [key: string]: any });

API เปิดหน้าต่างกระดานผู้นำ:

API เปิดหน้าต่างกระดานผู้นำ: JOGOS_SDK.game.openRankingDialog
หากต้องการแสดงกระดานเฉพาะ (แทนที่จะแสดงทั้งหมด) สามารถส่งชื่อกระดาน (ตรงกับชื่อที่สร้างใน Developer Center) ไปยังเมท็อดนี้ได้

/**
 * เปิดหน้าต่างกระดานผู้นำ
 *
 * @param rankingName ชื่อกระดานผู้นำ
 */
await window.JOGOS_SDK.game.openRankingDialog(rankingName: string);

การเชื่อมต่อความสำเร็จ

เมื่อผู้เล่นบรรลุความสำเร็จใด สามารถเรียก API ส่งข้อมูลเพื่อส่งข้อมูลไปยังบริการ backend Jogos ผู้เล่นจะสามารถเปิดหน้าต่างความสำเร็จบนแพลตฟอร์ม Jogos เพื่อดูความสำเร็จที่บรรลุแล้ว

หมายเหตุ: ชื่อความสำเร็จในพารามิเตอร์ API ต้องตรงกับชื่อที่กำหนดใน Developer Center

กรณีความสำเร็จไม่แบ่งขั้นตอน:

• ส่งเฉพาะเมื่อบรรลุความสำเร็จนั้น คือไม่มีการแสดงความคืบหน้า การส่งแปลว่าบรรลุแล้ว
• หากตั้งค่าแบ่งขั้นตอน: ความคืบหน้า progress ต้องส่งตรงกับ ID ของขั้นตอน เช่น เมื่อจบขั้นตอนที่ 2 ให้ส่ง progress = 2

สร้างความสำเร็จ

ใน Developer Center ที่บริการ GameService - หน้าความสำเร็จ เลือกสร้างความสำเร็จ
ที่หน้าเพิ่มความสำเร็จ กรอกแบบฟอร์ม

ความสำเร็จแต่ละรายการมีองค์ประกอบพื้นฐานดังนี้:

• ID ความสำเร็จ: ตัวอักษรและตัวเลข ใช้จับคู่กับการรายงานในเกมและการแสดงผล ต้องไม่ซ้ำในเกมเดียวกัน
• ชื่อ: ชื่อที่แสดงของความสำเร็จ (เช่น "Pieman")
• เงื่อนไขความสำเร็จ: คำอธิบายเงื่อนไข โดยปกติจะบอกผู้เล่นวิธีบรรลุ
• ไอคอน: ไอคอนรูปสี่เหลี่ยมที่เชื่อมโยงกับความสำเร็จ ต้องอัปโหลดภาพทั้งสถานะล็อกและปลดล็อก
• ประเภทความสำเร็จ (เลือกหนึ่งรายการ แสดงแยกตามลำดับ):
  • ความสำเร็จการสำรวจระดับเริ่มต้น (Beginner's Exploration Achievements) สร้างได้ 900 รายการ
  • ความสำเร็จการท้าทายระดับกลาง (Intermediate Challenge Achievements) สร้างได้ 50 รายการ
  • ความสำเร็จเกียรติยศระดับสูง (Advanced Glory Achievements) สร้างได้ 10 รายการ

สถานะ: ความสำเร็จสามารถอยู่ในหนึ่งในสามสถานะต่อไปนี้:

• ความสำเร็จที่ซ่อน: รายละเอียดจะถูกซ่อนจากผู้เล่น Jogos จะให้คำอธิบายและไอคอนเริ่มต้น ควรตั้งค่านี้หากมีสปอยล์
• ความสำเร็จที่เปิดเผยแล้ว: ผู้เล่นรู้จักความสำเร็จแต่ยังไม่บรรลุ ความสำเร็จส่วนใหญ่เริ่มต้นที่นี่
• ความสำเร็จที่บรรลุแล้ว: ผู้เล่นบรรลุสำเร็จ สามารถบรรลุแบบออฟไลน์และซิงค์เมื่อออนไลน์

ความสำเร็จแบบแบ่งขั้นตอน

• สามารถตั้งค่าเป็นแบบมาตรฐานหรือแบ่งขั้นตอน
  แบบขั้นตอนต้องใช้เวลา ส่งความคืบหน้าปัจจุบันให้ Jogos ระบบจะติดตามและแจ้งเมื่อบรรลุ

คำแนะนำไอคอน

ไอคอนต้องเป็นไฟล์ PNG, JPEG หรือ JPG ขนาด 512 × 512
เพียงส่งไอคอน ที่ปลดล็อกแล้ว แนะนำให้ใช้สีเพื่อแยกแยะ
ใช้ไอคอนเดียวกันทุกภาษา—หลีกเลี่ยงข้อความหรือเนื้อหาที่ปรับตามท้องถิ่น

API ส่งความสำเร็จ

/**
 * ส่งข้อมูลความสำเร็จของผู้เล่น
 *
 * @param name ID ความสำเร็จ
 * @param progress ความคืบหน้า
 * @param hidden ตัวบ่งชี้ซ่อน
 */
await window.JOGOS_SDK.game.commitAchievementsData(name: string, progress: number, hidden: boolean);

API เปิดหน้าต่างความสำเร็จ

แพลตฟอร์ม Jogos มีหน้าต่างความสำเร็จให้ผู้เล่น สามารถเรียก API ในเกมเพื่อเปิดได้

// เปิดหน้าต่างความสำเร็จของผู้เล่น
await window.JOGOS_SDK.game.openAchievementsDialog();