gpg::AchievementManager

#include <achievement_manager.h>

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

สรุป

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

FetchAllCallback typedef
std::function< void(const FetchAllResponse &)>
กำหนดประเภทโค้ดเรียกกลับที่ได้รับ FetchAllResponse
FetchCallback typedef
std::function< void(const FetchResponse &)>
กำหนดประเภทโค้ดเรียกกลับที่ได้รับ FetchResponse
ShowAllUICallback typedef
std::function< void(const UIStatus &)>
กำหนดประเภทโค้ดเรียกกลับที่ได้รับ 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

กำหนดประเภทโค้ดเรียกกลับที่ได้รับ FetchAllResponse

ฟังก์ชัน FetchAll(*) ด้านล่างมีโค้ดเรียกกลับประเภทนี้

FetchCallback

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

กำหนดประเภทโค้ดเรียกกลับที่ได้รับ FetchResponse

ฟังก์ชัน Fetch(*) ด้านล่างมีโค้ดเรียกกลับประเภทนี้

ShowAllUICallback

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

กำหนดประเภทโค้ดเรียกกลับที่ได้รับ UIStatus

ประเภทโค้ดเรียกกลับนี้มีให้กับฟังก์ชัน 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 จะแสดงรางวัลพิเศษด้วย