ลีดเดอร์บอร์ดเป็นวิธีสนุกๆ ในการกระตุ้นการแข่งขันในหมู่ผู้เล่น ทั้งสำหรับแฟนๆ ที่ชื่นชอบเกมของคุณมากที่สุด (ซึ่งจะแย่งชิงตำแหน่งสูงสุดในลีดเดอร์บอร์ดสาธารณะ) และผู้เล่นทั่วไป (ซึ่งสนใจที่จะเปรียบเทียบความคืบหน้าของตนเองกับเพื่อนๆ)
ดูวิธีติดตั้งใช้งานตารางอันดับสำหรับแพลตฟอร์มได้ที่การติดตั้งใช้งานสำหรับลูกค้า
ทำความเข้าใจลีดเดอร์บอร์ด
เมื่อคุณสร้างตารางอันดับ บริการ Play Games จะจัดการแง่มุมส่วนใหญ่ของตารางอันดับนี้ให้คุณ กระบวนการทั่วไปจะทำงานดังนี้
- เมื่อจบเกม (หรือเมื่อถึงเวลาที่เหมาะเจาะที่คุณกำหนดไว้) เกมจะส่งคะแนนของผู้เล่นไปยังลีดเดอร์บอร์ดอย่างน้อย 1 รายการที่คุณสร้างขึ้นสำหรับเกม
- บริการ Play Games จะตรวจสอบว่าคะแนนนี้ดีกว่าคะแนนในตารางอันดับปัจจุบันของผู้เล่นสำหรับคะแนนรายวัน รายสัปดาห์ หรือตลอดกาลหรือไม่ หากใช่ บริการเกมของ Play จะอัปเดตลีดเดอร์บอร์ดที่เกี่ยวข้องด้วยคะแนนใหม่
- บริการเกมของ Play จะส่งรายงานคะแนนกลับไปให้ไคลเอ็นต์เกม รายงานนี้จะบอกลูกค้าว่านี่เป็นคะแนนสูงสุดใหม่รายวัน รายสัปดาห์ หรือตลอดกาล หากไม่ใช่ บริการ Play Games จะบอกไคลเอ็นต์ว่าคะแนนสูงสุดปัจจุบันรายวัน รายสัปดาห์ หรือตลอดกาลของผู้เล่นรายนี้คือเท่าใด
- หากต้องการเรียกข้อมูลผลการแข่งขันของผู้เล่นสำหรับตารางอันดับ คุณสามารถขอกรอบเวลา (รายวัน รายสัปดาห์ หรือตลอดกาล) และระบุได้ว่าผู้ใช้ต้องการดูตารางอันดับแบบโซเชียลหรือแบบสาธารณะหรือไม่ บริการ Play Games จะทำการกรองที่จำเป็นทั้งหมด จากนั้นส่งผลลัพธ์กลับไปยังไคลเอ็นต์
- ในกรณีที่มีคะแนนจำนวนมากที่จะรายงาน บริการ Play Games จะส่งกลับเฉพาะข้อมูลคะแนนในลีดเดอร์บอร์ดอันดับสูงสุดเท่านั้น นอกจากนี้ คุณยังดึงข้อมูลคะแนนดิบสำหรับคะแนนสูงสุดหรือคะแนนที่อยู่ติดกับคะแนนของผู้เล่นได้ด้วย
ลีดเดอร์บอร์ดหลายรายการ
เกมมีลีดเดอร์บอร์ดได้สูงสุด 70 รายการ ตัวอย่างเช่น เกมหลายระดับอาจมีลีดเดอร์บอร์ดแยกกันสำหรับแต่ละระดับ และเกมแข่งรถอาจมีลีดเดอร์บอร์ดแยกกันสำหรับแต่ละแทร็ก
กรอบเวลาของลีดเดอร์บอร์ด
Play Games SDK จะสร้างอันดับทุกเวอร์ชันที่คุณสร้างเป็นเวอร์ชันรายวัน รายสัปดาห์ และตลอดกาลโดยอัตโนมัติ คุณจึงไม่ต้องสร้างลีดเดอร์บอร์ดแยกกันสำหรับแต่ละกรอบเวลา
อันดับรายวันจะรีเซ็ตที่ UTC-7 (หรือ "เวลากลางคืนตามเวลาเขตแปซิฟิก") ตลอดทั้งปี
อันดับรายสัปดาห์จะรีเซ็ตตอนเที่ยงคืนระหว่างวันเสาร์และวันอาทิตย์ตามเขตเวลาเดียวกับอันดับรายวัน (UTC-7)
ลีดเดอร์บอร์ดสาธารณะและโซเชียล
Play Games SDK สามารถแสดงตารางอันดับแต่ละรายการใน 2 เวอร์ชันต่อผู้เล่น ดังนี้
ตารางอันดับโซเชียลคือตารางอันดับที่ประกอบด้วยผู้คนในกลุ่มของผู้ใช้ (หรือสมาชิกในกลุ่มที่ผู้ใช้เลือกแชร์กับแอปพลิเคชันของคุณ) ซึ่งตัดสินใจแชร์กิจกรรมเล่นเกมกับผู้ใช้
ลีดเดอร์บอร์ดสาธารณะคือลีดเดอร์บอร์ดที่มีผู้เล่นที่เลือกแชร์กิจกรรมการเล่นแบบสาธารณะ หากผู้เล่นไม่ได้เลือกแชร์กิจกรรมในเกมแบบสาธารณะ ผู้เล่นรายนั้นจะไม่ปรากฏในตารางอันดับนี้
แสดงลีดเดอร์บอร์ด
ในไลบรารีไคลเอ็นต์อุปกรณ์เคลื่อนที่ ไลบรารีจะจัดการการจัดรูปแบบและการแสดงตารางอันดับทั้งหมด คุณสามารถระบุได้ว่าจะให้ผู้เล่นเห็นลีดเดอร์บอร์ดเฉพาะหรือดูรายการลีดเดอร์บอร์ดทั้งหมดที่คุณเลือกได้
นอกจากนี้ คุณยังใช้ตารางอันดับเวอร์ชันของคุณเองได้โดยเข้าถึงข้อมูลจากคลังไคลเอ็นต์โดยตรง
แอตทริบิวต์
หากต้องการสร้างและจัดการลีดเดอร์บอร์ด คุณควรทำความคุ้นเคยกับแอตทริบิวต์ลีดเดอร์บอร์ดต่อไปนี้
ข้อมูลเบื้องต้น
องค์ประกอบพื้นฐานเหล่านี้เชื่อมโยงกับตารางอันดับทุกตาราง
- รหัสคือสตริงที่ไม่ซ้ำกันซึ่ง Google Play Console จะสร้างขึ้นให้คุณ คุณจะใช้รหัสที่ไม่ซ้ำกันนี้เพื่ออ้างอิงลีดเดอร์บอร์ดในไคลเอ็นต์เกม
- ชื่อคือชื่อย่อของตารางอันดับ (เช่น "คะแนนสูงสุด" หรือ "ระดับ 3") โดยชื่อมีความยาวได้สูงสุด 100 อักขระ
- ไอคอนคือไอคอนสี่เหลี่ยมจัตุรัสที่จะเชื่อมโยงกับตารางอันดับ ดูแนวทางปฏิบัติแนะนำเมื่อสร้างไอคอนตารางอันดับได้ที่หลักเกณฑ์ไอคอน
- ลําดับรายการคือลําดับที่ลีดเดอร์บอร์ดจะปรากฏเมื่อผู้เล่นดูลีดเดอร์บอร์ดที่เชื่อมโยงกับเกมของคุณ
- ขีดจำกัดคือค่าที่ไม่บังคับซึ่งกำหนดขีดจำกัดล่างและบนของคะแนนที่อนุญาตในลีดเดอร์บอร์ด วิธีนี้จะช่วยให้คุณทิ้งการส่งคะแนนที่เป็นการฉ้อโกงอย่างชัดเจนได้ นอกจากนี้ คุณยังใช้
Players.hideเพื่อซ่อนผู้เล่นที่คุณเชื่อว่าส่งคะแนนที่เป็นการฉ้อโกงจากลีดเดอร์บอร์ดทั้งหมดในแอปได้ด้วย
ลีดเดอร์บอร์ดตามลำดับ
ตารางอันดับอาจมีการจัดเรียงได้ 2 ประเภทดังนี้
- ตารางสรุปสถิติยิ่งมากยิ่งดีจะเป็นค่าเริ่มต้น โดยปกติแล้ว คุณจะเห็นสิ่งนี้ในเกมส่วนใหญ่ที่ผู้เล่นจะได้รับคะแนน
- บางครั้งระบบจะใช้ตารางอันดับยิ่งน้อยยิ่งดีในกรณีที่คะแนนที่น้อยลงจะดีกว่า ตัวอย่างที่พบบ่อยที่สุดของลีดเดอร์บอร์ดประเภทนี้คือในเกมแข่งรถ ซึ่งคะแนนแสดงถึงเวลาที่ผู้เล่นใช้ในการจบการแข่งขัน
การจัดรูปแบบคะแนน
แม้ว่าระบบจะส่งคะแนนทั้งหมดไปยังลีดเดอร์บอร์ดและจัดเก็บภายในเป็นจำนวนเต็มแบบยาว แต่บริการเกมของ Play สามารถแสดงคะแนนต่อผู้ใช้ในรูปแบบต่างๆ ได้ดังนี้
ลีดเดอร์บอร์ดตัวเลขจะแสดงคะแนนเป็นตัวเลข ซึ่งจะแสดงเป็นจำนวนเต็มหรือจำนวนจริงที่มีจำนวนตำแหน่งทศนิยมคงที่ก็ได้ คุณส่งคะแนนเป็นจำนวนเต็มและระบบจะแทรกจุดทศนิยมในตำแหน่งที่ระบุ เช่น คะแนน
314159จะแสดงเป็น3.14159,3141.59หรือ314159โดยขึ้นอยู่กับตำแหน่งทศนิยมที่คุณระบุตารางสรุปสถิติเวลาจะแสดงคะแนนในรูปแบบชั่วโมง / นาที / วินาที / เศษเสี้ยวของวินาที คุณต้องส่งคะแนนเป็นมิลลิวินาที ดังนั้นระบบจะตีความ
66032เป็น1:06.03ลีดเดอร์บอร์ดสกุลเงินจะแสดงคะแนนในรูปแบบสกุลเงิน คุณส่งคะแนนเป็น 1/1,000,000 ของหน่วยสกุลเงินหลัก ตัวอย่างเช่น ระบบจะตีความคะแนน 19,950,000 เป็น
$19.95ในกรณีที่คุณระบุสกุลเงินเป็น USD
ตารางอันดับตัวเลขยังรองรับหน่วยที่กำหนดเองด้วย เช่น หากเกมของคุณวัดคะแนนสูงสุดเป็นเมตร คุณสามารถระบุ "เมตร" เป็นหน่วยเริ่มต้นสำหรับลีดเดอร์บอร์ดได้
คำแปลและการจัดรูปแบบคะแนน
เมื่อคลังไคลเอ็นต์เวอร์ชันอุปกรณ์เคลื่อนที่ขอข้อมูลตารางอันดับจากบริการ Play Games คลังจะระบุภาษาและภาษาท้องถิ่นที่จะแสดงคะแนนเหล่านี้ REST API ให้คุณระบุภาษาตามภาษาท้องถิ่นได้ด้วย บริการเกมของ Play จะแสดงคะแนนในตารางอันดับที่ฟอร์แมตแล้วซึ่งเหมาะกับภาษาและสถานที่นั้นๆ คะแนนที่จัดรูปแบบเหล่านี้จะปรากฏขึ้นไม่ว่าคุณจะเพิ่มคำแปลสำหรับตารางสรุปสถิติหรือไม่ก็ตาม
สำหรับตารางอันดับตัวเลข รูปแบบตัวเลขจะแสดงแตกต่างกันไปตามภาษา (เช่น 12,345.78 ในสหรัฐอเมริกา และ 12 345,78 ในฝรั่งเศส) หากใช้หน่วยที่กำหนดเองและเพิ่มคำแปลลงในเกม คุณต้องระบุหน่วยที่แปลแล้วสำหรับทุกภาษาที่เพิ่ม จากนั้นบริการจะแสดงหน่วยที่แปลแล้วเหล่านี้ตามความเหมาะสม
คุณอาจต้องระบุชื่อหน่วยเป็นเวอร์ชันต่างๆ ทั้งนี้ขึ้นอยู่กับภาษาที่เลือก สำหรับภาษาอังกฤษ คุณจะต้องมีเวอร์ชันสำหรับรายการหนึ่งและอีกเวอร์ชันสำหรับรายการอื่นๆ (เช่น "เมตร" และ "เมตร") ในทางตรงกันข้าม ในภาษาโปแลนด์ คุณจะต้องระบุเวอร์ชันสำหรับ 1 หน่วย 2-3 หน่วย หลายหน่วย และอื่นๆ ดูข้อมูลเพิ่มเติมเกี่ยวกับกฎพหูพจน์ได้ที่จํานวน สตริง(พหูพจน์)
สำหรับตารางอันดับเวลา รูปแบบเวลาจะแสดงตามภาษาและภาษาท้องถิ่นของผู้เล่น ปัญหานี้จะสังเกตเห็นได้ชัดเจนเมื่อคุณใช้เศษเสี้ยวของวินาทีหรือมีค่าชั่วโมงมากกว่า 3 หลัก (เช่น 4,815:16:23.42 ในสหรัฐอเมริกาและ 4.815:16:23,42 ในเยอรมนี)
สำหรับตารางอันดับสกุลเงิน รูปแบบสกุลเงินจะแสดงตามภาษาและภาษาท้องถิ่นของผู้เล่น แต่คุณเปลี่ยนหน่วยสกุลเงินไม่ได้ เช่น หากคุณระบุสกุลเงินเป็น USD เกมจะแสดงเป็น $19.95 ในสหรัฐอเมริกาและ 19,95 $ ในฝรั่งเศส แต่คุณไม่สามารถระบุว่าเกมของคุณแสดงราคาเป็นดอลลาร์ในสหรัฐอเมริกาและยูโรในฝรั่งเศส
หลักเกณฑ์เกี่ยวกับไอคอน
ไอคอนควรสร้างเป็นไฟล์ PNG หรือ JPEG ขนาด 512 x 512 ไอคอนของคุณจะได้รับการลดขนาดในโปรแกรมเล่นเกมส่วนใหญ่ คุณจึงควรหลีกเลี่ยงการสร้างไอคอนที่มีรายละเอียดมากเกินไป คุณส่งไอคอนที่มีแชแนลอัลฟ่าได้ และระบบจะเก็บรักษาความโปร่งใสไว้ ไอคอนลีดเดอร์บอร์ดจะแสดงบนพื้นหลังสีเทาเข้มในอุปกรณ์ Android ดังนั้นให้เลือกไอคอนที่ใช้งานได้ดีในกรณีนี้
ระบบจะใช้ไอคอนเดียวกันในทุกภาษา เราจึงขอแนะนำไม่ให้ใส่ข้อความหรือเนื้อหาที่แปลแล้วในไอคอน
สร้างลีดเดอร์บอร์ด
ส่วนนี้จะอธิบายวิธีสร้างลีดเดอร์บอร์ดสำหรับเกมใหม่หรือเกมที่มีอยู่
สร้างลีดเดอร์บอร์ดสำหรับเกมใหม่
หากต้องการสร้างลีดเดอร์บอร์ดสำหรับเกมใหม่และเกมที่ยังไม่ได้เผยแพร่ ให้ไปที่รายการ Google Play Console สำหรับเกมของคุณ แล้วไปที่เติบโต > บริการเกมของ Play > การตั้งค่าและการจัดการ > ลีดเดอร์บอร์ด จากนั้นคลิกปุ่มสร้างลีดเดอร์บอร์ด
จากนั้นกรอกข้อมูลที่จำเป็นสำหรับตารางอันดับนี้
คลิกบันทึกเป็นฉบับร่าง แล้วตารางอันดับจะแสดงในสถานะ "ฉบับร่าง" เมื่อเผยแพร่เกมแล้ว ลีดเดอร์บอร์ดทั้งหมดของเกมจะเผยแพร่ไปพร้อมกับเกม
สร้างลีดเดอร์บอร์ดสำหรับเกมที่เผยแพร่แล้ว
หากต้องการสร้างตารางอันดับเพิ่มเติมสำหรับเกมที่เผยแพร่ไปแล้ว ให้ทำตามขั้นตอนด้านบน ดูข้อมูลเพิ่มเติมเกี่ยวกับการทดสอบเกมเวอร์ชันอัปเดตได้ที่การเปลี่ยนแปลงเกี่ยวกับการเผยแพร่เกม
เมื่อทดสอบลีดเดอร์บอร์ดแล้วและพอใจกับผลลัพธ์ คุณสามารถเผยแพร่เกมอีกครั้งโดยใช้ลีดเดอร์บอร์ดใหม่ได้ จากนั้นระบบจะเผยแพร่ลีดเดอร์บอร์ดดังกล่าวให้ผู้ใช้ทั่วโลก
แก้ไขลีดเดอร์บอร์ด
หากต้องการแก้ไขลีดเดอร์บอร์ดที่สร้างไว้แล้ว ให้คลิกลีดเดอร์บอร์ดในแท็บลีดเดอร์บอร์ดของ Google Play Console ณ จุดนี้ คุณจะเห็นแบบฟอร์มเดียวกับที่ใช้เมื่อสร้างตารางอันดับเป็นครั้งแรก และสามารถแก้ไขช่องใดก็ได้ตามต้องการ
เมื่อแก้ไขตารางสรุปสถิติเสร็จแล้ว ให้คลิกปุ่มบันทึกเป็นฉบับร่าง ตารางอันดับที่แก้ไขใหม่จะอยู่ในสถานะ "ฉบับร่าง" ซึ่งจะช่วยให้คุณทดสอบได้
หากทำงานได้อย่างถูกต้อง ให้เลือกเผยแพร่การเปลี่ยนแปลงจากช่องที่ด้านบนของแบบฟอร์มตารางอันดับ แล้วคุณจะเผยแพร่เกมอีกครั้งพร้อมกับตารางอันดับที่อัปเดตแล้วทั้งหมดต่อสาธารณะได้
เลิกทำการแก้ไข
หากตัดสินใจว่าไม่ชอบตารางอันดับที่แก้ไขใหม่และต้องการกลับไปใช้เวอร์ชันก่อนหน้า เพียงเลือกเปลี่ยนกลับจากช่องที่ด้านบนของแบบฟอร์มตารางอันดับ อันดับจะเปลี่ยนกลับไปเป็นเวอร์ชันที่เผยแพร่แล้ว
ลบลีดเดอร์บอร์ด
คุณสามารถลบลีดเดอร์บอร์ดที่อยู่ในสถานะ "ฉบับร่าง" หรือที่เผยแพร่แล้วได้ หากต้องการลบลีดเดอร์บอร์ดใน Google Play Console ให้ไปที่แบบฟอร์มสำหรับลีดเดอร์บอร์ด แล้วคลิกลบลีดเดอร์บอร์ดที่ด้านบนของแบบฟอร์ม
หรือจะกด Players.hide เพื่อซ่อนตารางอันดับของผู้เล่นในแอปก็ได้
รีเซ็ตลีดเดอร์บอร์ด
คุณรีเซ็ตได้เฉพาะข้อมูลความคืบหน้าของผู้เล่นสำหรับลีดเดอร์บอร์ดฉบับร่าง
- หากต้องการรีเซ็ตลีดเดอร์บอร์ดใน Google Play Console ให้คลิกรีเซ็ตความคืบหน้าที่ด้านบนของแบบฟอร์มสำหรับกิจกรรมนั้น
- หากต้องการรีเซ็ตข้อมูลตารางอันดับแบบเป็นโปรแกรม ให้เรียกใช้เมธอด
ScoresManagement API
เพิ่มคำแปลสำหรับลีดเดอร์บอร์ด
คุณสามารถระบุคำแปลของคุณเองสำหรับลีดเดอร์บอร์ดที่เชื่อมโยงกับเกม ก่อนดำเนินการดังกล่าว โปรดทำตามขั้นตอนที่อธิบายไว้ในการเพิ่มคำแปลสำหรับเกม นอกจากนี้ คุณยังต้องสร้างลีดเดอร์บอร์ดอย่างน้อย 1 รายการสำหรับเกมด้วย
หากต้องการเพิ่มคำแปลของคุณเองสำหรับลีดเดอร์บอร์ด ให้เปิดแท็บลีดเดอร์บอร์ดสำหรับเกมของคุณใน Google Play Console แล้วเลือกลีดเดอร์บอร์ดที่มีอยู่ ในหน้ารายละเอียดของตารางอันดับ ให้คลิกแท็บภาษาที่คุณเพิ่มไว้ก่อนหน้านี้ในแท็บรายละเอียดเกม ในหน้ารายละเอียดของตารางอันดับสำหรับภาษานั้น ให้แก้ไขแบบฟอร์มด้วยคำแปลสำหรับตารางอันดับนั้น คลิกบันทึกเพื่อจัดเก็บรายละเอียดของตารางอันดับที่แปลแล้ว
ซ่อนคะแนนในลีดเดอร์บอร์ด
บริการ Google Play Games มีฟีเจอร์การป้องกันการปลอมแปลงในลีดเดอร์บอร์ดที่จะตรวจสอบคะแนนที่น่าสงสัยว่ามีการปลอมแปลงและซ่อนคะแนนดังกล่าวโดยอัตโนมัติ ฟีเจอร์นี้ใช้ได้กับเกม Android เท่านั้น
ระบบจะเปิดใช้การป้องกันการปลอมแปลงโดยค่าเริ่มต้นสำหรับลีดเดอร์บอร์ดใหม่ที่คุณสร้างสำหรับเกม Android แต่จะปิดใช้สำหรับลีดเดอร์บอร์ดที่มีอยู่ หากต้องการเปิดใช้การป้องกันการปลอมแปลงสำหรับลีดเดอร์บอร์ดที่มีอยู่ซึ่งเผยแพร่ไปแล้ว ให้ทำตามขั้นตอนต่อไปนี้
- ใน Google Play Console ให้เปิดแท็บบริการเกม แล้วเลือกเกมจากรายการ
- เปิดแท็บตารางอันดับ แล้วเลือกอินสแตนซ์ตารางอันดับที่ต้องการเปิดใช้การป้องกันการแทรกแซง
- เปิดตัวเลือกเปิดใช้การป้องกันการปลอมแปลงลีดเดอร์บอร์ดเป็นเปิด
- คลิกบันทึกและดำเนินการต่อ
- เผยแพร่เกม
เมื่อเปิดใช้การป้องกันการปลอมแปลงสำหรับลีดเดอร์บอร์ดใน Google Play Console แล้ว ระบบอาจใช้เวลาถึง 24 ชั่วโมงก่อนที่ฟีเจอร์นี้จะมีผล ระบบจะไม่ซ่อนคะแนนที่ส่งมาก่อนที่คุณเปิดใช้การป้องกันการแทรกแซงย้อนหลัง
ในบางสถานการณ์ คุณอาจต้องการปิดใช้การป้องกันการแทรกแซง (เช่น หากเกมของคุณทำงานบนเว็บด้วยนอกเหนือจาก Android และแชร์ลีดเดอร์บอร์ดในแพลตฟอร์มเหล่านี้)
การติดตั้งใช้งานไคลเอ็นต์
ดูวิธีใช้ตารางอันดับสำหรับแพลตฟอร์มของคุณได้ที่แหล่งข้อมูลต่อไปนี้