gpg::Người chơi

#include <player.h>

Cấu trúc dữ liệu cho phép bạn truy cập dữ liệu về một người chơi cụ thể.

Tóm tắt

Hàm khởi tạo và phá huỷ
Player()
Player(std::shared_ptr< const PlayerImpl > impl)
Tạo Trình phát từ shared_ptr thành PlayerImpl.
Player(const Player & copy_from)
Tạo bản sao của một Trình phát hiện có.
Player(Player && move_from)
Di chuyển Trình phát hiện có sang một trình phát mới.
~Player()

Hàm công khai
AvatarUrl(ImageResolution resolution) const
const std::string &
Trả về URL chứa hình đại diện của Trình phát này.
CurrentLevel() const
const PlayerLevel &
Truy xuất dữ liệu cấp độ hiện tại của người chơi này, nếu biết.
CurrentXP() const
uint64_t
Truy xuất tổng XP hiện tại của người chơi.
HasLevelInfo() const
bool
Trả về cho dù người chơi này có thông tin về cấp độ hay không.
Id() const
const std::string &
Trả về Id của người chơi hiện đang đăng nhập.
LastLevelUpTime() const
Truy xuất dấu thời gian khi người chơi này lên cấp gần đây nhất.
Name() const
const std::string &
Trả về tên trên Google+ của người chơi hiện đang đăng nhập.
NextLevel() const
const PlayerLevel &
Truy xuất dữ liệu cấp tiếp theo cho người chơi này, nếu biết.
Title() const
const std::string &
Truy xuất tên của trình phát.
Valid() const
bool
Trả về true khi trình phát 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 một trình phát không được điền sẵn do người dùng tạo hoặc cho một trình phát được điền sẵn kèm theo trạng thái phản hồi không thành công.
operator=(const Player & copy_from)
Player &
Chỉ định Trình phát này bằng cách sao chép từ một trình phát khác.
operator=(Player && move_from)
Player &
Chỉ định giá trị Player (Trình phát) này bằng cách di chuyển một giá trị khác vào.

Hàm công khai

AvatarUrl

const std::string & AvatarUrl(
  ImageResolution resolution
) const

Trả về URL chứa hình đại diện của Trình phát này.

Tham số ImageResolution chỉ định độ phân giải của hình ảnh. Player::Valid() phải trả về giá trị true thì hàm này mới có thể sử dụng được.

CurrentLevel

const PlayerLevel & CurrentLevel() const

Truy xuất dữ liệu cấp độ hiện tại của người chơi này, nếu biết.

Nếu HasLevelInfo() trả về false, thì thao tác này sẽ trả về một đối tượng PlayerLevel mà Valid() cũng trả về false.

CurrentXP

uint64_t CurrentXP() const

Truy xuất tổng XP hiện tại của người chơi.

Nếu HasLevelInfo() trả về giá trị false, thì hàm này sẽ trả về 0. Nếu HasLevelInfo() trả về true, tổng XP hiện tại của người chơi sẽ nằm trong khoảng CurrentLevel().MinimumXP đến CurrentLevel().MinimumXP.

HasLevelInfo

bool HasLevelInfo() const

Trả về cho dù người chơi này có thông tin về cấp độ hay không.

Nếu trả về false, CurrentLevel() và NextLevel() sẽ trả về các đối tượng PlayerLevel không hợp lệ.

Id

const std::string & Id() const

Trả về Id của người chơi hiện đang đăng nhập.

Player::Valid() phải trả về giá trị true thì hàm này mới có thể sử dụng được.

LastLevelUpTime

Timestamp LastLevelUpTime() const

Truy xuất dấu thời gian khi người chơi này lên cấp gần đây nhất.

Nếu HasLevelInfo() trả về false hoặc nếu người chơi chưa từng lên cấp, thì giá trị này sẽ trả về 0 (thời gian bắt đầu của hệ thống).

Tên

const std::string & Name() const

Trả về tên trên Google+ của người chơi hiện đang đăng nhập.

Player::Valid() phải trả về giá trị true thì hàm này mới có thể sử dụng được.

NextLevel

const PlayerLevel & NextLevel() const

Truy xuất dữ liệu cấp tiếp theo cho người chơi này, nếu biết.

Nếu HasLevelInfo() trả về false, thì thao tác này sẽ trả về một đối tượng PlayerLevel mà Valid() cũng trả về false. Đây là cấp độ mà người chơi đang cố gắng đạt được. Nếu người chơi đã ở cấp độ tối đa mà họ có thể đạt được, CurrentLevel() và NextLevel() sẽ trả về các giá trị giống hệt nhau.

Người chơi

 Player()

Người chơi

 Player(
  std::shared_ptr< const PlayerImpl > impl
)

Tạo Trình phát từ shared_ptr thành PlayerImpl.

Dành cho API sử dụng nội bộ.

Người chơi

 Player(
  const Player & copy_from
)

Tạo bản sao của một Trình phát hiện có.

Người chơi

 Player(
  Player && move_from
)

Di chuyển Trình phát hiện có sang một trình phát mới.

Tiêu đề

const std::string & Title() const

Truy xuất tên của trình phát.

Chỉ số này dựa trên những hành động mà người chơi đã thực hiện trên hệ sinh thái trò chơi của Google Play. Xin lưu ý rằng không phải người chơi nào cũng có danh hiệu và tên của người chơi có thể thay đổi theo thời gian. Nếu người chơi không có tiêu đề, Title() sẽ trả về một chuỗi trống.

Hợp lệ

bool Valid() const

Trả về true khi trình phát 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 một trình phát không được điền sẵn do người dùng tạo hoặc cho một trình phát được điền sẵn kèm theo trạng thái phản hồi không thành công.

Hàm này phải trả về giá trị true để các hàm getter trên đối tượng này có thể sử dụng được.

operator=

Player & operator=(
  const Player & copy_from
)

Chỉ định Trình phát này bằng cách sao chép từ một trình phát khác.

operator=

Player & operator=(
  Player && move_from
)

Chỉ định giá trị Player (Trình phát) này bằng cách di chuyển một giá trị khác vào.

~Trình phát

 ~Player()