การเพิ่มเหตุการณ์ลงในเกม

ข้อควรระวัง: คู่มือนี้มีไว้สําหรับการใช้บริการ Play Games v1 เราจะเปิดตัว SDK ของ C และคําแนะนําเพิ่มเติมสําหรับบริการเกมของ Play เวอร์ชัน 2 เร็วๆ นี้ ในระหว่างนี้คุณสามารถดูข้อมูลเพิ่มเติมเกี่ยวกับ v2 ในคู่มือการลงชื่อเข้าใช้ หากสนใจที่จะทดสอบ SDK เวอร์ชันใหม่นี้ โปรดสอบถามรายละเอียดจากผู้ติดต่อ Google ของคุณ

คู่มือนี้แสดงวิธีใช้บริการกิจกรรมในแอปพลิเคชัน C++

ข้อควรทราบก่อนที่จะเริ่มต้น

คุณควรอ่านแนวคิดของเกมของเหตุการณ์หากยังไม่ได้อ่าน

หากต้องการตั้งค่าสภาพแวดล้อมการพัฒนา C++ เพื่อใช้บริการกิจกรรม ให้ทําตามวิธีการในคู่มือการเริ่มต้นใช้งาน C++ คุณดาวน์โหลด SDK ของเกม C++ ของ Play Games ได้จากหน้าดาวน์โหลด SDK

ก่อนที่เกมจะเข้าถึงกิจกรรมได้ คุณต้องกําหนดกิจกรรมเหล่านั้นใน Google Play Console ก่อน

การส่งกิจกรรม

คุณเพิ่มโค้ดในเกมเพื่อแจ้งบริการเหตุการณ์ได้เมื่อเกิดเหตุการณ์ที่สนใจในเกม ตัวอย่างเหตุการณ์ที่คุณจับได้ในเกม ได้แก่ การฆ่าศัตรู สํารวจ หรือกลับไปที่ภูมิภาคต่างๆ ของเกม หรือหาไอเทมในเกม โดยปกติ คุณจะเรียกใช้เมธอด Increment ในตัวจัดการเหตุการณ์เพื่อเพิ่มจํานวนเหตุการณ์ 1 ทุกครั้งที่ผู้เล่นดําเนินการที่เชื่อมโยงกับเหตุการณ์นั้น (เช่น "สัตว์ประหลาดน้อย 1 ตัว")

ตัวอย่างต่อไปนี้แสดงวิธีส่งจํานวนเหตุการณ์ที่อัปเดตแล้วไปยังบริการเหตุการณ์

  // Increment the event count when player performs the 'Attack blue
  // monster' action.
  game_services_->Events().Increment(BLUE_MONSTER_EVENT_ID);

กําลังเรียกเหตุการณ์

หากต้องการเรียกค่าจํานวนปัจจุบันที่จัดเก็บในเซิร์ฟเวอร์ของ Google สําหรับเหตุการณ์นั้นๆ โปรดเรียกใช้วิธีใดวิธีหนึ่งจาก Fetch* ตัวอย่างเช่น คุณอาจแสดงสถิติในเกมของผู้เล่นหรือออกจาก UI ที่กําหนดเองในเกม

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

  // Log Events details.
  LogI("---- Showing Event Counts -----");
  gpg::EventManager::FetchAllCallback callback =
      [](gpg::EventManager::FetchAllResponse const &response) {
    for (auto i : response.data) {
      gpg::Event const &event = i.second;
      LogI("Event name: %s  count: %d", event.Name().c_str(),
           event.Count());
    }
  };
  game_services_->Events().FetchAll(callback);