กิจกรรมสำหรับเกม Android

คู่มือนี้จะแสดงวิธีรวบรวมข้อมูลเกมเพลย์ของผู้เล่นเพื่อใช้ในการวิเคราะห์เกมโดยใช้ API เหตุการณ์ที่บริการเกมของ Google Play มีให้ คุณจะพบ API ได้ในแพ็กเกจ com.google.android.gms.games.event และ com.google.android.gms.games

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

หากยังไม่ได้ดำเนินการ คุณอาจต้องดูแนวคิดเกี่ยวกับกิจกรรม เกม

ก่อนเริ่มเขียนโค้ดโดยใช้ API เหตุการณ์ ให้ทำดังนี้

• กำหนดเหตุการณ์สำหรับเกมใน Google Play Console

• ทำตามคำแนะนำในรายการตรวจสอบการลงชื่อเข้าใช้

รับไคลเอ็นต์เหตุการณ์

หากต้องการเริ่มใช้ API เหตุการณ์ เกมของคุณต้องได้รับออบเจ็กต์ EventsClient ก่อน คุณทำได้โดยการเรียกใช้เมธอด PlayGames.getEventsClient() และส่งกิจกรรม

ส่งกิจกรรม

คุณเพิ่มโค้ดในเกมเพื่อแจ้งบริการเกมของ Play ทุกครั้งที่เกิดเหตุการณ์ที่เกมสนใจได้

หากต้องการส่งการอัปเดตเหตุการณ์ ให้เรียกใช้ EventsClient.increment() ด้วยค่า eventId และจํานวนเต็ม incrementAmount ที่เท่ากับหรือ มากกว่า 0

• eventId จะสร้างขึ้นโดยบริการเกมของ Play เมื่อคุณกำหนดเหตุการณ์เป็นครั้งแรกใน Google Play Console และใช้เพื่อระบุเหตุการณ์นี้ในเกมของคุณโดยเฉพาะ

• คุณสามารถใช้incrementAmountอินพุตเพื่อระบุความคืบหน้าเชิงปริมาณของผู้เล่น ในการบรรลุเป้าหมายเฉพาะเกมบางอย่างได้ ตัวอย่างเช่น หาก เหตุการณ์ที่เกมต้องการติดตามคือ "กำจัดมอนสเตอร์ตาโปน 500 ตัว" ค่า incrementAmount อาจเป็นจำนวนมอนสเตอร์ที่ผู้เล่นฆ่า ในการต่อสู้ครั้งเดียว

ตัวอย่างวิธีส่งกิจกรรมที่มีจำนวนการเพิ่มเป็น 1 มีดังนี้

public void submitEvent(String eventId) {
  PlayGames.getEventsClient(this)
      .increment(eventId, 1);
}

ดึงข้อมูลกิจกรรม

คุณสามารถเรียกข้อมูลเหตุการณ์ทั้งหมดที่จัดเก็บไว้ในเซิร์ฟเวอร์ของ Google สำหรับเกมได้โดยการเรียก EventsClient.load() ในการเรียกใช้เมธอด ให้ส่งค่าบูลีนเพื่อระบุว่าบริการเกมของ Play ควรล้างข้อมูลที่แคชไว้ในเครื่องในอุปกรณ์ของผู้ใช้หรือไม่

หากต้องการดึงข้อมูลสำหรับเหตุการณ์ที่เฉพาะเจาะจงซึ่งคุณกำหนดไว้ใน Google Play Console ให้เรียกใช้ EventsClient.loadByIds() และส่งอาร์เรย์ของรหัสเหตุการณ์ในพารามิเตอร์อินพุต

ข้อมูลโค้ดต่อไปนี้แสดงวิธีค้นหารายการเหตุการณ์ทั้งหมดสำหรับเกมของคุณในบริการเกมของ Play

public void loadEvents() {
  PlayGames.getEventsClient(this)
      .load(true)
      .addOnCompleteListener(new OnCompleteListener<AnnotatedData<EventBuffer>>() {
        @Override
        public void onComplete(@NonNull Task<AnnotatedData<EventBuffer>> task) {
          if (task.isSuccessful()) {
            // Process all the events.
            for (Event event : task.getResult().get()) {
              Log.d(TAG, "loaded event " + event.getName());
            }
          } else {
            // Handle Error
            Exception exception = task.getException();
            int statusCode = CommonStatusCodes.DEVELOPER_ERROR;
            if (exception instanceof ApiException) {
              ApiException apiException = (ApiException) exception;
              statusCode = apiException.getStatusCode();
            }
            showError(statusCode);
          }
        }
      });
}