gpg:: TurnBasedMatch
#include <turn_based_match.h>
Một cấu trúc dữ liệu chứa dữ liệu về trạng thái hiện tại của TurnBasedMatch
.
Tóm tắt
Hàm khởi tạo và phá huỷ |
|
---|---|
TurnBasedMatch()
|
|
TurnBasedMatch(std::shared_ptr< const TurnBasedMatchImpl > impl)
|
|
TurnBasedMatch(const TurnBasedMatch & copy_from)
Tạo bản sao của
TurnBasedMatch hiện có. |
|
TurnBasedMatch(TurnBasedMatch && move_from)
Di chuyển một
TurnBasedMatch hiện có. |
Hàm công khai |
|
---|---|
AutomatchingSlotsAvailable() const
|
uint32_t
Trả về số lượng vị trí tự động phù hợp sẵn có cho trận đấu.
|
CreatingParticipant() const
|
Trả về người tham gia đã tạo trận đấu này.
|
CreationTime() const
|
std::chrono::milliseconds
Trả về thời gian mà
TurnBasedMatch was created này (được biểu thị dưới dạng mili giây kể từ thời gian bắt đầu của hệ thống Unix). |
Data() const
|
const std::vector< uint8_t > &
Trả về dữ liệu trùng khớp nếu
HasData() là true. |
Description() const
|
const std::string &
Trả về bản tóm tắt do máy chủ tạo về trạng thái khớp.
|
HasData() const
|
bool
Đúng nếu đối tượng này có dữ liệu đã được thiết lập trong lần rẽ trước.
|
HasPreviousMatchData() const
|
bool
"True" nếu đây là lượt đầu tiên của kết quả so khớp lại và dữ liệu từ trạng thái Valid trước đó phải trả về true để hàm này có thể sử dụng được.
|
HasRematchId() const
|
bool
Trả về true nếu kết quả trùng khớp này được đối sánh lại.
|
Id() const
|
const std::string &
Trả về mã nhận dạng duy nhất của
TurnBasedMatch này. |
LastUpdateTime() const
|
Trả về thời gian cập nhật
TurnBasedMatch này 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). |
LastUpdatingParticipant() const
|
Trả về người tham gia đã cập nhật trận đấu này gần đây nhất.
|
Number() const
|
uint32_t
Số cho biết có bao nhiêu kết quả khớp trước kết quả khớp này thông qua kết quả so khớp lại.
|
ParticipantResults() const
|
const gpg::ParticipantResults &
Trả về kết quả phù hợp.
|
Participants() const
|
const std::vector< MultiplayerParticipant > &
Vectơ của tất cả người tham gia trong trận đấu này.
|
PendingParticipant() const
|
Trả về người tham gia mà đến lượt cập nhật trận đấu này.
|
PreviousMatchData() const
|
const std::vector< uint8_t > &
Dữ liệu từ kết quả trùng khớp trước, nếu HasPreviousMatchData().
|
RematchId() const
|
const std::string &
Trả về mã của kết quả trùng khớp là kết quả trùng khớp lại của kết quả trùng khớp này (nếu có).
|
Status() const
|
Trả về trạng thái của kết quả trùng khớp cho người tham gia tại địa phương.
|
SuggestedNextParticipant() const
|
Một chức năng trợ giúp chọn một người tham gia hợp lệ trong tập hợp những người tham gia đã tham gia, không thể tham gia và tự động so khớp.
|
Valid() const
|
bool
Trả về true nếu
TurnBasedMatch này được điền sẵn dữ liệu. |
Variant() const
|
uint32_t
Trả về giá trị nhận dạng biến thể của từng trò chơi mà trò chơi có thể dùng để xác định các chế độ chơi khác nhau.
|
Version() const
|
uint32_t
Mã nhận dạng tăng mạnh, được cập nhật mỗi khi sửa đổi kết quả trùng khớp.
|
operator=(const TurnBasedMatch & copy_from)
|
Chỉ định
TurnBasedMatch này bằng cách sao chép từ một mã khác. |
operator=(TurnBasedMatch && move_from)
|
Chỉ định
TurnBasedMatch này bằng cách di chuyển một mã khác vào đó. |
Hàm công khai
AutomatchingSlotsAvailable
uint32_t AutomatchingSlotsAvailable() const
Trả về số lượng vị trí tự động phù hợp sẵn có cho trận đấu.
Con số này bằng số khung giờ tự động so khớp mà trận đấu được tạo ra, trừ đi số người tham gia được thêm vào thông qua tính năng tự động so khớp. Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.
CreatingParticipant
MultiplayerParticipant CreatingParticipant() const
Trả về người tham gia đã tạo trận đấu này.
Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.
CreationTime
std::chrono::milliseconds CreationTime() const
Trả về thời gian mà TurnBasedMatch was created
này (được biểu thị dưới dạng mili giây kể từ thời gian bắt đầu của hệ thống Unix).
Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.
Dữ liệu
const std::vector< uint8_t > & Data() const
Mô tả
const std::string & Description() const
Trả về bản tóm tắt do máy chủ tạo về trạng thái khớp.
Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.
HasData
bool HasData() const
Đúng nếu đối tượng này có dữ liệu đã được thiết lập trong lần rẽ trước.
Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.
HasPreviousMatchData
bool HasPreviousMatchData() const
"True" nếu đây là lượt đầu tiên của kết quả so khớp lại và dữ liệu từ trạng thái Valid trước đó phải trả về true để hàm này có thể sử dụng được.
HasRematchId
bool HasRematchId() const
Trả về true nếu kết quả trùng khớp này được đối sánh lại.
Id
const std::string & Id() const
Trả về mã nhận dạng duy nhất của TurnBasedMatch
này.
Sử dụng với TurnBasedMultiplayerManager::FetchMatch
để truy xuất kết quả trùng khớp này sau. Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.
LastUpdateTime
Timestamp LastUpdateTime() const
Trả về thời gian cập nhật TurnBasedMatch
này 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).
Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.
LastUpdatingParticipant
MultiplayerParticipant LastUpdatingParticipant() const
Trả về người tham gia đã cập nhật trận đấu này gần đây nhất.
Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.
Số
uint32_t Number() const
Số cho biết số lượng kết quả phù hợp trước kết quả này thông qua kết quả so khớp lại.
Được đặt thành 1 trong kết quả trùng khớp đầu tiên và tăng thêm một giá trị trong mỗi lần so khớp lại.
ParticipantResults
const gpg::ParticipantResults & ParticipantResults() const
Trả về kết quả khớp.
Kết quả có thể được đặt thông qua TurnBasedMultiplayerManager::TakeMyTurn
, TurnBasedMultiplayerManager::FinishDuringMyTurn
và các hàm liên quan khác. Luôn sử dụng ParticipantResults().WithResult(...)
để tạo đối tượng ParticipantResults
mới nhất quán với mọi đối tượng hiện có. Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.
Người tham gia
const std::vector< MultiplayerParticipant > & Participants() const
Vectơ của tất cả người tham gia trong trận đấu này.
Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.
PendingParticipant
MultiplayerParticipant PendingParticipant() const
Trả về người tham gia mà đến lượt cập nhật trận đấu này.
Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.
PreviousMatchData
const std::vector< uint8_t > & PreviousMatchData() const
Dữ liệu từ kết quả trùng khớp trước, nếu HasPreviousMatchData().
Chỉ có thể được gọi nếu giá trị Valid trả về là true.
RematchId
const std::string & RematchId() const
Trả về mã của kết quả trùng khớp là kết quả trùng khớp lại của kết quả trùng khớp này (nếu có).
Trạng thái
MatchStatus Status() const
Trả về trạng thái của kết quả trùng khớp cho người tham gia tại địa phương.
Trạng thái xác định những hành động có thể được thực hiện đối với video trùng khớp. Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.
SuggestedNextParticipant
MultiplayerParticipant SuggestedNextParticipant() const
Một chức năng trợ giúp chọn một người tham gia hợp lệ trong tập hợp những người tham gia đã tham gia, không thể tham gia và tự động so khớp.
Nếu chức năng này luôn được dùng để chọn người tham gia tiếp theo, quá trình chơi sẽ diễn ra theo thứ tự tất cả những người tham gia và lặp lại nếu cần. Chỉ được gọi hàm này nếu Status() là MatchStatus::MY_TURN, vì đây là thời gian duy nhất mà kết quả của hàm này có thể được sử dụng một cách có ý nghĩa. Nếu được gọi không chính xác, hàm này sẽ trả về một người tham gia không hợp lệ (MultiplayerParticipant::Valid() == false
).
TurnBasedMatch
TurnBasedMatch()
TurnBasedMatch
TurnBasedMatch( std::shared_ptr< const TurnBasedMatchImpl > impl )
Tạo TurnBasedMatch
từ shared_ptr
thành TurnBasedMatchImpl
.
Dành cho API sử dụng nội bộ.
TurnBasedMatch
TurnBasedMatch( const TurnBasedMatch & copy_from )
Tạo bản sao của TurnBasedMatch
hiện có.
Hợp lệ
bool Valid() const
Trả về true nếu TurnBasedMatch
này được điền sẵn dữ liệu.
Phải trả về giá trị true để các hàm getter trên đối tượng TurnBasedMatch
(Id
, CreationTime
, v.v.) có thể sử dụng được.
Biến thể
uint32_t Variant() const
Trả về giá trị nhận dạng biến thể của từng trò chơi mà trò chơi có thể dùng để xác định các chế độ chơi khác nhau.
Giá trị Hợp lệ phải trả về true thì hàm này mới có thể sử dụng được.
Phiên bản
uint32_t Version() const
Mã nhận dạng tăng mạnh, được cập nhật mỗi khi sửa đổi kết quả trùng khớp.
operator=
TurnBasedMatch & operator=( const TurnBasedMatch & copy_from )
Chỉ định TurnBasedMatch
này bằng cách sao chép từ một mã khác.
operator=
TurnBasedMatch & operator=( TurnBasedMatch && move_from )
Chỉ định TurnBasedMatch
này bằng cách di chuyển một mã khác vào đó.