ลีดเดอร์บอร์ดเป็นวิธีสนุกๆ ในการกระตุ้นการแข่งขันในหมู่ผู้เล่น ทั้งสำหรับ แฟนตัวยงของคุณ (ซึ่งจะต่อสู้เพื่อให้ได้ตำแหน่งบนสุดในที่สาธารณะ) ลีดเดอร์บอร์ด) และสำหรับผู้เล่นทั่วไป (ที่จะสนใจ เปรียบเทียบความคืบหน้าของตนเองกับเพื่อน)
หากต้องการดูวิธีใช้ลีดเดอร์บอร์ดสำหรับแพลตฟอร์มของคุณ ดูการติดตั้งใช้งานไคลเอ็นต์
การทำความเข้าใจลีดเดอร์บอร์ด
เมื่อคุณสร้างลีดเดอร์บอร์ด บริการเกมของ Google Play จะจัดการโดยส่วนใหญ่ ของลีดเดอร์บอร์ดนี้สำหรับคุณ ขั้นตอนทั่วไปมีการทำงานดังนี้
- เมื่อสิ้นสุดเกม (หรือในช่วงเวลาที่เหมาะสมที่คุณระบุ) เกมจะส่งคะแนนของผู้เล่นไปยังลีดเดอร์บอร์ดอย่างน้อย 1 รายการที่คุณสร้างขึ้น เกมนี้
- บริการเกมของ Google Play จะตรวจสอบว่าคะแนนนี้ดีกว่าคะแนนปัจจุบันของผู้เล่นหรือไม่ รายการลีดเดอร์บอร์ดสำหรับคะแนนรายวัน รายสัปดาห์ หรือตลอดกาล หากใช่ พารามิเตอร์ บริการเกมของ Google Play จะอัปเดตลีดเดอร์บอร์ดที่เกี่ยวข้องด้วยคะแนนใหม่
- บริการเกมของ Google Play จะส่งรายงานคะแนนกลับไปยังไคลเอ็นต์เกม รายงานนี้ บอกลูกค้าว่านี่คือคะแนนใหม่รายวัน รายสัปดาห์ หรือสูงสุดตลอดกาล ถ้าไม่เป็นเช่นนั้น บริการเกมของ Google Play จะบอกลูกค้าว่าวันที่ คะแนนสูงสุดรายสัปดาห์หรือตลอดกาลสำหรับผู้เล่นรายนี้
- หากต้องการดึงผลลัพธ์ของผู้เล่นสำหรับลีดเดอร์บอร์ด คุณขอเวลาได้ เฟรม (รายวัน รายสัปดาห์ หรือตลอดเวลา) และระบุว่าผู้ใช้ต้องการหรือไม่ เพื่อดูลีดเดอร์บอร์ดโซเชียลหรือสาธารณะ บริการเกมจะดำเนินการทั้งหมด การกรองที่จำเป็น แล้วส่งผลลัพธ์กลับไปยังไคลเอ็นต์
- ในกรณีที่มีคะแนนที่ต้องรายงานจำนวนมาก บริการเกมจะส่ง ย้อนกลับเฉพาะข้อมูลสำหรับคะแนนสูงสุดของลีดเดอร์บอร์ด คุณยังเรียกดูไฟล์ข้อมูล RAW ได้ด้วย ข้อมูลคะแนนสำหรับคะแนนสูงสุด หรือคะแนนที่อยู่ติดกับผู้เล่น
ลีดเดอร์บอร์ดหลายรายการ
เกมมีลีดเดอร์บอร์ดได้หลายรายการสูงสุด 70 รายการ สำหรับ เช่น เกมที่มีหลายระดับอาจมีลีดเดอร์บอร์ดที่แตกต่างกันสำหรับ ในแต่ละเลเวล และเกมแข่งรถอาจมีลีดเดอร์บอร์ดแยกสำหรับแต่ละเลเวล และเกมแข่งรถอาจมีลีดเดอร์บอร์ดแยกกัน ติดตาม
กรอบเวลาของลีดเดอร์บอร์ด
Play Games SDK จะสร้างเวอร์ชันแบบรายวัน รายสัปดาห์ และทุกเวอร์ชันโดยอัตโนมัติ ของทุกลีดเดอร์บอร์ดที่คุณสร้างขึ้น โดยคุณไม่จำเป็นต้องสร้าง ลีดเดอร์บอร์ดสำหรับแต่ละกรอบเวลา
ลีดเดอร์บอร์ดรายวันจะรีเซ็ตในเวลา UTC-7 (นั่นคือ " Midnight Pacific Daylight Time") ตลอดทั้งปี
ลีดเดอร์บอร์ดรายสัปดาห์จะรีเซ็ตตอนเที่ยงคืนระหว่างวันเสาร์และวันอาทิตย์เหมือนเดิม เป็นลีดเดอร์บอร์ดรายวัน (UTC-7)
ลีดเดอร์บอร์ดสาธารณะและโซเชียล
Play Games SDK สามารถแสดงลีดเดอร์บอร์ดแต่ละเวอร์ชันที่แตกต่างกัน 2 เวอร์ชันต่อ ผู้เล่น:
ลีดเดอร์บอร์ดโซเชียล คือลีดเดอร์บอร์ดที่ประกอบด้วยผู้คนใน แวดวง (หรือกล่าวคือ สมาชิกของแวดวงที่ผู้ใช้ได้เลือกที่จะ แชร์กับแอปพลิเคชันของคุณ) ที่ตัดสินใจแชร์กิจกรรมการเล่นเกม ให้แก่ผู้ใช้
ลีดเดอร์บอร์ดสาธารณะคือลีดเดอร์บอร์ดที่ประกอบด้วยผู้เล่นที่ได้เลือก เพื่อแชร์กิจกรรมการเล่นเกม แบบสาธารณะได้ หากโปรแกรมเล่นของคุณไม่ได้เลือก แชร์กิจกรรมการเล่นเกมของตนแบบสาธารณะ โดยข้อมูลดังกล่าวจะไม่ปรากฏในลีดเดอร์บอร์ดนี้
กำลังแสดงลีดเดอร์บอร์ด
ในไลบรารีของไคลเอ็นต์อุปกรณ์เคลื่อนที่ ไลบรารีจะดูแลการจัดรูปแบบทั้งหมด และการแสดงลีดเดอร์บอร์ด คุณสามารถระบุได้ว่าโปรแกรมเล่นจะดู ลีดเดอร์บอร์ดเฉพาะ หรือดูรายการลีดเดอร์บอร์ดทั้งหมดที่สามารถทำได้ จาก Google Play
คุณสามารถใช้ลีดเดอร์บอร์ดเวอร์ชันของคุณเอง ด้วยการเข้าถึงข้อมูลจากไลบรารีของไคลเอ็นต์โดยตรง
Attributes
ในการสร้างและจัดการลีดเดอร์บอร์ด คุณจะต้องทำความคุ้นเคยกับ แอตทริบิวต์ลีดเดอร์บอร์ด:
ข้อมูลพื้นฐาน
องค์ประกอบพื้นฐานเหล่านี้เชื่อมโยงกับลีดเดอร์บอร์ดทุกรายการ:
- รหัสคือสตริงที่ไม่ซ้ำกันซึ่ง Google Play Console จะ ที่ระบบสร้างให้ คุณจะใช้รหัสที่ไม่ซ้ำกันนี้เพื่ออ้างถึงลีดเดอร์บอร์ดใน ไคลเอ็นต์เกมของคุณ
- ชื่อ คือชื่อย่อของลีดเดอร์บอร์ด (เช่น "คะแนนสูงสุด" หรือ "ระดับ 3") ซึ่งยาวไม่เกิน 100 อักขระ
- ไอคอน คือไอคอนสี่เหลี่ยมจัตุรัสที่จะเชื่อมโยงกับ ลีดเดอร์บอร์ด สำหรับแนวทางปฏิบัติที่ดีที่สุดเมื่อสร้างไอคอนลีดเดอร์บอร์ด โปรดดู หัวข้อหลักเกณฑ์เกี่ยวกับไอคอนด้านล่าง
- ลำดับรายการคือลำดับที่ลีดเดอร์บอร์ดจะปรากฏ เมื่อผู้เล่นดูลีดเดอร์บอร์ดที่เชื่อมโยงกับเกมของคุณ
- ขีดจำกัดเป็นค่าที่ไม่บังคับซึ่งกำหนดขีดจำกัดต่ำสุดและสูงสุดของ
คะแนนที่ได้รับอนุญาตในลีดเดอร์บอร์ด การดำเนินการนี้จะช่วยให้คุณทิ้งคะแนนได้
การส่งที่เป็นการฉ้อโกงอย่างชัดเจน คุณยังสามารถใช้
Players.hideเพื่อซ่อนผู้เล่น ที่คุณเชื่อว่าได้ส่งคะแนนที่เป็นการฉ้อโกงจากลีดเดอร์บอร์ดทั้งหมดใน แอปของคุณ
การเรียงลำดับ
ลีดเดอร์บอร์ดมีการจัดลำดับได้ 2 ประเภทดังนี้
- ลีดเดอร์บอร์ดใหญ่ดีกว่าเป็นค่าเริ่มต้น นี่คือ โดยปกติ คุณจะเห็นในเกมส่วนใหญ่ที่ผู้เล่นได้รับคะแนน
- เล็กกว่าย่อมดีกว่า ลีดเดอร์บอร์ดบางครั้งจะใช้ในกรณีที่ ยิ่งน้อยยิ่งดี ตัวอย่างที่พบได้บ่อยที่สุดสำหรับแท็กประเภทนี้ ลีดเดอร์บอร์ดอยู่ในเกมแข่งรถ โดยคะแนนจะแสดงถึง เพื่อแข่งให้จบ
การจัดรูปแบบคะแนน
ในขณะที่คะแนนทั้งหมดจะส่งไปยังลีดเดอร์บอร์ดและจัดเก็บภายในได้ตราบใดที่ จำนวนเต็ม บริการเกมสามารถนำเสนอ ให้กับผู้ใช้เป็นจำนวนต่างๆ รูปแบบ:
ลีดเดอร์บอร์ดตัวเลขแสดงคะแนนเป็นตัวเลข ซึ่งจะแสดงเป็น จำนวนเต็มหรือเป็นจำนวนจริงที่มีจำนวนคงที่ของตำแหน่งทศนิยม คุณส่ง ระบบจะแทรกคะแนนเป็นจำนวนเต็มและจุดทศนิยมในตำแหน่งที่ระบุ ตำแหน่งนั้น ตัวอย่างเช่น คะแนน
314159จะแสดงเป็น3.141593141.59หรือ314159ขึ้นอยู่กับหลักทศนิยมที่คุณระบุลีดเดอร์บอร์ดเวลาจะแสดงคะแนนเป็นชั่วโมง / นาที / วินาที / ร้อย ของรูปแบบที่ 2 คุณต้องส่งคะแนนเป็นมิลลิวินาที เพื่อให้
66032มีค่าเป็น ตีความเป็น1:06.03ลีดเดอร์บอร์ดสกุลเงินจะแสดงคะแนนในรูปแบบสกุลเงิน คุณส่ง เป็น 1/1,000,000 ของหน่วยสกุลเงินหลัก ตัวอย่างเช่น คะแนน 19,950,000 จะถูกตีความเป็น
$19.95สมมติว่าคุณระบุ สกุลเงินเป็น USD
ลีดเดอร์บอร์ดที่เป็นตัวเลขยังรองรับหน่วยที่กำหนดเองด้วย ตัวอย่างเช่น หากเกมของคุณ หน่วยวัดคะแนนสูงเป็นเมตร คุณสามารถระบุ "เมตร" ได้ เป็นหน่วยเริ่มต้นสำหรับ ลีดเดอร์บอร์ด
คำแปลและการจัดรูปแบบคะแนน
เมื่อไลบรารีของไคลเอ็นต์อุปกรณ์เคลื่อนที่ขอข้อมูลลีดเดอร์บอร์ดจากบริการเกม จะระบุภาษาและสถานที่ที่จะแสดงคะแนนเหล่านี้ ส่วนที่เหลือ API ช่วยให้คุณระบุตามภาษา เป็นภาษาได้อีกด้วย บริการเกมแสดงผลคะแนนลีดเดอร์บอร์ดที่จัดรูปแบบแล้ว ที่เหมาะสมสำหรับภาษาและ ประเทศนั้นๆ คะแนนที่จัดรูปแบบเหล่านี้จะปรากฏขึ้น คุณได้เพิ่มหรือไม่ คำแปลสำหรับลีดเดอร์บอร์ด
สำหรับลีดเดอร์บอร์ดตัวเลข รูปแบบตัวเลขจะแสดงแตกต่างกันตาม
ภาษา (เช่น 12,345.78 ในสหรัฐอเมริกา และ 12 345,78 ในฝรั่งเศส) ถ้า
คุณกำลังใช้หน่วยที่กำหนดเองและได้เพิ่ม
คำแปล
ในเกมของคุณ คุณจะต้องให้หน่วยแปลสำหรับทุกภาษาที่คุณมี
เพิ่ม แล้ว จากนั้น บริการจะแสดงหน่วยที่แปลแล้วเหล่านี้ตามความเหมาะสม
คุณอาจต้องระบุข้อมูลที่แตกต่างกันตามภาษาที่คุณเลือก ของชื่อหน่วยต่างๆ ของคุณ คุณจะต้องมีเวอร์ชันที่เป็นภาษาอังกฤษ รายการ และอีกรายการสำหรับสิ่งอื่นๆ (เช่น "เมตร" และ "เมตร") ใน ในทางกลับกัน ภาษาโปแลนด์คุณจะต้องใส่เวอร์ชันของหน่วยหนึ่ง ยูนิตไม่กี่หน่วย หลายยูนิต และอื่นๆ หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับกฎพหูพจน์ ดูจำนวน สตริง(พหูพจน์)
สำหรับลีดเดอร์บอร์ดเวลา รูปแบบเวลาจะแสดงตาม
ภาษาและภาษาของผู้เล่น โดยจะเห็นได้ชัดเจนหากกำลังใช้
เสี้ยววินาที หรือมีค่าชั่วโมงที่มีตัวเลขมากกว่า 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 สําหรับเกมของคุณ แล้วไปที่เติบโต > เล่นเกม บริการ > การตั้งค่าและการจัดการ > ลีดเดอร์บอร์ด แล้วคลิก ปุ่มสร้างลีดเดอร์บอร์ด
จากนั้นกรอกข้อมูลที่จำเป็นสำหรับลีดเดอร์บอร์ดนี้
คลิกบันทึกเป็นฉบับร่าง แล้วลีดเดอร์บอร์ดของคุณจะอยู่ใน "ฉบับร่าง" เมื่อคุณเผยแพร่เกม ระบบจะเผยแพร่ลีดเดอร์บอร์ดทั้งหมดของเกม ด้วย
สร้างลีดเดอร์บอร์ดสำหรับเกมที่เผยแพร่แล้ว
ในการสร้างลีดเดอร์บอร์ดเพิ่มเติมสำหรับเกมที่เผยแพร่แล้ว ทำตามขั้นตอนเดียวกับด้านบน ดูข้อมูลเพิ่มเติมเกี่ยวกับการทดสอบ เวอร์ชันเกม โปรดดูการเผยแพร่การเปลี่ยนแปลงเกมของคุณ
เมื่อคุณทดสอบลีดเดอร์บอร์ดของคุณและพึงพอใจแล้ว คุณสามารถเผยแพร่ใหม่ เกมของคุณด้วยลีดเดอร์บอร์ดใหม่ และสิ่งต่างๆ เหล่านั้นจะได้รับการเผยแพร่สู่สายตาชาวโลก
แก้ไขลีดเดอร์บอร์ด
หากต้องการแก้ไขลีดเดอร์บอร์ดที่คุณสร้างไว้แล้ว ให้คลิกลีดเดอร์บอร์ดใน แท็บลีดเดอร์บอร์ดของ 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 และ ลีดเดอร์บอร์ดในแพลตฟอร์มเหล่านี้)
การติดตั้งใช้งานไคลเอ็นต์
หากต้องการดูวิธีใช้ลีดเดอร์บอร์ดสำหรับแพลตฟอร์มของคุณ โปรดดูข้อมูลต่อไปนี้ แหล่งข้อมูล: