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)
|
|
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ề giá trị false, thì hàm này sẽ trả về một đối tượng PlayerLevel trong đó 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ề 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ề giá trị 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ộ.
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()