คู่มือนี้จะแสดงวิธีใช้ Achievements API ในแอปพลิเคชัน Android เพื่อปลดล็อกและแสดงรางวัลพิเศษในเกม คุณจะพบ API ได้ในแพ็กเกจ com.google.android.gms.games และ com.google.android.gms.games.achievements
ก่อนเริ่มต้น
หากยังไม่ได้ดำเนินการ คุณอาจพบว่าการตรวจสอบแนวคิดของเกมเกี่ยวกับรางวัลพิเศษมีประโยชน์
ก่อนเริ่มเขียนโค้ดโดยใช้ Achievements API ให้ทำดังนี้
ทำตามวิธีการติดตั้งและตั้งค่าแอปเพื่อใช้บริการเกมของ Google Play ในคู่มือตั้งค่า SDK บริการ Google Play
กำหนดรางวัลพิเศษที่ต้องการให้เกมปลดล็อกหรือแสดงโดยทำตามวิธีการในคู่มือ Google Play Console
ดาวน์โหลดและตรวจสอบตัวอย่างโค้ดรางวัลพิเศษในหน้าตัวอย่าง Android
ทำความคุ้นเคยกับคำแนะนำที่อธิบายไว้ในรายการตรวจสอบคุณภาพ
รับไคลเอ็นต์รางวัลพิเศษ
หากต้องการเริ่มใช้ Achievements API เกมของคุณต้องได้รับออบเจ็กต์ AchievementsClient ก่อน คุณทำได้โดยการเรียกใช้เมธอด
Games.getAchievementClient()
และส่งกิจกรรม
ปลดล็อกรางวัลพิเศษ
หากต้องการปลดล็อกรางวัลพิเศษ ให้เรียกใช้เมธอด
AchievementsClient.unlock()
และส่งรหัสรางวัลพิเศษ
ข้อมูลโค้ดต่อไปนี้แสดงวิธีที่แอปสามารถปลดล็อกรางวัลพิเศษได้
PlayGames.getAchievementsClient(this).unlock(getString(R.string.my_achievement_id));
หากรางวัลพิเศษเป็นประเภทเพิ่มขึ้น (นั่นคือต้องใช้หลายขั้นตอนเพื่อปลดล็อก) ให้เรียกใช้ AchievementsClient.increment() แทน
ข้อมูลโค้ดต่อไปนี้แสดงวิธีที่แอปสามารถเพิ่มความสำเร็จของผู้เล่น
PlayGames.getAchievementsClient(this).increment(getString(R.string.my_achievement_id), 1);
คุณไม่จำเป็นต้องเขียนโค้ดเพิ่มเติมเพื่อปลดล็อกรางวัลพิเศษ บริการเกมของ Google Play จะปลดล็อกรางวัลพิเศษโดยอัตโนมัติเมื่อถึงจำนวนขั้นตอนที่กำหนด
แนวทางปฏิบัติแนะนำคือการกำหนดรหัสรางวัลพิเศษในไฟล์ strings.xml เพื่อให้เกมอ้างอิงรางวัลพิเศษตามรหัสทรัพยากรได้ เมื่อทำการเรียกเพื่ออัปเดตและโหลดรางวัลพิเศษ โปรดทำตามแนวทางปฏิบัติแนะนำเหล่านี้ด้วยเพื่อหลีกเลี่ยงการใช้โควต้า API เกิน
แสดงรางวัลพิเศษ
หากต้องการแสดงรางวัลพิเศษของผู้เล่น ให้เรียกใช้
AchievementsClient.getAchievementsIntent()
เพื่อรับ
Intent
เพื่อสร้างอินเทอร์เฟซผู้ใช้สำหรับรางวัลพิเศษเริ่มต้น จากนั้นเกมของคุณจะแสดง UI ได้โดยเรียกใช้ startActivityForResult
ข้อมูลโค้ดต่อไปนี้แสดงวิธีที่แอปของคุณสามารถแสดงอินเทอร์เฟซผู้ใช้เริ่มต้นของรางวัลพิเศษ ในข้อมูลโค้ด RC_ACHIEVEMENT_UI คือจำนวนเต็มที่กำหนดเองซึ่งเกมใช้เป็นรหัสคำขอ
private static final int RC_ACHIEVEMENT_UI = 9003; private void showAchievements() { PlayGames.getAchievementsClient(this) .getAchievementsIntent() .addOnSuccessListener(new OnSuccessListener<Intent>() { @Override public void onSuccess(Intent intent) { startActivityForResult(intent, RC_ACHIEVEMENT_UI); } }); }
รูปภาพต่อไปนี้แสดงตัวอย่าง UI ของรางวัลพิเศษเริ่มต้น
แถวแนะนำจะแสดงรางวัลพิเศษที่เปิดเผยซึ่งพบบ่อยที่สุด ซึ่งเป็นรางวัลพิเศษที่ผู้เล่นยังไม่ได้ปลดล็อก แต่มีเปอร์เซ็นต์สูงสุดที่ผู้เล่นคนอื่นๆ ปลดล็อกแล้ว