gpg::Achievement

#include <achievement.h>

Một cấu trúc dữ liệu đơn lẻ cho phép bạn truy cập dữ liệu về trạng thái của một thành tích cụ thể.

Tóm tắt

Dữ liệu bao gồm hai loại: dành riêng cho người dùng (ví dụ: liệu người dùng đã đạt được thành tích hay chưa, v.v.) và dữ liệu chung (ví dụ: tên thành tích).

Hàm khởi tạo và phá huỷ
Achievement()
Achievement(std::shared_ptr< const AchievementImpl > impl)
Tạo Thành tích từ shared_ptr thành AchievementImpl.Dành cho API sử dụng nội bộ.
Achievement(const Achievement & copy_from)
Tạo bản sao của một Thành tích hiện có.
Achievement(Achievement && move_from)
Di chuyển một Thành tích hiện có.
~Achievement()

Hàm công khai
CurrentSteps() const
uint32_t
Trả về số bước mà người chơi đã thực hiện để đạt được một thành tích tăng dần.
Description() const
const std::string &
Trả về nội dung mô tả ngắn gọn về thành tích của bạn.
Id() const
const std::string &
Trả về chuỗi duy nhất mà Bảng điều khiển dành cho nhà phát triển trên Google Play đã tạo trước đó.
LastModified() const Không dùng nữa. Ưu tiên LastModifiedTime.
LastModifiedTime() const
Trả về thời gian sửa đổi mục nhập lần gần đây nhất (được biểu thị dưới dạng mili giây kể từ thời gian bắt đầu của hệ thống Unix).
Name() const
const std::string &
Trả về tên ngắn của thành tích.
RevealedIconUrl() const
const std::string &
Trả về URL dẫn đến hình ảnh của biểu tượng được tiết lộ cho Thành tích này.
State() const
Trả về trạng thái thành tích: HIDDEN, REVEALED hoặc UNLOCKED.
TotalSteps() const
uint32_t
Trả về tổng số bước cần thiết để người chơi đạt được một thành tích tăng dần nhất định.
Type() const
Trả về loại thành tích: INCREMENTAL hoặc STANDARD.
UnlockedIconUrl() const
const std::string &
Trả về URL dẫn đến hình ảnh của biểu tượng đã mở khoá cho Thành tích này.
Valid() const
bool
Trả về true khi thành tích trả về được điền sẵn dữ liệu và kèm theo trạng thái phản hồi thành công; false cho thành tích do người dùng tạo không được điền sẵn hoặc cho thành tích được điền sẵn kèm theo trạng thái phản hồi không thành công.
XP() const
uint64_t
Số điểm kinh nghiệm có được nhờ thành tích này.
operator=(const Achievement & copy_from)
Chỉ định Thành tích này bằng cách sao chép từ một thành tích khác.
operator=(Achievement && move_from)
Chỉ định Thành tích này bằng cách di chuyển một thành tích khác vào.

Hàm công khai

Thành tích

 Achievement()

Thành tích

 Achievement(
  std::shared_ptr< const AchievementImpl > impl
)

Tạo Thành tích từ shared_ptr thành AchievementImpl.Dành cho API sử dụng nội bộ.

Thành tích

 Achievement(
  const Achievement & copy_from
)

Tạo bản sao của một Thành tích hiện có.

Thành tích

 Achievement(
  Achievement && move_from
)

Di chuyển một Thành tích hiện có.

CurrentSteps

uint32_t CurrentSteps() const

Trả về số bước mà người chơi đã thực hiện để đạt được một thành tích tăng dần.

Hệ thống chỉ có thể gọi lệnh khi Achievement::Valid() trả về giá trị true.

Mô tả

const std::string & Description() const

Trả về nội dung mô tả ngắn gọn về thành tích của bạn.

Thường cho người chơi biết cách đạt được thành tích. Tối đa 500 ký tự. Hệ thống chỉ có thể gọi lệnh khi Achievement::Valid() trả về giá trị true.

Id

const std::string & Id() const

Trả về chuỗi duy nhất mà Bảng điều khiển dành cho nhà phát triển trên Google Play đã tạo trước đó.

Hãy dùng thuộc tính này để tham chiếu đến một thành tích trong ứng dụng trò chơi của bạn. Hệ thống chỉ có thể gọi lệnh khi Achievement::Valid() trả về giá trị true.

LastModified

Timestamp LastModified() const

Không dùng nữa. Ưu tiên LastModifiedTime.

LastModifiedTime

Timestamp LastModifiedTime() const

Trả về thời gian sửa đổi mục nhập lần gần đây nhất (được biểu thị dưới dạng mili giây kể từ thời gian bắt đầu của hệ thống Unix).

Hệ thống chỉ có thể gọi lệnh khi Achievement::Valid() trả về giá trị true.

Tên

const std::string & Name() const

Trả về tên ngắn của thành tích.

Tối đa 100 ký tự. Hệ thống chỉ có thể gọi lệnh khi Achievement::Valid() trả về giá trị true.

RevealedIconUrl

const std::string & RevealedIconUrl() const

Trả về URL dẫn đến hình ảnh của biểu tượng được tiết lộ cho Thành tích này.

Biểu tượng này sẽ xuất hiện khi Thành tích đã được công bố nhưng chưa được mở khóa. Hàm này chỉ có thể được gọi khi Achievement::Valid() trả về true.

Tiểu bang

AchievementState State() const

Trả về trạng thái thành tích: HIDDEN, REVEALED hoặc UNLOCKED.

Hệ thống chỉ có thể gọi lệnh khi Achievement::Valid() trả về giá trị true. Bạn có thể xem thêm thông tin tại đây.

TotalSteps

uint32_t TotalSteps() const

Trả về tổng số bước cần thiết để người chơi đạt được một thành tích tăng dần nhất định.

Hệ thống chỉ có thể gọi lệnh khi Achievement::Valid() trả về giá trị true.

Loại

AchievementType Type() const

Trả về loại thành tích: INCREMENTAL hoặc STANDARD.

Hệ thống chỉ có thể gọi lệnh khi Achievement::Valid() trả về giá trị true. Bạn có thể xem thêm thông tin tại đây.

UnlockedIconUrl

const std::string & UnlockedIconUrl() const

Trả về URL dẫn đến hình ảnh của biểu tượng đã mở khoá cho Thành tích này.

Biểu tượng này sẽ được hiển thị khi Thành tích đã được mở khóa (và do đó cũng được tiết lộ). Hàm này chỉ có thể được gọi khi Achievement::Valid() trả về true.

Hợp lệ

bool Valid() const

Trả về true khi thành tích trả về được điền sẵn dữ liệu và kèm theo trạng thái phản hồi thành công; false cho thành tích do người dùng tạo không được điền sẵn hoặc cho thành tích được điền sẵn kèm theo trạng thái phản hồi không thành công.

Để sử dụng được các hàm getter trên thành tích này (id, Tên, Mô tả, v.v.).

XP

uint64_t XP() const

Số điểm kinh nghiệm có được nhờ thành tích này.

Hệ thống chỉ có thể gọi lệnh khi Achievement::Valid() trả về giá trị true.

operator=

Achievement & operator=(
  const Achievement & copy_from
)

Chỉ định Thành tích này bằng cách sao chép từ một thành tích khác.

operator=

Achievement & operator=(
  Achievement && move_from
)

Chỉ định Thành tích này bằng cách di chuyển một thành tích khác vào.

~Achievement

 ~Achievement()