gpg::AchievementManager

#include <achievement_manager.h>

Lấy và đặt 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 được FetchAllResponse.
FetchCallback typedef
std::function< void(const FetchResponse &)>
Xác định loại lệnh gọi lại nhận được FetchResponse.
ShowAllUICallback typedef
std::function< void(const UIStatus &)>
Xác định loại lệnh gọi lại nhận được UIStatus.

Hàm công khai
Fetch(const std::string & achievement_id, FetchCallback callback)
void
Tải dữ liệu một cách không đồng bộ về một thành tích cụ thể cho người chơi hiện đang đăng nhập.
Fetch(DataSource data_source, const std::string & achievement_id, FetchCallback callback)
void
Tải dữ liệu một cách không đồng bộ về một thành tích cụ thể cho người chơi hiện đang đă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 đang đă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 đang đăng nhập.
FetchAllBlocking()
Tải đồng bộ tất cả dữ liệu thành tích cho 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 cho 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 cho 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 cho người chơi hiện đã đăng nhập, trực tiếp trả về FetchAllResponse.
FetchBlocking(const std::string & achievement_id)
Tải dữ liệu đồng bộ 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 dữ liệu đồng bộ 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 dữ liệu đồng bộ 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 dữ liệu đồng bộ 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ị 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 phải hoàn thành ít nhất số bước đã cho.
ShowAllUI(ShowAllUICallback callback)
void
Hiển thị cho người dùng một 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(lệnh gọi lại ShowAllUICallback). Hiển thị 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()
Hiển thị cho người dùng một 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)
Hiển thị cho người dùng một 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á 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 cho tất 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 duy nhất.

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 được 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 được 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 được UIStatus.

Loại lệnh 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 một cách không đồng bộ về một thành tích cụ thể cho người chơi hiện đang đăng nhập.

Gọi FetchCallback được cung cấp khi hoàn tất thao tác. Nếu không chỉ định data_source, lệnh gọi hàm này sẽ tương đương với việc gọi Fetch(DataSource data_source, const std::string& id, FetchCallback), trong đó 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 một cách không đồng bộ về một thành tích cụ thể cho người chơi hiện đang đăng nhập.

Gọi FetchCallback được cung cấp khi hoàn tất thao tác. Hãy chỉ định data_source dưới dạng 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 đang đăng nhập.

Gọi FetchAllCallback được cung cấp khi hoàn tất thao tác. Nếu không chỉ định data_source, lệnh gọi hàm này sẽ tương đương với việc gọi FetchAll(DataSource data_source, FetchAllCallback), trong đó 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 đang đăng nhập.

Gọi FetchAllCallback đượ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.

FetchAllBlocking

FetchAllResponse FetchAllBlocking()

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

Việc chỉ định cả data_source và timeout sẽ làm cho 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 cho 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. Nếu bạn không chỉ định timeout, lệnh gọi hàm này sẽ được chỉ định 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 cho người chơi hiện đã đăng nhập, trực tiếp trả về FetchAllResponse.

Chỉ định timeout dưới dạng số mili giây tuỳ ý. Nếu không chỉ định data_source, lệnh gọi hàm này sẽ 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 chứa giá trị mà bạn đã chỉ định.

FetchAllBlocking

FetchAllResponse FetchAllBlocking(
  DataSource data_source,
  Timeout timeout
)

Tải đồng bộ tất cả dữ liệu thành tích cho 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 số mili giây tuỳ ý.

FetchBlocking

FetchResponse FetchBlocking(
  const std::string & achievement_id
)

Tải dữ liệu đồng bộ 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, 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), trong đó 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 dữ liệu đồng bộ 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, 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 dữ liệu đồng bộ 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.

Chỉ định timeout dưới dạng số mili giây tuỳ ý. Nếu không chỉ định data_source, 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), trong đó data_source được chỉ định là CACHE_OR_NETWORK và timeout chứa giá trị mà bạn đã chỉ định.

FetchBlocking

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

Tải dữ liệu đồng bộ 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. Chỉ định timeout dưới dạng 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.

Nếu bạn không xác định giá trị gia số, thì giá trị của số đó sẽ mặc định là 1. Thành tích phải là một thành tích gia tăng. Khi đạt đến số bước tối đa, thành tích sẽ tự động được mở khoá. Mọi trị số tăng thêm 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 gia tăng. Khi đạt đến ít nhất số bước tối đa, thành tích sẽ được mở khoá tự động. Mọi trị số tăng thêm sẽ bị bỏ qua.

Hé mở

void Reveal(
  const std::string & achievement_id
)

Hiển thị 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á, thao tá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 phải hoàn thành ít nhất số bước đã cho.

Nếu gọi phương thức này trong khi thành tích đã có nhiều bước hơn giá trị được cung cấp, thì thành tích sẽ 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 thay đổi khác sẽ bị bỏ qua.

ShowAllUI

void ShowAllUI(
  ShowAllUICallback callback
)

Hiển thị cho người dùng một 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 gọi ShowAllUICallback không đồng bộ.

ShowAllUI

void ShowAllUI()

Không dùng nữa. Ưu tiên ShowAllUI(lệnh gọi lại ShowAllUICallback). Hiển thị 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()

Hiển thị cho người dùng một 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 trả về đồng bộ một UIStatus. Nếu bạn không chỉ định timeout, lệnh gọi hàm này sẽ tương đương với việc gọi ShowAllUIBlocking(Timeout timeout) bằng timeout được chỉ định là 10 năm.

ShowAllUIBlocking

UIStatus ShowAllUIBlocking(
  Timeout timeout
)

Hiển thị cho người dùng một 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 trả về đồng bộ một UIStatus. Chỉ định timeout dưới dạng số mili giây tuỳ ý.

Mở khoá

void Unlock(
  const std::string & achievement_id
)

Mở khoá 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 đó.