gpg:: Thành tích
#include <achievement.h>
Một cấu trúc dữ liệu duy nhất 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 đã mở khoá 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à hàm phá |
|
---|---|
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 gia tăng.
|
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 mà mục nhập được sửa đổi lần gần đây nhất (được biểu thị bằ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 biểu tượng đã hiển thị 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 gia tăng cho trước.
|
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 biểu tượng đã mở khoá cho Thành tích này.
|
Valid() const
|
bool
Trả về true khi thành tích được trả về được điền sẵn dữ liệu và đi kèm với 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 chưa được điền hoặc cho thành tích đã điền sẵn đi kèm trạng thái phản hồi không thành công.
|
XP() const
|
uint64_t
Số điểm kinh nghiệm mà thành tích này nhận được.
|
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)
|
Giao Thành tích này bằng cách 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 một Thành tích từ shared_ptr
đến 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 gia tăng.
Phương thức này chỉ có thể được gọi khi Achievement::Valid() trả về giá trị true.
Nội dung 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 hướng dẫn người chơi cách đạt thành tích. Tối đa 500 ký tự. Phương thức này chỉ có thể được gọi khi Achievement::Valid() trả về giá trị true.
Mã nhận dạng
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 để đề cập đến một thành tích trong ứng dụng trò chơi của bạn. Phương thức này chỉ có thể được gọi 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ị bằng mili giây kể từ thời gian bắt đầu của hệ thống Unix).
Phương thức này chỉ có thể được gọi 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ự. Phương thức này chỉ có thể được gọi khi Achievement::Valid() trả về giá trị true.
RevealedIconUrl
const std::string & RevealedIconUrl() const
Trả về URL dẫn đến hình ảnh biểu tượng đã hiển thị cho Thành tích này.
Biểu tượng này nhằm mục đích hiển thị khi Thành tích đã xuất hiện nhưng chưa được mở khóa. Hệ thống chỉ có thể gọi hàm này khi Achievement::Valid() trả về giá trị true.
Tiểu bang
AchievementState State() const
Trả về trạng thái thành tích: HIDDEN
, REVEALED
hoặc UNLOCKED
.
Phương thức này chỉ có thể được gọi khi Achievement::Valid() trả về giá trị true. Tìm hiểu 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 gia tăng cho trước.
Phương thức 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
.
Phương thức này chỉ có thể được gọi khi Achievement::Valid() trả về giá trị true. Tìm hiểu thêm thông tin tại đây.
UnlockedIconUrl
const std::string & UnlockedIconUrl() const
Trả về URL dẫn đến hình ảnh biểu tượng đã mở khoá cho Thành tích này.
Biểu tượng này nhằm mục đích hiển thị khi Thành tích đã được mở khóa (và cũng được hiển thị). Hệ thống chỉ có thể gọi hàm này khi Achievement::Valid() trả về giá trị true.
Hợp lệ
bool Valid() const
Trả về true khi thành tích được trả về được điền sẵn dữ liệu và đi kèm với 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 chưa được điền hoặc cho thành tích đã điền sẵn đi kèm trạng thái phản hồi không thành công.
Giá trị phải đúng để các hàm getter trên thành tích này (id, Name, Description, v.v.) phải sử dụng được.
XP
uint64_t XP() const
Số điểm kinh nghiệm mà thành tích này nhận được.
Phương thức này chỉ có thể được gọi khi Achievement::Valid() trả về giá trị true.
toán tử=
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.
toán tử=
Achievement & operator=( Achievement && move_from )
Giao Thành tích này bằng cách chuyển một thành tích khác vào đó.
~Thành tích
~Achievement()