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)
|
|
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ộ.
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àm này chỉ có thể được gọi 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àm này chỉ có thể được gọi 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.
LastModifiedTime
Timestamp LastModifiedTime() const
Trả về thời gian mà mục nhập được sửa đổi 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àm này chỉ có thể được gọi 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àm này chỉ có thể được gọi 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àm này chỉ có thể được gọi 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()