gpg::AchievementManager

#include <achievement_manager.h>

Lấy và thiết lập nhiều dữ liệu liên quan đến thành tích.

Tóm tắt

Loại công khai
FetchAllCallback typedef
std::function< void(const FetchAllResponse &)>
Xác định loại lệnh gọi lại nhận FetchAllResponse.
FetchCallback typedef
std::function< void(const FetchResponse &)>
Xác định loại lệnh gọi lại nhận FetchResponse.
ShowAllUICallback typedef
std::function< void(const UIStatus &)>
Xác định loại lệnh gọi lại nhận UIStatus.

Hàm công khai
Fetch(const std::string & achievement_id, FetchCallback callback)
void
Tải dữ liệu không đồng bộ cho một thành tích cụ thể của người chơi hiện đã đăng nhập.
Fetch(DataSource data_source, const std::string & achievement_id, FetchCallback callback)
void
Tải dữ liệu không đồng bộ cho một thành tích cụ thể của người chơi hiện đã đăng nhập.
FetchAll(FetchAllCallback callback)
void
Tải không đồng bộ tất cả dữ liệu thành tích cho người chơi hiện đã đăng nhập.
FetchAll(DataSource data_source, FetchAllCallback callback)
void
Tải không đồng bộ tất cả dữ liệu thành tích cho người chơi hiện đã đăng nhập.
FetchAllBlocking()
Tải đồng bộ tất cả dữ liệu thành tích của người chơi hiện đã đăng nhập, trực tiếp trả về FetchAllResponse.
FetchAllBlocking(DataSource data_source)
Tải đồng bộ tất cả dữ liệu thành tích của người chơi hiện đã đăng nhập, trực tiếp trả về FetchAllResponse.
FetchAllBlocking(Timeout timeout)
Tải đồng bộ tất cả dữ liệu thành tích của người chơi hiện đã đăng nhập, trực tiếp trả về FetchAllResponse.
FetchAllBlocking(DataSource data_source, Timeout timeout)
Tải đồng bộ tất cả dữ liệu thành tích của người chơi hiện đã đăng nhập, trực tiếp trả về FetchAllResponse.
FetchBlocking(const std::string & achievement_id)
Tải đồng bộ dữ liệu cho một thành tích cụ thể, được xác định bằng mã chuỗi, cho người chơi hiện đã đăng nhập; trực tiếp trả về FetchResponse.
FetchBlocking(DataSource data_source, const std::string & achievement_id)
Tải đồng bộ dữ liệu cho một thành tích cụ thể, được xác định bằng mã chuỗi, cho người chơi hiện đã đăng nhập; trực tiếp trả về FetchResponse.
FetchBlocking(Timeout timeout, const std::string & achievement_id)
Tải đồng bộ dữ liệu cho một thành tích cụ thể, được xác định bằng mã chuỗi, cho người chơi hiện đã đăng nhập; trực tiếp trả về FetchResponse.
FetchBlocking(DataSource data_source, Timeout timeout, const std::string & achievement_id)
Tải đồng bộ dữ liệu cho một thành tích cụ thể, được xác định bằng mã chuỗi, cho người chơi hiện đã đăng nhập; trực tiếp trả về FetchResponse.
Increment(const std::string & achievement_id)
void
Tăng thành tích theo số bước đã cho.
Increment(const std::string & achievement_id, uint32_t steps)
void
Tăng thành tích theo số bước đã cho.
Reveal(const std::string & achievement_id)
void
Hiển thị một thành tích bị ẩn cho người chơi hiện đang đăng nhập.
SetStepsAtLeast(const std::string & achievement_id, uint32_t steps)
void
Thiết lập một thành tích để hoàn thành ít nhất số bước đã cho.
ShowAllUI(ShowAllUICallback callback)
void
Trình bày cho người dùng giao diện người dùng hiển thị thông tin về tất cả các thành tích.
ShowAllUI()
void
Không dùng nữa. Ưu tiên ShowAllUI(ShowAllUICallback gọi lại). Trình bày giao diện người dùng cho người dùng, hiển thị thông tin về tất cả các thành tích. Giao diện người dùng hiển thị không đồng bộ trên tất cả các nền tảng.
ShowAllUIBlocking()
Trình bày cho người dùng giao diện người dùng hiển thị thông tin về tất cả các thành tích.
ShowAllUIBlocking(Timeout timeout)
Trình bày cho người dùng giao diện người dùng hiển thị thông tin về tất cả các thành tích.
Unlock(const std::string & achievement_id)
void
Mở khoá một thành tích cho người chơi hiện đang đăng nhập.

Cấu trúc
gpg::AchievementManager::FetchAllResponse

Lưu giữ tất cả dữ liệu của tất cả các thành tích, cùng với trạng thái phản hồi.

gpg::AchievementManager::FetchResponse

Chứa dữ liệu và trạng thái phản hồi của một thành tích.

Loại công khai

FetchAllCallback

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

Xác định loại lệnh gọi lại nhận FetchAllResponse.

Loại lệnh gọi lại này được cung cấp cho các hàm FetchAll(*) dưới đây.

FetchCallback

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

Xác định loại lệnh gọi lại nhận FetchResponse.

Loại lệnh gọi lại này được cung cấp cho các hàm Fetch(*) dưới đây.

ShowAllUICallback

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

Xác định loại lệnh gọi lại nhận UIStatus.

Loại gọi lại này được cung cấp cho hàm ShowAllUI* bên dưới.

Hàm công khai

Tìm nạp

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

Tải dữ liệu không đồng bộ cho một thành tích cụ thể của người chơi hiện đã đăng nhập.

Gọi FetchCallback đã cung cấp sau khi hoàn tất thao tác. Việc không chỉ định data_source sẽ khiến lệnh gọi hàm này tương đương với việc gọi Fetch(DataSource data_source, const std::string& id, FetchCallback), với data_source được chỉ định là CACHE_OR_NETWORK.

Tìm nạp

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

Tải dữ liệu không đồng bộ cho một thành tích cụ thể của người chơi hiện đã đăng nhập.

Gọi FetchCallback được cung cấp khi hoàn tất thao tác. Hãy chỉ định data_source là CACHE_OR_NETWORK hoặc NETWORK_ONLY.

FetchAll

void FetchAll(
  FetchAllCallback callback
)

Tải không đồng bộ tất cả dữ liệu thành tích cho người chơi hiện đã đăng nhập.

Gọi FetchAllCallback đã cung cấp sau khi hoàn tất thao tác. Việc không chỉ định data_source sẽ khiến lệnh gọi hàm này tương đương với việc gọi FetchAll(DataSource data_source, FetchAllCallback), với data_source được chỉ định là CACHE_OR_NETWORK.

FetchAll

void FetchAll(
  DataSource data_source,
  FetchAllCallback callback
)

Tải không đồng bộ tất cả dữ liệu thành tích cho người chơi hiện đã đăng nhập.

Gọi FetchAllCallback đã cung cấp sau khi hoàn tất thao tác. Hãy chỉ định data_source là CACHE_OR_NETWORK hoặc NETWORK_ONLY.

FetchAllBlocking

FetchAllResponse FetchAllBlocking()

Tải đồng bộ tất cả dữ liệu thành tích của người chơi hiện đã đăng nhập, trực tiếp trả về FetchAllResponse.

Việc chỉ định data_source và timeout sẽ khiến lệnh gọi hàm này tương đương với việc gọi FetchAllResponse FetchAllBlocking(DataSource data_source, Timeout timeout), trong đó data_source được chỉ định là CACHE_OR_NETWORK và timeout được chỉ định là 10 năm.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source
)

Tải đồng bộ tất cả dữ liệu thành tích của người chơi hiện đã đăng nhập, trực tiếp trả về FetchAllResponse.

Hãy chỉ định data_source là CACHE_OR_NETWORK hoặc NETWORK_ONLY. Việc không chỉ định timeout sẽ khiến lệnh gọi hàm này tương đương với việc gọi FetchAllBlocking FetchAllResponse(DataSource data_source, Timeout timeout), với giá trị data_source được chỉ định và timeout được chỉ định là 10 năm.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  Timeout timeout
)

Tải đồng bộ tất cả dữ liệu thành tích của người chơi hiện đã đăng nhập, trực tiếp trả về FetchAllResponse.

Hãy chỉ định timeout dưới dạng một số mili giây tuỳ ý. Việc không chỉ định data_source sẽ khiến lệnh gọi hàm này tương đương với việc gọi FetchAllResponse FetchAllBlocking(DataSource data_source, Timeout timeout), với data_source được chỉ định là CACHE_OR_NETWORK và timeout chứa giá trị đã chỉ định.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source,
  Timeout timeout
)

Tải đồng bộ tất cả dữ liệu thành tích của người chơi hiện đã đăng nhập, trực tiếp trả về FetchAllResponse.

Hãy chỉ định data_source là CACHE_OR_NETWORK hoặc NETWORK_ONLY. Chỉ định thời gian chờ dưới dạng một số mili giây tuỳ ý.

FetchBlocking

FetchResponse FetchBlocking(
  const std::string & achievement_id
)

Tải đồng bộ dữ liệu cho một thành tích cụ thể, được xác định bằng mã chuỗi, cho người chơi hiện đã đăng nhập; trực tiếp trả về FetchResponse.

Nếu bạn không chỉ định data_source và timeout, thì lệnh gọi hàm này tương đương với việc gọi FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id), với data_source được chỉ định là CACHE_OR_NETWORK và timeout được chỉ định là 10 năm.

FetchBlocking

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

Tải đồng bộ dữ liệu cho một thành tích cụ thể, được xác định bằng mã chuỗi, cho người chơi hiện đã đăng nhập; trực tiếp trả về FetchResponse.

Hãy chỉ định data_source là CACHE_OR_NETWORK hoặc NETWORK_ONLY. Nếu bạn không chỉ định timeout, thì lệnh gọi hàm này sẽ tương đương với việc gọi FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id), với giá trị data_source được chỉ định và timeout được chỉ định là 10 năm.

FetchBlocking

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

Tải đồng bộ dữ liệu cho một thành tích cụ thể, được xác định bằng mã chuỗi, cho người chơi hiện đã đăng nhập; trực tiếp trả về FetchResponse.

Hãy chỉ định timeout dưới dạng một số mili giây tuỳ ý. Nếu bạn không chỉ định data_source, thì lệnh gọi hàm này tương đương với việc gọi FetchResponse FetchBlocking(DataSource data_source, Timeout timeout, const std::string& id), với data_source được chỉ định là CACHE_OR_NETWORK và timeout chứa giá trị đã chỉ định.

FetchBlocking

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

Tải đồng bộ dữ liệu cho một thành tích cụ thể, được xác định bằng mã chuỗi, cho người chơi hiện đã đăng nhập; trực tiếp trả về FetchResponse.

Hãy chỉ định data_source là CACHE_OR_NETWORK hoặc NETWORK_ONLY. Hãy chỉ định timeout dưới dạng một số mili giây tuỳ ý.

Tăng dần

void Increment(
  const std::string & achievement_id
)

Tăng thành tích theo số bước đã cho.

Việc không xác định mức tăng sẽ khiến giá trị mặc định là 1. Thành tích phải là một thành tích tăng dần. Khi đạt đến số bước tối đa, thành tích sẽ được mở khóa tự động. Mọi gia số sau đó sẽ bị bỏ qua.

Tăng dần

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

Tăng thành tích theo số bước đã cho.

Thành tích phải là một thành tích tăng dần. Khi một thành tích đạt đến số bước tối đa, ít nhất nó sẽ được mở khóa tự động. Mọi gia số sau đó sẽ bị bỏ qua.

Hiển thị

void Reveal(
  const std::string & achievement_id
)

Hiển thị một thành tích bị ẩn cho người chơi hiện đang đăng nhập.

Nếu thành tích đã được mở khoá, việc này sẽ không có hiệu lực.

SetStepsAtLeast

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

Thiết lập một thành tích để hoàn thành ít nhất số bước đã cho.

Gọi phương thức này trong khi thành tích đã có nhiều bước hơn so với giá trị đã cung cấp là không hoạt động. Sau khi thành tích đạt đến số bước tối đa, thành tích sẽ tự động được mở khóa và mọi hoạt động đột biến tiếp theo đều bị bỏ qua.

ShowAllUI

void ShowAllUI(
  ShowAllUICallback callback
)

Trình bày cho người dùng giao diện người dùng hiển thị thông tin về tất cả các thành tích.

Phương thức này gọi ShowAllUICallback không đồng bộ.

ShowAllUI

void ShowAllUI()

Không dùng nữa. Ưu tiên ShowAllUI(ShowAllUICallback gọi lại). Trình bày giao diện người dùng cho người dùng, hiển thị thông tin về tất cả các thành tích. Giao diện người dùng hiển thị không đồng bộ trên tất cả các nền tảng.

ShowAllUIBlocking

UIStatus ShowAllUIBlocking()

Trình bày cho người dùng giao diện người dùng hiển thị thông tin về tất cả các thành tích.

Hàm này sẽ trả về UIStatus một cách đồng bộ. Việc không chỉ định timeout sẽ khiến lệnh gọi hàm này tương đương với việc gọi ShowAllUIBlocking(Timeout timeout) với timeout được chỉ định là 10 năm.

ShowAllUIBlocking

UIStatus ShowAllUIBlocking(
  Timeout timeout
)

Trình bày cho người dùng giao diện người dùng hiển thị thông tin về tất cả các thành tích.

Hàm này sẽ trả về UIStatus một cách đồng bộ. Hãy chỉ định timeout dưới dạng một số mili giây tuỳ ý.

Mở khoá

void Unlock(
  const std::string & achievement_id
)

Mở khoá một thành tích cho người chơi hiện đang đăng nhập.

Nếu thành tích bị ẩn, SDK cũng sẽ tiết lộ thành tích đó.