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)
Tạo một Thành tích từ shared_ptr đến 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 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ộ.

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 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.

LastModified

Timestamp LastModified() const

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

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()