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)
|
|
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 PlayerLevel mà Valid() 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()
và 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 PlayerLevel mà Valid() 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() và 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ộ.
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()