gpg::AchievementManager

#include <achievement_manager.h>

รับและตั้งค่าข้อมูลต่างๆ ที่เกี่ยวข้องกับรางวัลพิเศษ

สรุป

ประเภทสาธารณะ
FetchAllCallback Typedef
std::function< void(const FetchAllResponse &)>
กำหนดประเภท Callback ที่ได้รับ FetchAllResponse
FetchCallback Typedef
std::function< void(const FetchResponse &)>
กำหนดประเภท Callback ที่ได้รับ FetchResponse
ShowAllUICallback Typedef
std::function< void(const UIStatus &)>
กำหนดประเภท Callback ที่ได้รับ UIStatus

ฟังก์ชันสาธารณะ
Fetch(const std::string & achievement_id, FetchCallback callback)
void
ไม่พร้อมกันจะโหลดข้อมูลของรางวัลพิเศษที่เฉพาะเจาะจงสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้
Fetch(DataSource data_source, const std::string & achievement_id, FetchCallback callback)
void
ไม่พร้อมกันจะโหลดข้อมูลของรางวัลพิเศษที่เฉพาะเจาะจงสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้
FetchAll(FetchAllCallback callback)
void
โหลดข้อมูลรางวัลพิเศษทั้งหมดแบบไม่พร้อมกันสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้
FetchAll(DataSource data_source, FetchAllCallback callback)
void
โหลดข้อมูลรางวัลพิเศษทั้งหมดแบบไม่พร้อมกันสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้
FetchAllBlocking()
การโหลดข้อมูลรางวัลพิเศษทั้งหมดแบบพร้อมกันสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้ และแสดงผล FetchAllResponse โดยตรง
FetchAllBlocking(DataSource data_source)
การโหลดข้อมูลรางวัลพิเศษทั้งหมดแบบพร้อมกันสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้ และแสดงผล FetchAllResponse โดยตรง
FetchAllBlocking(Timeout timeout)
การโหลดข้อมูลรางวัลพิเศษทั้งหมดแบบพร้อมกันสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้ และแสดงผล FetchAllResponse โดยตรง
FetchAllBlocking(DataSource data_source, Timeout timeout)
การโหลดข้อมูลรางวัลพิเศษทั้งหมดแบบพร้อมกันสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้ และแสดงผล FetchAllResponse โดยตรง
FetchBlocking(const std::string & achievement_id)
โหลดข้อมูลแบบซิงโครนัสของรางวัลพิเศษที่เฉพาะเจาะจงซึ่งระบุโดยรหัสสตริงสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้ในปัจจุบัน จะแสดงผล FetchResponse โดยตรง
FetchBlocking(DataSource data_source, const std::string & achievement_id)
โหลดข้อมูลแบบซิงโครนัสของรางวัลพิเศษที่เฉพาะเจาะจงซึ่งระบุโดยรหัสสตริงสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้ในปัจจุบัน จะแสดงผล FetchResponse โดยตรง
FetchBlocking(Timeout timeout, const std::string & achievement_id)
โหลดข้อมูลแบบซิงโครนัสของรางวัลพิเศษที่เฉพาะเจาะจงซึ่งระบุโดยรหัสสตริงสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้ในปัจจุบัน จะแสดงผล FetchResponse โดยตรง
FetchBlocking(DataSource data_source, Timeout timeout, const std::string & achievement_id)
โหลดข้อมูลแบบซิงโครนัสของรางวัลพิเศษที่เฉพาะเจาะจงซึ่งระบุโดยรหัสสตริงสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้ในปัจจุบัน จะแสดงผล FetchResponse โดยตรง
Increment(const std::string & achievement_id)
void
เพิ่มรางวัลพิเศษตามจำนวนขั้นตอนที่กำหนด
Increment(const std::string & achievement_id, uint32_t steps)
void
เพิ่มรางวัลพิเศษตามจำนวนขั้นตอนที่กำหนด
Reveal(const std::string & achievement_id)
void
แสดงรางวัลพิเศษที่ซ่อนอยู่ให้ผู้เล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้
SetStepsAtLeast(const std::string & achievement_id, uint32_t steps)
void
ตั้งค่ารางวัลพิเศษให้มีขั้นตอนเสร็จสมบูรณ์ตามจำนวนที่กำหนดเป็นอย่างน้อย
ShowAllUI(ShowAllUICallback callback)
void
นำเสนอ UI ที่แสดงข้อมูลเกี่ยวกับรางวัลพิเศษทั้งหมดแก่ผู้ใช้
ShowAllUI()
void
เลิกใช้งานแล้ว เลือกใช้ ShowAllUI(ShowAllUICallback callback) แสดง UI แก่ผู้ใช้เพื่อแสดงข้อมูลเกี่ยวกับรางวัลพิเศษทั้งหมด UI แสดงแบบไม่พร้อมกันในทุกแพลตฟอร์ม
ShowAllUIBlocking()
นำเสนอ UI ที่แสดงข้อมูลเกี่ยวกับรางวัลพิเศษทั้งหมดแก่ผู้ใช้
ShowAllUIBlocking(Timeout timeout)
นำเสนอ UI ที่แสดงข้อมูลเกี่ยวกับรางวัลพิเศษทั้งหมดแก่ผู้ใช้
Unlock(const std::string & achievement_id)
void
ปลดล็อกรางวัลพิเศษสำหรับผู้เล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้

โครงสร้าง
gpg::AchievementManager::FetchAllResponse

เก็บข้อมูลทั้งหมดของรางวัลพิเศษทั้งหมดรวมถึงสถานะการตอบกลับ

gpg::AchievementManager::FetchResponse

มีข้อมูลและสถานะการตอบกลับสำหรับรางวัลพิเศษเดียว

ประเภทสาธารณะ

FetchAllCallback

std::function< void(const FetchAllResponse &)> FetchAllCallback

กำหนดประเภท Callback ที่ได้รับ FetchAllResponse

ประเภท Callback นี้ใช้ได้กับฟังก์ชัน FetchAll(*) ด้านล่าง

FetchCallback

std::function< void(const FetchResponse &)> FetchCallback

กำหนดประเภท Callback ที่ได้รับ FetchResponse

ประเภท Callback นี้ใช้ได้กับฟังก์ชัน Fetch(*) ด้านล่าง

ShowAllUICallback

std::function< void(const UIStatus &)> ShowAllUICallback

กำหนดประเภท Callback ที่ได้รับ UIStatus

ประเภท Callback นี้มีไว้สำหรับฟังก์ชัน ShowAllUI* ด้านล่าง

ฟังก์ชันสาธารณะ

เรียกข้อมูล

void Fetch(
  const std::string & achievement_id,
  FetchCallback callback
)

ไม่พร้อมกันจะโหลดข้อมูลของรางวัลพิเศษที่เฉพาะเจาะจงสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้

โทรหา FetchCallback ที่ระบุไว้เมื่อการดำเนินการเสร็จสิ้น การไม่ระบุ data_source จะทำให้การเรียกใช้ฟังก์ชันนี้เทียบเท่ากับการเรียกใช้ Fetch(DataSource data_source, const std::string& id, FetchCallback) ซึ่งมีการระบุ data_source เป็น CACHE_OR_NETWORK

เรียกข้อมูล

void Fetch(
  DataSource data_source,
  const std::string & achievement_id,
  FetchCallback callback
)

ไม่พร้อมกันจะโหลดข้อมูลของรางวัลพิเศษที่เฉพาะเจาะจงสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้

โทรหา FetchCallback ที่ระบุไว้เมื่อการดำเนินการเสร็จสิ้น ระบุ data_source เป็น CACHE_OR_NETWORK หรือ NETWORK_ONLY

FetchAll

void FetchAll(
  FetchAllCallback callback
)

โหลดข้อมูลรางวัลพิเศษทั้งหมดแบบไม่พร้อมกันสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้

โทรหา FetchAllCallback ที่ระบุไว้เมื่อการดำเนินการเสร็จสิ้น การไม่ระบุ data_source จะทำให้การเรียกใช้ฟังก์ชันนี้เทียบเท่ากับการเรียกใช้ FetchAll(DataSource data_source, FetchAllCallback) ซึ่งมีการระบุ data_source เป็น CACHE_OR_NETWORK

FetchAll

void FetchAll(
  DataSource data_source,
  FetchAllCallback callback
)

โหลดข้อมูลรางวัลพิเศษทั้งหมดแบบไม่พร้อมกันสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้

โทรหา FetchAllCallback ที่ระบุไว้เมื่อการดำเนินการเสร็จสิ้น ระบุ data_source เป็น CACHE_OR_NETWORK หรือ NETWORK_ONLY

FetchAllBlocking

FetchAllResponse FetchAllBlocking()

การโหลดข้อมูลรางวัลพิเศษทั้งหมดแบบพร้อมกันสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้ และแสดงผล FetchAllResponse โดยตรง

การระบุทั้ง data_source และ timeout จะทำให้การเรียกใช้ฟังก์ชันนี้เทียบเท่ากับการเรียกใช้ FetchAllResponse FetchAllBlocking(DataSource data_source, Timeout timeout) โดยที่ data_source ระบุเป็น CACHE_OR_NETWORK และ timeout ระบุเป็น 10 ปี

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source
)

การโหลดข้อมูลรางวัลพิเศษทั้งหมดแบบพร้อมกันสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้ และแสดงผล FetchAllResponse โดยตรง

ระบุ data_source เป็น CACHE_OR_NETWORK หรือ NETWORK_ONLY การไม่ระบุ timeout จะทำให้การเรียกใช้ฟังก์ชันนี้เทียบเท่ากับการเรียกใช้ FetchAllBlocking FetchAllResponse(DataSource data_source, Timeout timeout) ซึ่งมีค่า data_source ที่คุณระบุ และ timeout ระบุเป็น 10 ปี

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  Timeout timeout
)

การโหลดข้อมูลรางวัลพิเศษทั้งหมดแบบพร้อมกันสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้ และแสดงผล FetchAllResponse โดยตรง

ระบุ timeout เป็นจำนวนมิลลิวินาทีได้ตามต้องการ การไม่ระบุ data_source จะทำให้การเรียกใช้ฟังก์ชันนี้เทียบเท่ากับการเรียกใช้ FetchAllResponse FetchAllBlocking(DataSource data_source, Timeout timeout) โดยมีการระบุ data_source เป็น CACHE_OR_NETWORK และ timeout มีค่าที่ระบุ

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source,
  Timeout timeout
)

การโหลดข้อมูลรางวัลพิเศษทั้งหมดแบบพร้อมกันสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้ และแสดงผล FetchAllResponse โดยตรง

ระบุ data_source เป็น CACHE_OR_NETWORK หรือ NETWORK_ONLY ระบุระยะหมดเวลาเป็นจำนวนมิลลิวินาทีได้ตามต้องการ

FetchBlocking

FetchResponse FetchBlocking(
  const std::string & achievement_id
)

โหลดข้อมูลแบบซิงโครนัสของรางวัลพิเศษที่เฉพาะเจาะจงซึ่งระบุโดยรหัสสตริงสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้ในปัจจุบัน จะแสดงผล FetchResponse โดยตรง

การไม่ระบุ data_source และ timeout จะทำให้การเรียกใช้ฟังก์ชันนี้เทียบเท่ากับการเรียกใช้ FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id) โดยที่ data_source ระบุเป็น CACHE_OR_NETWORK และ timeout ระบุเป็น 10 ปี

FetchBlocking

FetchResponse FetchBlocking(
  DataSource data_source,
  const std::string & achievement_id
)

โหลดข้อมูลแบบซิงโครนัสของรางวัลพิเศษที่เฉพาะเจาะจงซึ่งระบุโดยรหัสสตริงสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้ในปัจจุบัน จะแสดงผล FetchResponse โดยตรง

ระบุ data_source เป็น CACHE_OR_NETWORK หรือ NETWORK_ONLY การไม่ระบุ timeout จะทำให้การเรียกใช้ฟังก์ชันนี้เทียบเท่ากับการเรียกใช้ FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id) ซึ่งมีค่า data_source ที่คุณระบุ และ timeout ระบุเป็น 10 ปี

FetchBlocking

FetchResponse FetchBlocking(
  Timeout timeout,
  const std::string & achievement_id
)

โหลดข้อมูลแบบซิงโครนัสของรางวัลพิเศษที่เฉพาะเจาะจงซึ่งระบุโดยรหัสสตริงสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้ในปัจจุบัน จะแสดงผล FetchResponse โดยตรง

ระบุ timeout เป็นจำนวนมิลลิวินาทีได้ตามต้องการ การไม่ระบุ data_source จะทำให้การเรียกใช้ฟังก์ชันนี้เทียบเท่ากับการเรียกใช้ FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id) ซึ่งระบุ data_source เป็น CACHE_OR_NETWORK และ timeout มีค่าที่ระบุ

FetchBlocking

FetchResponse FetchBlocking(
  DataSource data_source,
  Timeout timeout,
  const std::string & achievement_id
)

โหลดข้อมูลแบบซิงโครนัสของรางวัลพิเศษที่เฉพาะเจาะจงซึ่งระบุโดยรหัสสตริงสำหรับโปรแกรมเล่นที่ลงชื่อเข้าใช้ในปัจจุบัน จะแสดงผล FetchResponse โดยตรง

ระบุ data_source เป็น CACHE_OR_NETWORK หรือ NETWORK_ONLY ระบุ timeout เป็นจำนวนมิลลิวินาทีได้ตามต้องการ

การเพิ่ม

void Increment(
  const std::string & achievement_id
)

เพิ่มรางวัลพิเศษตามจำนวนขั้นตอนที่กำหนด

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

การเพิ่ม

void Increment(
  const std::string & achievement_id,
  uint32_t steps
)

เพิ่มรางวัลพิเศษตามจำนวนขั้นตอนที่กำหนด

รางวัลพิเศษต้องเป็นรางวัลพิเศษแบบเพิ่มขึ้นเรื่อยๆ เมื่อรางวัลพิเศษมีขั้นตอนถึงจำนวนขั้นต่ำเป็นอย่างต่ำแล้ว รางวัลพิเศษจะปลดล็อกโดยอัตโนมัติ ระบบจะไม่สนใจการเพิ่มอื่นๆ อีก

แสดง

void Reveal(
  const std::string & achievement_id
)

แสดงรางวัลพิเศษที่ซ่อนอยู่ให้ผู้เล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้

หากมีการปลดล็อกรางวัลพิเศษแล้ว จะไม่มีผลกระทบใดๆ

SetStepsAtLeast

void SetStepsAtLeast(
  const std::string & achievement_id,
  uint32_t steps
)

ตั้งค่ารางวัลพิเศษให้มีขั้นตอนเสร็จสมบูรณ์ตามจำนวนที่กำหนดเป็นอย่างน้อย

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

ShowAllUI

void ShowAllUI(
  ShowAllUICallback callback
)

นำเสนอ UI ที่แสดงข้อมูลเกี่ยวกับรางวัลพิเศษทั้งหมดแก่ผู้ใช้

เรียกใช้ ShowAllUICallback แบบไม่พร้อมกัน

ShowAllUI

void ShowAllUI()

เลิกใช้งานแล้ว เลือกใช้ ShowAllUI(ShowAllUICallback callback) แสดง UI แก่ผู้ใช้เพื่อแสดงข้อมูลเกี่ยวกับรางวัลพิเศษทั้งหมด UI แสดงแบบไม่พร้อมกันในทุกแพลตฟอร์ม

ShowAllUIBlocking

UIStatus ShowAllUIBlocking()

นำเสนอ UI ที่แสดงข้อมูลเกี่ยวกับรางวัลพิเศษทั้งหมดแก่ผู้ใช้

แสดงผล UIStatus พร้อมกัน การไม่ระบุ timeout จะทำให้การเรียกใช้ฟังก์ชันนี้เทียบเท่ากับการเรียกใช้ ShowAllUIBlocking(Timeout timeout) ด้วย timeout ที่ระบุว่าเป็น 10 ปี

ShowAllUIBlocking

UIStatus ShowAllUIBlocking(
  Timeout timeout
)

นำเสนอ UI ที่แสดงข้อมูลเกี่ยวกับรางวัลพิเศษทั้งหมดแก่ผู้ใช้

แสดงผล UIStatus พร้อมกัน ระบุ timeout เป็นจำนวนมิลลิวินาทีได้ตามต้องการ

ปลดล็อก

void Unlock(
  const std::string & achievement_id
)

ปลดล็อกรางวัลพิเศษสำหรับผู้เล่นที่ลงชื่อเข้าใช้อยู่ในขณะนี้

หากรางวัลพิเศษซ่อนอยู่ SDK จะแสดงรางวัลพิเศษนั้นด้วย