ลีดเดอร์บอร์ดเป็นวิธีที่สนุกในการกระตุ้นการแข่งขันในหมู่ผู้เล่น ทั้งสำหรับแฟนๆ ตัวยง (ที่ต่อสู้เพื่อตำแหน่งสูงสุดในลีดเดอร์บอร์ดสาธารณะ) และสำหรับผู้เล่นทั่วไป (ที่สนใจเปรียบเทียบความคืบหน้าของตนกับเพื่อนๆ)
ดูวิธีใช้ลีดเดอร์บอร์ดสำหรับแพลตฟอร์มได้ที่การติดตั้งใช้งานฝั่งไคลเอ็นต์
ทำความเข้าใจลีดเดอร์บอร์ด
เมื่อคุณสร้างลีดเดอร์บอร์ด บริการเกมของ Play จะจัดการ ลีดเดอร์บอร์ดนี้ในเกือบทุกด้านให้คุณ กระบวนการทั่วไปมีดังนี้
- เมื่อจบเกม (หรือในเวลาที่เหมาะสมที่คุณกำหนด) เกมจะส่งคะแนนของผู้เล่นไปยังลีดเดอร์บอร์ดอย่างน้อย 1 รายการที่คุณ สร้างไว้สำหรับเกม
- บริการเกมของ Play จะตรวจสอบว่าคะแนนนี้ดีกว่ารายการในลีดเดอร์บอร์ดปัจจุบันของผู้เล่นสำหรับคะแนนรายวัน รายสัปดาห์ หรือคะแนนตลอดกาลหรือไม่ หากเป็นเช่นนั้น บริการเกมของ Play จะอัปเดตลีดเดอร์บอร์ดที่เกี่ยวข้องด้วยคะแนนใหม่
- บริการเกมของ Play จะส่งรายงานคะแนนกลับไปยังไคลเอ็นต์เกม รายงานนี้จะบอกไคลเอ็นต์ว่าคะแนนสูงสุดนี้เป็นคะแนนสูงสุดใหม่รายวัน รายสัปดาห์ หรือตลอดเวลา หากไม่ใช่ บริการเกม Play จะบอกไคลเอ็นต์ว่าคะแนนสูงสุดปัจจุบันรายวัน รายสัปดาห์ หรือตลอดกาลของผู้เล่นรายนี้คือเท่าใด
- หากต้องการดึงผลลัพธ์ของผู้เล่นสำหรับลีดเดอร์บอร์ด คุณสามารถขอ กรอบเวลา (รายวัน รายสัปดาห์ หรือตลอดเวลา) และระบุว่าผู้ใช้ ต้องการดูลีดเดอร์บอร์ดโซเชียลหรือลีดเดอร์บอร์ดสาธารณะหรือไม่ บริการ Play Games จะทำการกรองที่จำเป็นทั้งหมด แล้วส่งผลลัพธ์กลับไปยังไคลเอ็นต์
- ในกรณีที่มีคะแนนจำนวนมากที่ต้องรายงาน บริการเกม Play จะส่งกลับเฉพาะข้อมูลคะแนนสูงสุดในลีดเดอร์บอร์ด นอกจากนี้ คุณยัง ดึงข้อมูลคะแนนดิบสำหรับคะแนนสูงสุดหรือคะแนนที่อยู่ติดกับคะแนนของ ผู้เล่นได้ด้วย
ลีดเดอร์บอร์ดหลายรายการ
เกมมีลีดเดอร์บอร์ดได้หลายรายการ โดยมีได้สูงสุด 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 จะมีการระบุภาษาและภาษาท้องถิ่นที่จะใช้แสดงคะแนนเหล่านี้ REST API ช่วยให้คุณ ระบุภาษาตามภาษาได้ด้วย บริการเกมของ Play จะแสดงคะแนนลีดเดอร์บอร์ดที่จัดรูปแบบ ซึ่งเหมาะสมกับภาษานั้นๆ และภาษาท้องถิ่น คะแนนที่จัดรูปแบบเหล่านี้จะปรากฏขึ้นไม่ว่าคุณจะเพิ่มคำแปลสำหรับลีดเดอร์บอร์ดหรือไม่ก็ตาม
สำหรับลีดเดอร์บอร์ดตัวเลข รูปแบบตัวเลขจะแสดงแตกต่างกันไปตาม
ภาษา (เช่น 12,345.78 ในสหรัฐอเมริกา และ 12 345,78 ในฝรั่งเศส) หากคุณใช้หน่วยที่กำหนดเองและเพิ่มคำแปลลงในเกม คุณต้องระบุหน่วยที่แปลแล้วสำหรับทุกภาษาที่คุณเพิ่ม จากนั้น
บริการจะแสดงหน่วยที่แปลแล้วเหล่านี้ในที่ที่เหมาะสม
คุณอาจต้องระบุชื่อหน่วยในเวอร์ชันต่างๆ โดยขึ้นอยู่กับภาษาที่เลือก ในภาษาอังกฤษ คุณจะต้องมีเวอร์ชันสำหรับรายการเดียวและอีกเวอร์ชันสำหรับรายการอื่นๆ ทั้งหมด (เช่น "meter" และ "meters") ใน ภาษาโปแลนด์ คุณจะต้องระบุเวอร์ชันสำหรับหน่วยเดียว 2-4 หน่วย 5-21 หน่วย และอื่นๆ ดูข้อมูลเพิ่มเติมเกี่ยวกับกฎการใช้คำนามพหูพจน์ได้ที่สตริงจำนวน(พหูพจน์)
สำหรับลีดเดอร์บอร์ดเวลา รูปแบบเวลาจะแสดงตามภาษาและภาษาถิ่นของผู้เล่น
โดยคุณจะสังเกตเห็นการเปลี่ยนแปลงนี้ได้ชัดเจนหากใช้
เศษส่วนของวินาทีหรือมีค่าชั่วโมงที่มีตัวเลขมากกว่า 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 Games Services > การตั้งค่าและการจัดการ > ลีดเดอร์บอร์ด แล้วคลิกปุ่ม สร้างลีดเดอร์บอร์ด
จากนั้นเพียงกรอกข้อมูลที่จำเป็นสำหรับลีดเดอร์บอร์ดนี้
คลิกบันทึกเป็นฉบับร่าง แล้วลีดเดอร์บอร์ดจะแสดงในสถานะ "ฉบับร่าง" เมื่อคุณเผยแพร่เกม ระบบจะเผยแพร่ลีดเดอร์บอร์ดทั้งหมดของเกมไปด้วย
สร้างลีดเดอร์บอร์ดสำหรับเกมที่เผยแพร่แล้ว
หากต้องการสร้างลีดเดอร์บอร์ดเพิ่มเติมสำหรับเกมที่เผยแพร่ไปแล้ว ให้ทำตามขั้นตอนเดียวกันกับด้านบน ดูข้อมูลเพิ่มเติมเกี่ยวกับการทดสอบเกมเวอร์ชันอัปเดตได้ที่การเผยแพร่การเปลี่ยนแปลงในเกม
เมื่อทดสอบลีดเดอร์บอร์ดและพอใจกับผลลัพธ์แล้ว คุณสามารถเผยแพร่เกมอีกครั้งด้วยลีดเดอร์บอร์ดใหม่ และระบบจะเผยแพร่ลีดเดอร์บอร์ดดังกล่าวให้ผู้ใช้ทั่วโลก
แก้ไขลีดเดอร์บอร์ด
หากต้องการแก้ไขลีดเดอร์บอร์ดที่สร้างไว้แล้ว ให้คลิกลีดเดอร์บอร์ดในแท็บลีดเดอร์บอร์ดของ Google Play Console เมื่อถึงขั้นตอนนี้ คุณจะเห็นแบบฟอร์มเดียวกับที่ใช้เมื่อสร้างลีดเดอร์บอร์ดเป็นครั้งแรก และจะสามารถแก้ไขช่องใดก็ได้ตามต้องการ
เมื่อแก้ไขลีดเดอร์บอร์ดเสร็จแล้ว ให้คลิกปุ่มบันทึกเป็นฉบับร่าง ลีดเดอร์บอร์ดที่แก้ไขใหม่จะอยู่ในสถานะ "ฉบับร่าง" ซึ่งจะทำให้คุณทดสอบได้
หากลีดเดอร์บอร์ดทำงานได้อย่างถูกต้อง ให้เลือกเผยแพร่การเปลี่ยนแปลงจากช่องที่ด้านบนของแบบฟอร์มลีดเดอร์บอร์ด แล้วคุณจะเผยแพร่เกมต่อสาธารณะอีกครั้งพร้อมกับลีดเดอร์บอร์ดทั้งหมดที่อัปเดตแล้วได้
เลิกทำการแก้ไข
หากตัดสินใจว่าไม่ชอบลีดเดอร์บอร์ดที่แก้ไขใหม่และต้องการกลับไปใช้เวอร์ชันก่อนหน้า เพียงเลือกเปลี่ยนกลับจากช่องที่ด้านบนของแบบฟอร์มลีดเดอร์บอร์ด ลีดเดอร์บอร์ดจะเปลี่ยนกลับไปเป็นเวอร์ชันที่เผยแพร่ก่อนหน้านี้
ลบลีดเดอร์บอร์ด
คุณสามารถลบลีดเดอร์บอร์ดที่อยู่ในสถานะ "ฉบับร่าง" หรือที่เผยแพร่แล้ว หากต้องการลบลีดเดอร์บอร์ดใน Google Play Console ให้ไปที่แบบฟอร์ม ของลีดเดอร์บอร์ด แล้วคลิกลบลีดเดอร์บอร์ดที่ด้านบนของแบบฟอร์ม
หรือจะเรียกใช้ Players.hide เพื่อ
ซ่อนลีดเดอร์บอร์ดของผู้เล่นในแอปก็ได้
รีเซ็ตลีดเดอร์บอร์ด
คุณจะรีเซ็ตข้อมูลความคืบหน้าของผู้เล่นได้สำหรับลีดเดอร์บอร์ดฉบับร่างเท่านั้น
- หากต้องการรีเซ็ตลีดเดอร์บอร์ดใน Google Play Console ให้คลิกรีเซ็ตความคืบหน้า ที่ด้านบนของแบบฟอร์มสำหรับกิจกรรมนั้น
- หากต้องการรีเซ็ตข้อมูลลีดเดอร์บอร์ดแบบเป็นโปรแกรม ให้เรียกใช้เมธอดของ Management API
Scores
เพิ่มคำแปลสำหรับลีดเดอร์บอร์ด
คุณระบุคำแปลของคุณเองสำหรับลีดเดอร์บอร์ดที่เชื่อมโยงกับ เกมได้ ก่อนดำเนินการดังกล่าว โปรดทำตามขั้นตอนที่อธิบายไว้ใน การเพิ่มคำแปลสำหรับ เกม นอกจากนี้ คุณยังต้อง สร้างลีดเดอร์บอร์ดอย่างน้อย 1 รายการสำหรับเกมด้วย
หากต้องการเพิ่มคำแปลของคุณเองสำหรับลีดเดอร์บอร์ด ให้เปิดแท็บลีดเดอร์บอร์ดสำหรับ เกมใน Google Play Console แล้วเลือกลีดเดอร์บอร์ดที่มีอยู่ ในหน้ารายละเอียดของลีดเดอร์บอร์ด ให้คลิกแท็บภาษาที่คุณเพิ่มไว้ก่อนหน้านี้ในแท็บรายละเอียดเกม ในหน้ารายละเอียดของลีดเดอร์บอร์ดสำหรับภาษานั้น ให้แก้ไขแบบฟอร์มด้วยคำแปลสำหรับลีดเดอร์บอร์ดนั้น คลิก บันทึกเพื่อจัดเก็บรายละเอียดของลีดเดอร์บอร์ดที่แปลแล้ว
ซ่อนคะแนนในลีดเดอร์บอร์ด
บริการเกมของ Google Play มีฟีเจอร์การป้องกันการปลอมแปลงลีดเดอร์บอร์ดที่จะตรวจสอบคะแนนที่น่าสงสัยว่ามีการปลอมแปลงและซ่อนคะแนนเหล่านั้นโดยอัตโนมัติ ฟีเจอร์นี้ใช้ได้กับเกม Android เท่านั้น
ระบบเปิดใช้การป้องกันการปลอมแปลงไว้โดยค่าเริ่มต้นสำหรับลีดเดอร์บอร์ดใหม่ที่คุณสร้างสำหรับ เกม Android แต่จะปิดใช้การป้องกันนี้ไว้สำหรับลีดเดอร์บอร์ดที่มีอยู่แล้ว หากต้องการเปิดใช้การป้องกันการปลอมแปลงสำหรับลีดเดอร์บอร์ดที่มีอยู่แล้วซึ่งเผยแพร่ไปแล้ว ให้ทำตามขั้นตอนต่อไปนี้
- ใน Google Play Console ให้เปิดแท็บบริการเกม แล้วเลือกเกมจากรายการ
- เปิดแท็บลีดเดอร์บอร์ด แล้วเลือกอินสแตนซ์ลีดเดอร์บอร์ดที่ต้องการเปิดใช้การป้องกันการปลอมแปลง
- เปิดตัวเลือกเปิดใช้การป้องกันการปลอมแปลงลีดเดอร์บอร์ด
- คลิกบันทึกและดำเนินการต่อ
- เผยแพร่เกมของคุณ
เมื่อเปิดใช้การป้องกันการปลอมแปลงสำหรับลีดเดอร์บอร์ดใน Google Play Console แล้ว ระบบอาจใช้เวลาถึง 24 ชั่วโมงก่อนที่ฟีเจอร์นี้จะมีผล ระบบจะไม่ซ่อนคะแนนย้อนหลังสำหรับคะแนนที่ส่งก่อนการเปิดใช้การป้องกันการปลอมแปลง
ในบางสถานการณ์ คุณอาจต้องการปิดใช้การป้องกันการปลอมแปลง (เช่น หาก เกมของคุณทำงานบนเว็บด้วยนอกเหนือจาก Android และแชร์ลีดเดอร์บอร์ด ในแพลตฟอร์มเหล่านี้)
การติดตั้งใช้งานฝั่งไคลเอ็นต์
ดูแหล่งข้อมูลต่อไปนี้เพื่อดูวิธีใช้ลีดเดอร์บอร์ดสำหรับแพลตฟอร์มของคุณ