gpg::Người chơi

#include <player.h>

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

Tóm tắt

Hàm khởi tạo và hàm phá

Player()
Player(std::shared_ptr< const PlayerImpl > impl)
Xây dựng Trình phát từ shared_ptr đến 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 cho 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ề việc 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 đã đăng nhập.
LastLevelUpTime() const
Truy xuất dấu thời gian mà người chơi này lên cấp lần gần đây nhất.
Name() const
const std::string &
Trả về tên Google+ của người chơi hiện đã đă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 tiêu đề của trình phát.
Valid() const
bool
Trả về true khi trình phát đượ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 trình phát do người dùng tạo chưa có điền hoặc cho trình phát có điền sẵn đi kèm 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 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 để dùng hàm này.

CurrentLevel

const PlayerLevel & CurrentLevel() const 

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

Nếu HasLevelInfo() trả về false, thì kết quả sẽ trả về một đối tượng PlayerLevelValid() cũng trả về giá trị 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ề false, thì kết quả trả về sẽ là 0. Nếu HasLevelInfo() trả về true, tổng số XP hiện tại của người chơi sẽ nằm trong khoảng CurrentLevel().MinimumXP đến CurrentLevel().maximumXP.

HasLevelInfo

bool HasLevelInfo() const 

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

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

Mã nhận dạng

const std::string & Id() const 

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

Player::Valid() phải trả về giá trị true để dùng hàm này.

LastLevelUpTime

Timestamp LastLevelUpTime() const 

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

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

Tên

const std::string & Name() const 

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

Player::Valid() phải trả về giá trị true để dùng hàm này.

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ì kết quả sẽ trả về một đối tượng PlayerLevelValid() cũng trả về giá trị false. Đây là cấp độ mà người chơi hiện đang muốn đạt được. Nếu người chơi đã ở cấp độ tối đa mà họ có thể đạt tới, CurrentLevel()NextLevel() sẽ trả về các giá trị giống nhau.

Người chơi

 Player()

Người chơi

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

Xây dựng Trình phát từ shared_ptr đến 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 tiêu đề 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à danh hiệu của người chơi có thể thay đổi theo thời gian. Nếu người chơi chưa có tiêu đề, hàm Title() sẽ trả về một chuỗi trống.

Hợp lệ

bool Valid() const 

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

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

toán tử=

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.

toán tử=

Player & operator=(
  Player && move_from
)

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

~Người chơi

 ~Player()