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