รางวัลพิเศษสำหรับเกม Android

คู่มือนี้จะแสดงวิธีใช้ Achievements API ในแอปพลิเคชัน Android เพื่อปลดล็อกและแสดงรางวัลพิเศษในเกม คุณจะพบ API ได้ในแพ็กเกจ com.google.android.gms.games และ com.google.android.gms.games.achievements

ก่อนเริ่มต้น

หากยังไม่ได้ดำเนินการ คุณอาจพบว่าการตรวจสอบแนวคิดของเกมเกี่ยวกับรางวัลพิเศษมีประโยชน์

ก่อนเริ่มเขียนโค้ดโดยใช้ Achievements API ให้ทำดังนี้

รับไคลเอ็นต์รางวัลพิเศษ

หากต้องการเริ่มใช้ 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 ของรางวัลพิเศษเริ่มต้น

แถวแนะนำจะแสดงรางวัลพิเศษที่เปิดเผยซึ่งพบบ่อยที่สุด ซึ่งเป็นรางวัลพิเศษที่ผู้เล่นยังไม่ได้ปลดล็อก แต่มีเปอร์เซ็นต์สูงสุดที่ผู้เล่นคนอื่นๆ ปลดล็อกแล้ว

UI รางวัลพิเศษเริ่มต้นที่แสดงรางวัลพิเศษที่แนะนำและรางวัลพิเศษที่ปลดล็อกแล้ว